مادة عرض

مادة العرض هي جزء من إعلان يمكن مشاركته في عدّة إعلانات. يمكن أن تكون مادة العرض صورة (ImageAsset) أو فيديو (YoutubeVideoAsset) أو غير ذلك. مواد العرض غير قابلة للتغيير ولا يمكن إزالتها. لإيقاف عرض مادة عرض، عليك إزالتها من العنصر الذي يستخدمها.

المراجع المنسوبة
العميل

يمكن اختيار الحقول من المراجع أعلاه مع هذا المرجع في عبارتَي SELECT وWHERE. لن تؤدي هذه الحقول إلى تقسيم المقاييس في عبارة SELECT.

asset.call_asset.ad_schedule_targets

وصف الحقلقائمة بالجداول الزمنية غير المتداخلة التي تحدّد جميع الفواصل الزمنية التي يمكن أن يتم عرض مادة العرض خلالها. يمكن أن يكون هناك 6 جداول كحدّ أقصى في اليوم، أي 42 جدولاً إجمالاً.
الفئةATTRIBUTE
نوع البياناتMESSAGE
كتابة عنوان URLgoogle.ads.searchads360.v0.common.AdScheduleInfo
قابل للفلترةخطأ
يمكن اختيارهTrue
Sortableخطأ
متكرّرTrue

asset.call_asset.call_conversion_action

وصف الحقلإجراء الإحالة الناجحة الذي سيتمّ تحديد مصدر إحالة ناجحة عبر الاتّصال الهاتفي إليه. في حال عدم ضبط هذه القيمة، يتم استخدام إجراء الإحالة الناجحة التلقائي. لا يكون لهذا الحقل أي تأثير إلا إذا تم ضبط call_conversion_reporting_state على USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
الفئةATTRIBUTE
نوع البياناتRESOURCE_NAME
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.call_asset.call_conversion_reporting_state

وصف الحقلتوضّح هذه السمة ما إذا كان يجب أن تستخدم CallAsset إعداد الإحالة الناجحة للمكالمات الخاص بها، أو تتّبع الإعداد على مستوى الحساب، أو توقف ميزة الإحالة الناجحة للمكالمات.
الفئةATTRIBUTE
نوع البيانات
كتابة عنوان URLgoogle.ads.searchads360.v0.enums.CallConversionReportingStateEnum.CallConversionReportingState
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.call_asset.call_only

وصف الحقلما إذا كان الإعلان عن الاتصال فقط يعرض رقم الهاتف بدون رابط إلى الموقع الإلكتروني تنطبق هذه المقالة على Microsoft Ads.
الفئةATTRIBUTE
نوع البياناتBOOLEAN
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.call_asset.call_tracking_enabled

وصف الحقلتحديد ما إذا كان يجب تفعيل المكالمة في ميزة تتبُّع المكالمات تنطبق هذه المقالة على Microsoft Ads.
الفئةATTRIBUTE
نوع البياناتBOOLEAN
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.call_asset.country_code

وصف الحقلرمز البلد المكوَّن من حرفين لرقم الهاتف أمثلة: "US" أو "us".
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.call_asset.end_date

وصف الحقلآخر تاريخ يكون فيه هذا الأصل ساريًا ويستمر في العرض، بالتنسيق yyyy-MM-dd.
الفئةATTRIBUTE
نوع البياناتDATE
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.call_asset.phone_number

وصف الحقلرقم هاتف المعلِن الأولي أمثلة: ‎'1234567890' أو ‎'(123)456-7890'
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.call_asset.start_date

وصف الحقلتمثّل هذه السمة تاريخ بدء عرض هذا الأصل، بالتنسيق yyyy-MM-dd.
الفئةATTRIBUTE
نوع البياناتDATE
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.call_asset.use_searcher_time_zone

