مادة عرض

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

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

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

asset.call_asset.ad_schedule_targets وصف الحقل قائمة بجداول زمنية غير متداخلة تحدّد جميع الفترات الزمنية التي قد تظهر فيها مادة العرض. يمكن إنشاء 6 جداول زمنية كحدّ أقصى في اليوم، وإجمالي 42 جدولاً. الفئة ATTRIBUTE نوع البيانات MESSAGE اكتب عنوان URL google.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 اكتب عنوان URL N/A قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

asset.call_asset.call_conversion_reporting_state وصف الحقل يشير إلى ما إذا كان يجب على CallAsset هذا استخدام إعداد "الإحالات الناجحة عبر الاتصال الهاتفي" الخاص به أو اتّباع الإعداد على مستوى الحساب أو إيقاف الإحالة الناجحة عبر الاتصال الهاتفي. الفئة ATTRIBUTE نوع البيانات ENUM DISABLED UNKNOWN UNSPECIFIED USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION اكتب عنوان URL google.ads.searchads360.v0.enums.CallConversionReportingStateEnum.CallConversionReportingState قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

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

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

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

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

asset.call_asset.phone_number وصف الحقل رقم هاتف المعلن الأولي. أمثلة: "1234567890"، "[phone]" الفئة ATTRIBUTE نوع البيانات STRING اكتب عنوان URL N/A قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

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

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

asset.call_to_action_asset.call_to_action وصف الحقل عبارة الحث على اتخاذ إجراء. الفئة ATTRIBUTE نوع البيانات ENUM APPLY_NOW BOOK_NOW BUY_NOW CONTACT_US DONATE_NOW DOWNLOAD GET_QUOTE LEARN_MORE ORDER_NOW PLAY_NOW SEE_MORE SHOP_NOW SIGN_UP START_NOW SUBSCRIBE UNKNOWN UNSPECIFIED VISIT_SITE WATCH_NOW اكتب عنوان URL google.ads.searchads360.v0.enums.CallToActionTypeEnum.CallToActionType قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

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

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

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

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

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

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

asset.engine_status وصف الحقل حالة المحرّك لمادة عرض الفئة ATTRIBUTE نوع البيانات ENUM DISABLED DISAPPROVED REMOVED SERVING SERVING_LIMITED UNKNOWN UNSPECIFIED اكتب عنوان URL google.ads.searchads360.v0.enums.AssetEngineStatusEnum.AssetEngineStatus قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

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

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

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

asset.image_asset.full_size.height_pixels وصف الحقل ارتفاع الصورة. الفئة ATTRIBUTE نوع البيانات INT64 اكتب عنوان URL N/A قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

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

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

asset.image_asset.mime_type وصف الحقل نوع MIME لمادة عرض الصورة. الفئة ATTRIBUTE نوع البيانات ENUM AUDIO_MP3 AUDIO_WAV FLASH HTML5_AD_ZIP IMAGE_GIF IMAGE_JPEG IMAGE_PNG MSEXCEL MSWORD PDF RTF TEXT_HTML UNKNOWN UNSPECIFIED اكتب عنوان URL google.ads.searchads360.v0.enums.MimeTypeEnum.MimeType قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

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

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

asset.location_asset.location_ownership_type وصف الحقل نوع ملكية الموقع الجغرافي. إذا كان النوع BUSINESS_OWNER، فسيتم عرضه كإضافة موقع. إذا كان النوع "شريك تابع"، سيتم عرضه كموقع جغرافي للشركاء التابعين. الفئة ATTRIBUTE نوع البيانات ENUM AFFILIATE BUSINESS_OWNER UNKNOWN UNSPECIFIED اكتب عنوان URL google.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 اكتب عنوان URL N/A قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

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

asset.mobile_app_asset.app_store وصف الحقل مطلوبة. متجر التطبيقات الذي يوزّع هذا التطبيق المحدّد. الفئة ATTRIBUTE نوع البيانات ENUM APPLE_APP_STORE GOOGLE_APP_STORE UNKNOWN UNSPECIFIED اكتب عنوان URL google.ads.searchads360.v0.enums.MobileAppVendorEnum.MobileAppVendor قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

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

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

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

asset.resource_name وصف الحقل اسم المورد لمادة العرض وتكون أسماء موارد مواد العرض على النحو التالي: customers/{customer_id}/assets/{asset_id} الفئة ATTRIBUTE نوع البيانات RESOURCE_NAME اكتب عنوان URL N/A قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable خطأ متكرر خطأ

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

asset.sitelink_asset.description1 وصف الحقل السطر الأول من وصف رابط أقسام الموقع. في حال ضبط هذه السياسة، يجب أن تكون القيمة بين 1 و35، بشكل شامل، ويجب أيضًا ضبط الوصف2. الفئة ATTRIBUTE نوع البيانات STRING اكتب عنوان URL N/A قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

asset.sitelink_asset.description2 وصف الحقل السطر الثاني من وصف رابط أقسام الموقع. في حال ضبط هذه السياسة، يجب أن يكون الطول ما بين 1 و35، ويجب أيضًا ضبط الوصف 1. الفئة ATTRIBUTE نوع البيانات STRING اكتب عنوان URL N/A قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

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

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

asset.sitelink_asset.mobile_preferred وصف الحقل ما إذا كان الخيار المفضّل هو ظهور مادة عرض رابط أقسام الموقع على الأجهزة الجوّالة. ينطبق ذلك على Microsoft Ads. الفئة ATTRIBUTE نوع البيانات BOOLEAN اكتب عنوان URL N/A قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

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

asset.sitelink_asset.tracking_id وصف الحقل رقم التعريف المستخدَم لتتبُّع النقرات على مادة عرض رابط أقسام الموقع هذا حساب Yahoo! حقل اليابان فقط. الفئة ATTRIBUTE نوع البيانات INT64 اكتب عنوان URL N/A قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

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

asset.status وصف الحقل حالة مادة العرض الفئة ATTRIBUTE نوع البيانات ENUM ARCHIVED ENABLED PENDING_SYSTEM_GENERATED REMOVED UNKNOWN UNSPECIFIED اكتب عنوان URL google.ads.searchads360.v0.enums.AssetStatusEnum.AssetStatus قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

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

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

asset.type وصف الحقل نوع مادة العرض الفئة ATTRIBUTE نوع البيانات ENUM BOOK_ON_GOOGLE CALL CALLOUT CALL_TO_ACTION DISCOVERY_CAROUSEL_CARD DYNAMIC_CUSTOM DYNAMIC_EDUCATION DYNAMIC_FLIGHTS DYNAMIC_HOTELS_AND_RENTALS DYNAMIC_JOBS DYNAMIC_LOCAL DYNAMIC_REAL_ESTATE DYNAMIC_TRAVEL HOTEL_CALLOUT HOTEL_PROPERTY IMAGE LEAD_FORM LOCATION MEDIA_BUNDLE MOBILE_APP PAGE_FEED PRICE PROMOTION SITELINK STRUCTURED_SNIPPET TEXT UNKNOWN UNSPECIFIED YOUTUBE_VIDEO اكتب عنوان URL google.ads.searchads360.v0.enums.AssetTypeEnum.AssetType قابلة للفلترة صحيح يمكن اختيارها صحيح Sortable صحيح متكرر خطأ

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

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