مادة عرض

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

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

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

asset.call_asset.ad_schedule_targets

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

asset.call_asset.call_conversion_action

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

asset.call_asset.call_conversion_reporting_state

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

asset.call_asset.call_only

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

asset.call_asset.call_tracking_enabled

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

asset.call_asset.country_code

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

asset.call_asset.end_date

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

asset.call_asset.phone_number

وصف الحقلرقم هاتف المعلن الأولي. أمثلة: "1234567890"، "(123)456-7890"
الفئةATTRIBUTE
نوع البياناتSTRING
اكتب عنوان URLN/A
قابلة للفلترةصحيح
يمكن اختيارهاصحيح
Sortableصحيح
متكررخطأ

asset.call_asset.start_date

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

asset.call_asset.use_searcher_time_zone

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

asset.call_to_action_asset.call_to_action

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

asset.callout_asset.ad_schedule_targets

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

asset.callout_asset.callout_text

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

asset.callout_asset.end_date

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

asset.callout_asset.start_date

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

asset.callout_asset.use_searcher_time_zone

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

asset.creation_time

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

asset.engine_status

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

asset.final_urls

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

asset.id

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

asset.image_asset.file_size

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

asset.image_asset.full_size.height_pixels

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

asset.image_asset.full_size.url

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

asset.image_asset.full_size.width_pixels

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

asset.image_asset.mime_type

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

asset.last_modified_time

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

asset.location_asset.business_profile_locations

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

asset.location_asset.location_ownership_type

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

asset.location_asset.place_id

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

asset.mobile_app_asset.app_id

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

asset.mobile_app_asset.app_store

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

asset.name

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

asset.page_feed_asset.labels

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

asset.page_feed_asset.page_url

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

asset.resource_name

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

asset.status

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

asset.text_asset.text

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

asset.tracking_url_template

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

asset.type

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

asset.youtube_video_asset.youtube_video_id

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

asset.youtube_video_asset.youtube_video_title

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