وصف الحقلتحديد ما إذا كان سيتم عرض إضافة المكالمة في المنطقة الزمنية لمستخدم البحث تنطبق هذه المقالة على Microsoft Ads.
الفئةATTRIBUTE
نوع البياناتBOOLEAN
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.call_to_action_asset.call_to_action

وصف الحقلعبارة تحثّ المستخدم على اتّخاذ إجراء
الفئةATTRIBUTE
نوع البيانات
كتابة عنوان URLgoogle.ads.searchads360.v0.enums.CallToActionTypeEnum.CallToActionType
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.callout_asset.ad_schedule_targets

وصف الحقلقائمة بالجداول الزمنية غير المتداخلة التي تحدّد جميع الفواصل الزمنية التي يمكن أن يتم عرض مادة العرض خلالها. يمكن أن يكون هناك 6 جداول كحدّ أقصى في اليوم، أي 42 جدولاً إجمالاً.
الفئةATTRIBUTE
نوع البياناتMESSAGE
كتابة عنوان URLgoogle.ads.searchads360.v0.common.AdScheduleInfo
قابل للفلترةخطأ
يمكن اختيارهTrue
Sortableخطأ
متكرّرTrue

asset.callout_asset.callout_text

وصف الحقلنص وسيلة الشرح يجب أن يتراوح طول هذه السلسلة بين 1 و25 حرفًا، بما في ذلك القيمتان.
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.callout_asset.end_date

وصف الحقلآخر تاريخ يكون فيه هذا الأصل ساريًا ويستمر في العرض، بالتنسيق yyyy-MM-dd.
الفئةATTRIBUTE
نوع البياناتDATE
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.callout_asset.start_date

وصف الحقلتمثّل هذه السمة تاريخ بدء عرض هذا الأصل، بالتنسيق yyyy-MM-dd.
الفئةATTRIBUTE
نوع البياناتDATE
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.callout_asset.use_searcher_time_zone

وصف الحقلتحديد ما إذا كان سيتم عرض مادة العرض في المنطقة الزمنية لمستخدم البحث تنطبق هذه المقالة على Microsoft Ads.
الفئةATTRIBUTE
نوع البياناتBOOLEAN
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.creation_time

وصف الحقلالطابع الزمني لوقت إنشاء مادة العرض هذه يكون الطابع الزمني في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss".
الفئةATTRIBUTE
نوع البياناتDATE
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.engine_status

وصف الحقلتمثّل هذه السمة حالة المحرك لمادة عرض.
الفئةATTRIBUTE
نوع البيانات
كتابة عنوان URLgoogle.ads.searchads360.v0.enums.AssetEngineStatusEnum.AssetEngineStatus
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.final_mobile_urls

وصف الحقلقائمة بعناوين URL النهائية المحتملة للأجهزة الجوّالة بعد جميع عمليات إعادة التوجيه على مستوى النطاقات
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
Sortableخطأ
متكرّرTrue

asset.final_url_suffix

وصف الحقلنموذج عنوان URL لإلحاق المَعلمات بعناوين URL للصفحات المقصودة التي يتم عرضها باستخدام ميزة التتبُّع الموازي
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.final_urls

وصف الحقلقائمة بعناوين URL النهائية المحتملة بعد كل عمليات إعادة التوجيه عبر النطاقات
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
Sortableخطأ
متكرّرTrue

asset.id

وصف الحقلرقم تعريف مادة العرض
الفئةATTRIBUTE
نوع البياناتINT64
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.image_asset.file_size

وصف الحقلحجم ملف مادة عرض الصورة بالبايت.
الفئةATTRIBUTE
نوع البياناتINT64
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.image_asset.full_size.height_pixels

وصف الحقلارتفاع الصورة
الفئةATTRIBUTE
نوع البياناتINT64
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.image_asset.full_size.url

وصف الحقلعنوان URL يعرض الصورة بهذا الارتفاع والعرض
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.image_asset.full_size.width_pixels

وصف الحقلعرض الصورة
الفئةATTRIBUTE
نوع البياناتINT64
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.image_asset.mime_type

وصف الحقلنوع MIME لمادة عرض الصورة.
الفئةATTRIBUTE
نوع البيانات
كتابة عنوان URLgoogle.ads.searchads360.v0.enums.MimeTypeEnum.MimeType
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.last_modified_time

وصف الحقلتاريخ ووقت آخر تعديل على مادة العرض هذه. يكون التاريخ والوقت في المنطقة الزمنية للعميل وبالتنسيق "yyyy-MM-dd HH:mm:ss.ssssss".
الفئةATTRIBUTE
نوع البياناتDATE
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.location_asset.business_profile_locations

وصف الحقلقائمة المواقع الجغرافية للنشاط التجاري الخاصة بالعميل لن يتم عرض هذه السمة إلا إذا كانت "مادة عرض الموقع الجغرافي" تتم مزامنتها من حساب "الملف التجاري". من الممكن أن تتضمّن القائمة نفسها عدة إدخالات في "الملف التجاري على Google" ضمن الحساب نفسه وتشير إلى معرّف المكان نفسه.
الفئةATTRIBUTE
نوع البياناتMESSAGE
كتابة عنوان URLgoogle.ads.searchads360.v0.common.BusinessProfileLocation
قابل للفلترةخطأ
يمكن اختيارهTrue
Sortableخطأ
متكرّرTrue

asset.location_asset.location_ownership_type

وصف الحقلنوع ملكية الموقع الجغرافي إذا كان النوع BUSINESS_OWNER، سيتم عرضه كإضافة موقع جغرافي. إذا كان النوع AFFILIATE، سيتم عرضه كموقع جغرافي تابع.
الفئةATTRIBUTE
نوع البيانات
كتابة عنوان URLgoogle.ads.searchads360.v0.enums.LocationOwnershipTypeEnum.LocationOwnershipType
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.location_asset.place_id

وصف الحقلتحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". هذا الحقل فريد لمعرّف عميل ونوع مادة عرض معيّنَين. يمكنك الانتقال إلى https://developers.google.com/places/web-service/place-id لمعرفة المزيد عن معرّف المكان.
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.mobile_app_asset.app_id

وصف الحقلالحقل مطلوب. سلسلة تحدّد تطبيقًا على الأجهزة الجوّالة بشكلٍ فريد. يجب أن يحتوي فقط على المعرّف الأصلي للنظام الأساسي، مثل "com.android.ebay" لنظام التشغيل Android أو "12345689" لنظام التشغيل iOS.
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.mobile_app_asset.app_store

وصف الحقلالحقل مطلوب. متجر التطبيقات الذي يوزّع هذا التطبيق تحديدًا
الفئةATTRIBUTE
نوع البيانات
كتابة عنوان URLgoogle.ads.searchads360.v0.enums.MobileAppVendorEnum.MobileAppVendor
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.name

وصف الحقلالاسم الاختياري لمادة العرض.
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.page_feed_asset.labels

وصف الحقلالتصنيفات المستخدَمة لتجميع عناوين URL الخاصة بالصفحات
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
Sortableخطأ
متكرّرTrue

asset.page_feed_asset.page_url

وصف الحقلصفحة الويب التي يريد المعلِنون استهدافها
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.resource_name

وصف الحقلاسم مصدر مادة العرض. تتّخذ أسماء موارد مواد العرض الشكل التالي: customers/{customer_id}/assets/{asset_id}
الفئةATTRIBUTE
نوع البياناتRESOURCE_NAME
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
Sortableخطأ
متكرّرخطأ
وصف الحقلقائمة بالجداول الزمنية غير المتداخلة التي تحدّد جميع الفواصل الزمنية التي يمكن أن يتم عرض مادة العرض خلالها. يمكن أن يكون هناك 6 جداول كحدّ أقصى في اليوم، أي 42 جدولاً إجمالاً.
الفئةATTRIBUTE
نوع البياناتMESSAGE
كتابة عنوان URLgoogle.ads.searchads360.v0.common.AdScheduleInfo
قابل للفلترةخطأ
يمكن اختيارهTrue
Sortableخطأ
متكرّرTrue
وصف الحقلالسطر الأول من وصف رابط أقسام الموقع. في حال ضبط هذه السمة، يجب أن يتراوح طولها بين 1 و35 حرفًا، ويجب ضبط السمة description2 أيضًا.
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ
وصف الحقلالسطر الثاني من وصف رابط أقسام الموقع. في حال ضبط هذه السمة، يجب أن يتراوح طولها بين 1 و35 حرفًا، ويجب ضبط السمة description1 أيضًا.
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ
وصف الحقلآخر تاريخ يكون فيه هذا الأصل ساريًا ويستمر في العرض، بالتنسيق yyyy-MM-dd.
الفئةATTRIBUTE
نوع البياناتDATE
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ
وصف الحقلنص عرض عنوان URL لرابط أقسام الموقع يجب أن يتراوح طول هذه السلسلة بين 1 و25 حرفًا، بما في ذلك القيمتان.
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ
وصف الحقلما إذا كان الإعداد المفضّل هو عرض مادة عرض رابط أقسام الموقع على الأجهزة الجوّالة. تنطبق هذه المقالة على Microsoft Ads.
الفئةATTRIBUTE
نوع البياناتBOOLEAN
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ
وصف الحقلتمثّل هذه السمة تاريخ بدء عرض هذا الأصل، بالتنسيق yyyy-MM-dd.
الفئةATTRIBUTE
نوع البياناتDATE
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ
وصف الحقلالمعرّف المستخدَم لتتبُّع النقرات على مادة عرض رابط أقسام الموقع. هذا حساب Yahoo! حقل خاص باليابان فقط
الفئةATTRIBUTE
نوع البياناتINT64
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ
وصف الحقلتحديد ما إذا كان سيتم عرض مادة عرض رابط أقسام الموقع في المنطقة الزمنية لمستخدم البحث تنطبق هذه المقالة على Microsoft Ads.
الفئةATTRIBUTE
نوع البياناتBOOLEAN
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.status

وصف الحقلتمثّل هذه السمة حالة مادة العرض.
الفئةATTRIBUTE
نوع البيانات
كتابة عنوان URLgoogle.ads.searchads360.v0.enums.AssetStatusEnum.AssetStatus
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.text_asset.text

وصف الحقلالمحتوى النصي لمادة العرض النصية
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.tracking_url_template

وصف الحقلنموذج عنوان URL لإنشاء عنوان URL للتتبّع
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.type

وصف الحقلنوع مادة العرض
الفئةATTRIBUTE
نوع البيانات
كتابة عنوان URLgoogle.ads.searchads360.v0.enums.AssetTypeEnum.AssetType
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.url_custom_parameters

وصف الحقلقائمة بعمليات الربط التي سيتم استخدامها لاستبدال علامات معلَمات عناوين URL المخصّصة في tracking_url_template وfinal_urls و/أو final_mobile_urls.
الفئةATTRIBUTE
نوع البياناتMESSAGE
كتابة عنوان URLgoogle.ads.searchads360.v0.common.CustomParameter
قابل للفلترةخطأ
يمكن اختيارهTrue
Sortableخطأ
متكرّرTrue

asset.youtube_video_asset.youtube_video_id

وصف الحقلمعرّف الفيديو على YouTube هذه هي قيمة السلسلة المكوّنة من 11 حرفًا والمستخدَمة في عنوان URL الخاص بالفيديو على YouTube.
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ

asset.youtube_video_asset.youtube_video_title

وصف الحقلتمثّل هذه السمة عنوان الفيديو على YouTube.
الفئةATTRIBUTE
نوع البياناتSTRING
كتابة عنوان URLN/A
قابل للفلترةTrue
يمكن اختيارهTrue
SortableTrue
متكرّرخطأ