Ad

إعلان

تمثيل JSON 
{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "finalAppUrls": [
    {
      object (FinalAppUrl)
    }
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "type": enum (AdType),
  "devicePreference": enum (Device),
  "urlCollections": [
    {
      object (UrlCollection)
    }
  ],
  "systemManagedResourceSource": enum (SystemManagedResourceSource),
  "id": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "displayUrl": string,
  "addedByGoogleAds": boolean,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (TextAdInfo)
  },
  "expandedTextAd": {
    object (ExpandedTextAdInfo)
  },
  "callAd": {
    object (CallAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (ExpandedDynamicSearchAdInfo)
  },
  "hotelAd": {
    object (HotelAdInfo)
  },
  "shoppingSmartAd": {
    object (ShoppingSmartAdInfo)
  },
  "shoppingProductAd": {
    object (ShoppingProductAdInfo)
  },
  "imageAd": {
    object (ImageAdInfo)
  },
  "videoAd": {
    object (VideoAdInfo)
  },
  "videoResponsiveAd": {
    object (VideoResponsiveAdInfo)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdInfo)
  },
  "legacyResponsiveDisplayAd": {
    object (LegacyResponsiveDisplayAdInfo)
  },
  "appAd": {
    object (AppAdInfo)
  },
  "legacyAppInstallAd": {
    object (LegacyAppInstallAdInfo)
  },
  "responsiveDisplayAd": {
    object (ResponsiveDisplayAdInfo)
  },
  "localAd": {
    object (LocalAdInfo)
  },
  "displayUploadAd": {
    object (DisplayUploadAdInfo)
  },
  "appEngagementAd": {
    object (AppEngagementAdInfo)
  },
  "shoppingComparisonListingAd": {
    object (ShoppingComparisonListingAdInfo)
  },
  "smartCampaignAd": {
    object (SmartCampaignAdInfo)
  },
  "appPreRegistrationAd": {
    object (AppPreRegistrationAdInfo)
  },
  "demandGenMultiAssetAd": {
    object (DemandGenMultiAssetAdInfo)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAdInfo)
  },
  "demandGenVideoResponsiveAd": {
    object (DemandGenVideoResponsiveAdInfo)
  },
  "demandGenProductAd": {
    object (DemandGenProductAdInfo)
  },
  "travelAd": {
    object (TravelAdInfo)
  }
  // End of list of possible types for union field ad_data.
}
الحقول
resourceName

string

غير قابل للتغيير اسم مورد الإعلان. تكون أسماء موارد الإعلانات على النحو التالي:

customers/{customerId}/ads/{ad_id}
finalUrls[]

string

قائمة عناوين URL النهائية المحتمَلة بعد كل عمليات إعادة التوجيه عبر النطاقات للإعلان
finalAppUrls[]

object (FinalAppUrl)

قائمة بعناوين URL النهائية للتطبيق التي سيتم استخدامها على الأجهزة الجوّالة إذا كان المستخدم قد ثبَّت التطبيق المحدّد
finalMobileUrls[]

string

قائمة عناوين URL النهائية المحتملة للأجهزة الجوّالة بعد كل عمليات إعادة التوجيه على مستوى النطاقات للإعلان
urlCustomParameters[]

object (CustomParameter)

قائمة عمليات الربط التي يمكن استخدامها لاستبدال علامات المَعلمات المخصّصة في trackingUrlTemplate أو finalUrls أو mobile_final_urls بالنسبة إلى عمليات التحويل، استخدِم عمليات المَعلمة المخصّصة لعنوان URL.
type

enum (AdType)

النتائج فقط. نوع الإعلان.
devicePreference

enum (Device)

إعدادات الجهاز المفضّلة للإعلان. يمكنك تحديد إعداد مفضّل للأجهزة الجوّالة فقط. عند ضبط هذا الخيار، سيتمّ منح الأولوية للإعلان على الإعلانات الأخرى عند عرضه على جهاز جوّال. وسيظلّ بإمكانه عرض الإعلان على أنواع أجهزة أخرى، مثلاً إذا لم تكن هناك إعلانات أخرى متاحة. إذا لم يتم تحديده (بدون إعدادات الجهاز المفضّلة)، يتم استهداف جميع الأجهزة. لا تتوفّر هذه الميزة إلا لبعض أنواع الإعلانات.
urlCollections[]

object (UrlCollection)

عناوين URL إضافية للإعلان تم وضع علامة عليها بمعرّف فريد يمكن الإشارة إليه من حقول أخرى في الإعلان.
systemManagedResourceSource

enum (SystemManagedResourceSource)

النتائج فقط. إذا كان هذا الإعلان مُدارًا من النظام، سيشير هذا الحقل إلى المصدر. هذا الحقل للقراءة فقط.
id

string (int64 format)

النتائج فقط. رقم تعريف الإعلان.
trackingUrlTemplate

string

نموذج عنوان URL لإنشاء عنوان URL للتتبّع
finalUrlSuffix

string

اللاحقة التي سيتم استخدامها عند إنشاء عنوان URL نهائي
displayUrl

string

عنوان URL الذي يظهر في وصف الإعلان لبعض أشكال الإعلانات.
addedByGoogleAds

boolean

النتائج فقط. يشير إلى ما إذا كانت "إعلانات Google" قد أضافت هذا الإعلان تلقائيًا وليس المستخدِم. على سبيل المثال، قد يحدث ذلك عند إنشاء الإعلانات تلقائيًا كاقتراحات لإعلانات جديدة استنادًا إلى معرفة مستوى أداء الإعلانات الحالية.
name

string

غير قابل للتغيير اسم الإعلان. لا يُستخدَم هذا الإجراء إلّا للتعرّف على الإعلان. ولا يلزم أن يكون فريدًا ولا يؤثّر في الإعلان المعروض. لا يتوفّر حقل الاسم حاليًا إلا لأنواع الإعلانات DisplayUploadAd وImageAd وShoppingComparisonListingAd وVideoAd.
حقل الربط ad_data تفاصيل ذات صلة بنوع الإعلان يجب ضبط قيمة واحدة بالضبط. يمكن أن يكون ad_data واحدًا فقط مما يلي:
textAd

object (TextAdInfo)

غير قابل للتغيير تفاصيل تتعلّق بإعلان نصي
expandedTextAd

object (ExpandedTextAdInfo)

تفاصيل تتعلّق بإعلان نصي موسّع
callAd

object (CallAdInfo)

تفاصيل تتعلّق بإعلان للاتصال
expandedDynamicSearchAd

object (ExpandedDynamicSearchAdInfo)

غير قابل للتغيير تفاصيل تتعلّق بإعلان ديناميكي موسّع على شبكة البحث يتمّ إنشاء عنوان هذا النوع من الإعلانات وعناوين URL النهائية وعنوان URL المعروض تلقائيًا في وقت العرض وفقًا للمعلومات المتعلّقة باسم النطاق المقدّمة من dynamicSearchAdsSetting المرتبطة على مستوى الحملة.
hotelAd

object (HotelAdInfo)

تفاصيل تتعلّق بإعلان فندق
shoppingSmartAd

object (ShoppingSmartAdInfo)

تفاصيل تتعلّق بإعلان Shopping ذكي
shoppingProductAd

object (ShoppingProductAdInfo)

تفاصيل تتعلّق بإعلان منتج في Shopping
imageAd

object (ImageAdInfo)

غير قابل للتغيير تفاصيل تتعلّق بإعلان مصوّر
videoAd

object (VideoAdInfo)

تفاصيل تتعلّق بإعلان فيديو
videoResponsiveAd

object (VideoResponsiveAdInfo)

تفاصيل تتعلّق بإعلان فيديو متجاوب
responsiveSearchAd

object (ResponsiveSearchAdInfo)

تفاصيل تتعلّق بإعلان متجاوب على شبكة البحث
legacyResponsiveDisplayAd

object (LegacyResponsiveDisplayAdInfo)

تفاصيل تتعلّق بإعلان صوري متجاوب قديم
appAd

object (AppAdInfo)

تفاصيل تتعلّق بإعلان تطبيق
legacyAppInstallAd

object (LegacyAppInstallAdInfo)

غير قابل للتغيير تفاصيل تتعلّق بإعلان قديم لجذب عمليات تثبيت التطبيق
responsiveDisplayAd

object (ResponsiveDisplayAdInfo)

تفاصيل تتعلّق بالإعلان الصوري المتجاوب
localAd

object (LocalAdInfo)

تفاصيل تتعلّق بإعلان محلي
displayUploadAd

object (DisplayUploadAdInfo)

تفاصيل تتعلّق بإعلان صوري تمّ تحميله
appEngagementAd

object (AppEngagementAdInfo)

تفاصيل تتعلّق بإعلان جذب المستخدمين إلى التطبيق
shoppingComparisonListingAd

object (ShoppingComparisonListingAdInfo)

تفاصيل تتعلّق بإعلان المقارنة في Shopping
smartCampaignAd

object (SmartCampaignAdInfo)

تفاصيل تتعلّق بإعلان "حملة ذكية"
appPreRegistrationAd

object (AppPreRegistrationAdInfo)

تفاصيل تتعلّق بإعلان التسجيل المُسبَق للتطبيق
demandGenMultiAssetAd

object (DemandGenMultiAssetAdInfo)

تفاصيل تتعلّق بإعلان يتضمّن عدّة مواد عرض لزيادة الطلب
demandGenVideoResponsiveAd

object (DemandGenVideoResponsiveAdInfo)

تفاصيل تتعلّق بإعلان فيديو متجاوب لزيادة الطلب
demandGenProductAd

object (DemandGenProductAdInfo)

تفاصيل تتعلّق بإعلان منتجات لزيادة الطلب
travelAd

object (TravelAdInfo)

تفاصيل تتعلّق بإعلان سفر

FinalAppUrl

عنوان URL لإنشاء رابط لصفحة معيّنة في تطبيق لنظام التشغيل المحدّد

تمثيل JSON 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
الحقول
osType

enum (AppUrlOperatingSystemType)

نظام التشغيل المستهدَف من عنوان URL هذا مطلوب.
url

string

عنوان URL لرابط صفحة في التطبيق تحدّد الروابط لصفحات في التطبيق موقعًا في التطبيق يتوافق مع المحتوى الذي تريد عرضه، ويجب أن تكون على الشكل {scheme}://{host_path}، ويحدّد المخطط التطبيق الذي سيتم فتحه. بالنسبة إلى تطبيقك، يمكنك استخدام مخطّط مخصّص يبدأ باسم التطبيق. يحدّد المضيف والمسار الموقع الفريد في التطبيق الذي يتوفّر فيه المحتوى. مثال: "exampleapp://productid_1234". مطلوب.

AppUrlOperatingSystemType

نظام التشغيل

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
IOS نظام التشغيل Apple IOS
ANDROID نظام التشغيل Android

AdType

الأنواع المحتمَلة للإعلان

عمليات التعداد
UNSPECIFIED لم يتم تحديد أي قيمة.
UNKNOWN

القيمة المستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للردّ فقط.
TEXT_AD أن يكون الإعلان نصيًا
EXPANDED_TEXT_AD أن يكون الإعلان إعلانًا نصيًا موسّعًا
EXPANDED_DYNAMIC_SEARCH_AD الإعلان هو إعلان ديناميكي موسّع على شبكة البحث.
HOTEL_AD الإعلان هو إعلان فندق.
SHOPPING_SMART_AD أن يكون الإعلان إعلان Shopping ذكيًا
SHOPPING_PRODUCT_AD أن يكون الإعلان إعلان Shopping عاديًا
VIDEO_AD أن يكون الإعلان عبارة عن إعلان فيديو
IMAGE_AD هذا الإعلان هو إعلان مصوّر.
RESPONSIVE_SEARCH_AD الإعلان هو إعلان متجاوب على شبكة البحث.
LEGACY_RESPONSIVE_DISPLAY_AD الإعلان هو إعلان صوري متجاوب قديم.
APP_AD الإعلان هو إعلان تطبيق.
LEGACY_APP_INSTALL_AD إذا كان الإعلان من النوع القديم لإعلانات تثبيت التطبيقات
RESPONSIVE_DISPLAY_AD الإعلان هو إعلان صوري متجاوب.
LOCAL_AD الإعلان هو إعلان محلي.
HTML5_UPLOAD_AD الإعلان هو إعلان صوري يتم تحميله بنوع المنتج HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD الإعلان هو إعلان صوري يتم تحميله باستخدام أحد أنواع المنتجات DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD أن يكون الإعلان عبارة عن إعلان جذب إلى تطبيق
SHOPPING_COMPARISON_LISTING_AD أن يكون الإعلان عبارة عن إعلان بيانات مقارنة في Shopping
VIDEO_BUMPER_AD إعلان ملصق فيديو صغير
VIDEO_NON_SKIPPABLE_IN_STREAM_AD إعلان غير قابل للتخطّي أثناء عرض الفيديو
VIDEO_TRUEVIEW_IN_STREAM_AD إعلان فيديو TrueView أثناء عرض الفيديو
VIDEO_RESPONSIVE_AD إعلان فيديو متجاوب
SMART_CAMPAIGN_AD إعلان الحملة الذكية
CALL_AD إعلان للاتصال
APP_PRE_REGISTRATION_AD إعلان تسجيل مُسبَق لتطبيق عام
IN_FEED_VIDEO_AD إعلان فيديو ضمن الخلاصة
DEMAND_GEN_MULTI_ASSET_AD إعلان يتضمّن مواد عرض متعددة لزيادة الطلب
TRAVEL_AD إعلان سفر
DEMAND_GEN_VIDEO_RESPONSIVE_AD إعلان فيديو متجاوب لزيادة الطلب
DEMAND_GEN_PRODUCT_AD إعلان منتجات لزيادة الطلب

UrlCollection

مجموعة من عناوين URL التي تم وضع علامة عليها بمعرّف فريد

تمثيل JSON 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
الحقول
finalUrls[]

string

قائمة بعناوين URL النهائية المحتملة
finalMobileUrls[]

string

قائمة بعناوين URL النهائية المحتملة للأجهزة الجوّالة
urlCollectionId

string

المعرّف الفريد لهذه النسخة من UrlCollection
trackingUrlTemplate

string

نموذج عنوان URL لإنشاء عنوان URL للتتبّع

SystemManagedResourceSource

قائمة بالعناصر التي تشمل مصادر العناصر التي يُديرها النظام

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
AD_VARIATIONS إعلان تجربة صيغ الإعلانات المنشأة

TextAdInfo

إعلان نصي

تمثيل JSON 
{
  "headline": string,
  "description1": string,
  "description2": string
}
الحقول
headline

string

عنوان الإعلان.
description1

string

السطر الأول من وصف الإعلان
description2

string

السطر الثاني من وصف الإعلان.

ExpandedTextAdInfo

إعلان نصي موسّع

تمثيل JSON 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
الحقول
headlinePart1

string

الجزء الأول من عنوان الإعلان.
headlinePart2

string

الجزء الثاني من عنوان الإعلان.
headlinePart3

string

الجزء الثالث من عنوان الإعلان.
description

string

وصف الإعلان
description2

string

الوصف الثاني للإعلان.
path1

string

النص الذي يمكن أن يظهر بجانب عنوان URL المعروض للإعلان.
path2

string

نص إضافي يمكن أن يظهر بجانب عنوان URL المعروض للإعلان.

CallAdInfo

إعلان للاتصال

تمثيل JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
الحقول
countryCode

string

رمز البلد في الإعلان.
phoneNumber

string

رقم الهاتف في الإعلان
businessName

string

اسم النشاط التجاري في الإعلان.
headline1

string

العنوان الأول في الإعلان
headline2

string

العنوان الثاني في الإعلان.
description1

string

السطر الأول من وصف الإعلان
description2

string

السطر الثاني من وصف الإعلان.
callTracked

boolean

يشير إلى ما إذا كان سيتم تفعيل ميزة تتبُّع المكالمات لتصميم الإعلان. يؤدي تفعيل ميزة تتبُّع المكالمات إلى تفعيل الإحالات الناجحة للمكالمات أيضًا.
disableCallConversion

boolean

ما إذا كان سيتم إيقاف الإحالة الناجحة للمكالمات لتصميم الإعلان. في حال ضبطها على true، يتم إيقاف الإحالات الناجحة للمكالمات حتى عندما يكون callTracked هو true. إذا كانت قيمة callTracked هي false، يتم تجاهل هذا الحقل.
phoneNumberVerificationUrl

string

عنوان URL الذي سيتم استخدامه لإثبات ملكية رقم الهاتف.
conversionAction

string

إجراء الإحالة الناجحة الذي يتمّ تحديد مصدر إحالة ناجحة عبر الاتصال الهاتفي له. في حال عدم ضبط هذه القيمة، يتم استخدام إجراء إحالة ناجحة تلقائي. لن يكون لهذا الحقل أي تأثير إلا في حال ضبط callTracked على true. وبخلاف ذلك، يتم تجاهل هذا الحقل.
conversionReportingState

enum (CallConversionReportingState)

سلوك الإحالة الناجحة للمكالمة لهذا الإعلان للاتصال. ويمكن أن يستخدم إعداد الإحالة الناجحة للمكالمات الخاص به، أو يكتسب الإعداد على مستوى الحساب، أو يكون غير مفعَّل.
path1

string

الجزء الأول من النص الذي يمكن إلحاقه بعنوان URL في الإعلان. اختياريّ.
path2

string

الجزء الثاني من النص الذي يمكن إلحاقه بعنوان URL في الإعلان. لا يمكن ضبط هذا الحقل إلا عند ضبط path1 أيضًا. اختياريّ.

ExpandedDynamicSearchAdInfo

إعلان ديناميكي موسّع على شبكة البحث

تمثيل JSON 
{
  "description": string,
  "description2": string
}
الحقول
description

string

وصف الإعلان
description2

string

الوصف الثاني للإعلان.

HotelAdInfo

لا يحتوي هذا النوع على أي حقول.

إعلان فندق

ShoppingSmartAdInfo

لا يحتوي هذا النوع على أي حقول.

إعلان Shopping ذكي

ShoppingProductAdInfo

لا يحتوي هذا النوع على أي حقول.

إعلان Shopping عادي

ImageAdInfo

إعلان مصوّر

تمثيل JSON 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "imageAsset": {
    object (AdImageAsset)
  },
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
الحقول
mimeType

enum (MimeType)

نوع MIME للصورة.
pixelWidth

string (int64 format)

العرض بالبكسل للصورة بالحجم الكامل
pixelHeight

string (int64 format)

الارتفاع بالبكسل للصورة بالحجم الكامل
imageUrl

string

عنوان URL للصورة بالحجم الكامل
previewPixelWidth

string (int64 format)

العرض بالبكسل لصورة حجم المعاينة
previewPixelHeight

string (int64 format)

الارتفاع بالبكسل لصورة حجم المعاينة
previewImageUrl

string

عنوان URL لصورة بحجم المعاينة
name

string

اسم الصورة إذا تم إنشاء الصورة من ملف MediaFile، هذا هو اسم ملف MediaFile. إذا تم إنشاء الصورة من وحدات البايت، سيكون هذا الحقل فارغًا.
حقل الربط image الصورة التي سيتم إنشاء ImageAd منها يمكن تحديد ذلك بطريقتَين. 1. مورد MediaFile حالي 2. بيانات الصورة الأولية بالبايت يمكن أن يكون image واحدًا فقط مما يلي:
imageAsset

object (AdImageAsset)

مواد عرض الصور المستخدَمة في الإعلان
data

string (bytes format)

بيانات الصورة الأولية بالتنسيق الثنائي

سلسلة بترميز base64
adIdToCopyImageFrom

string (int64 format)

رقم تعريف إعلان لنسخ الصورة منه

AdImageAsset

مادة عرض صورة مستخدَمة داخل إعلان

تمثيل JSON 
{
  "asset": string
}
الحقول
asset

string

اسم مورد مادة العرض لهذه الصورة.

VideoAdInfo

إعلان فيديو

تمثيل JSON 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
الحقول
video

object (AdVideoAsset)

مواد عرض فيديوهات YouTube المستخدَمة في الإعلان
حقل الربط format مخطّط خاص بتنسيقات الفيديوهات المختلفة يمكن أن يكون format واحدًا فقط مما يلي:
inStream

object (VideoTrueViewInStreamAdInfo)

شكل إعلان فيديو TrueView أثناء عرض الفيديو
bumper

object (VideoBumperInStreamAdInfo)

شكل إعلان ملصق صغير ضمن بث فيديو مباشر
outStream

object (VideoOutstreamAdInfo)

شكل إعلان الفيديو خارج البث المباشر
nonSkippable

object (VideoNonSkippableInStreamAdInfo)

شكل إعلان غير قابل للتخطّي أثناء عرض الفيديو
inFeed

object (InFeedVideoAdInfo)

شكل إعلان الفيديو ضمن الخلاصة

AdVideoAsset

مادة عرض فيديو مستخدَمة داخل إعلان

تمثيل JSON 
{
  "asset": string,
  "adVideoAssetInfo": {
    object (AdVideoAssetInfo)
  }
}
الحقول
asset

string

اسم مورد مادة العرض لهذا الفيديو.
adVideoAssetInfo

object (AdVideoAssetInfo)

يحتوي على حقول معلومات عن AdVideoAsset هذا.

AdVideoAssetInfo

يحتوي على حقول معلومات لـ AdVideoAssets.

تمثيل JSON 
{
  "adVideoAssetInventoryPreferences": {
    object (AdVideoAssetInventoryPreferences)
  }
}
الحقول
adVideoAssetInventoryPreferences

object (AdVideoAssetInventoryPreferences)

قائمة بالإعدادات المفضّلة للمساحات الإعلانية لهذا AdVideoAsset لا يمكن ضبط هذا الحقل إلّا لإعلان DiscoveryVideoResponsiveAd. ستكون الأفضلية لمواد عرض الفيديو التي تم ضبط إعدادات المفضّلة لمواد عرض المستودع عليها مقارنةً بالفيديوهات الأخرى من الإعلان نفسه خلال وقت العرض. على سبيل المثال، لنفترض أنّ هذا الإعلان يتم عرضه في مستودع إعلاني معيّن. سيحاول الخادم أولاً مطابقة فيديو مؤهّل مع إعدادات مفضّلة مطابقة لهذا المستودع. لا يتم اختيار الفيديوهات التي لا تتضمّن إعدادات مفضّلة إلا عند العثور على فيديو يتضمّن إعدادات مفضّلة مطابقة ويكون مؤهلاً لعرض إعلان في مساحة إعلانية معيّنة.

AdVideoAssetInventoryPreferences

الإعدادات المفضّلة لمستودع مواد عرض الفيديوهات على YouTube

تمثيل JSON 
{
  "inFeedPreference": boolean,
  "inStreamPreference": boolean,
  "shortsPreference": boolean
}
الحقول
inFeedPreference

boolean

عندما يكون هذا الخيار صحيحًا، ستُفضَّل مادة عرض الفيديو على YouTube التي تتضمّن هذا الإعداد المفضّل للمستودع عند اختيار فيديو لعرضه في الخلاصة.
inStreamPreference

boolean

عندما يكون هذا الخيار صحيحًا، ستُفضَّل "مادة عرض فيديو YouTube" التي تتضمّن هذا الخيار المفضّل لمستودع الإعلانات عند اختيار فيديو لعرضه أثناء عرض الفيديو.
shortsPreference

boolean

عندما يكون هذا الحقل صحيحًا، سيتمّ تفضيل مادة عرض الفيديو على YouTube التي تتضمّن هذا الإعداد المفضّل للمستودع عند اختيار فيديو لعرضه على YouTube Shorts.

VideoTrueViewInStreamAdInfo

تمثيل لشكل إعلان فيديو TrueView أثناء عرض الفيديو (إعلان يتم عرضه أثناء تشغيل الفيديو، غالبًا في البداية، ويعرض زرّ تخطّي بعد بضع ثوانٍ من بدء تشغيل الفيديو)

تمثيل JSON 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
الحقول
actionButtonLabel

string

تصنيف زر عبارة الحث على اتّخاذ إجراء الذي ينقل المستخدم إلى رابط عنوان URL النهائي لإعلان الفيديو مطلوبة لـ "حملات TrueView للإجراءات"، واختيارية بخلاف ذلك.
actionHeadline

string

نص إضافي يتم عرضه مع زر الحث على اتّخاذ إجراء لتقديم سياق وتشجيع المستخدمين على النقر على الزر
companionBanner

object (AdImageAsset)

مواد عرض الصور لإعلان البانر المصاحب المستخدَم مع الإعلان.

VideoBumperInStreamAdInfo

تمثيل لشكل إعلان الملصق الصغير أثناء عرض الفيديو (إعلان فيديو قصير جدًا غير قابل للتخطّي أثناء عرض الفيديو)

تمثيل JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
الحقول
companionBanner

object (AdImageAsset)

مواد عرض الصور لإعلان البانر المصاحب المستخدَم مع الإعلان.
actionButtonLabel

string

تصنيف زر "الحث على اتّخاذ إجراء" الذي ينقل المستخدِم إلى عنوان URL النهائي لإعلان الفيديو
actionHeadline

string

نص إضافي يتم عرضه مع زر الحث على اتّخاذ إجراء لتقديم سياق وتشجيع المستخدمين على النقر على الزر

VideoOutstreamAdInfo

تمثيل لشكل إعلان الفيديو خارج البث (إعلان معروض بجانب خلاصة مع تشغيل تلقائي بدون صوت)

تمثيل JSON 
{
  "headline": string,
  "description": string
}
الحقول
headline

string

عنوان الإعلان.
description

string

سطر الوصف

VideoNonSkippableInStreamAdInfo

تمثيل لشكل الإعلان غير القابل للتخطّي أثناء عرض الفيديو (إعلان فيديو غير قابل للتخطّي أثناء عرض الفيديو مدته 15 ثانية)

تمثيل JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
الحقول
companionBanner

object (AdImageAsset)

مواد عرض الصور لإعلان البانر المصاحب المستخدَم مع الإعلان.
actionButtonLabel

string

تصنيف زر "الحث على اتّخاذ إجراء" الذي ينقل المستخدِم إلى عنوان URL النهائي لإعلان الفيديو
actionHeadline

string

نص إضافي يتم عرضه مع زر "الحث على اتّخاذ إجراء" لتقديم سياق وتشجيع المستخدمين على النقر على الزر

InFeedVideoAdInfo

تمثيل لشكل إعلان الفيديو ضمن الخلاصة

تمثيل JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
الحقول
headline

string

عنوان الإعلان.
description1

string

السطر الأول من النص للإعلان.
description2

string

سطر النص الثاني للإعلان.
thumbnail

enum (VideoThumbnail)

صورة مصغّرة للفيديو لاستخدامها

VideoThumbnail

فهرس يسرد الأنواع المحتملة لصورة مصغّرة للفيديو

عمليات التعداد
UNSPECIFIED لم يتم تحديد النوع.
UNKNOWN القيمة المستلَمة غير معروفة في هذا الإصدار. هذه قيمة للردّ فقط.
DEFAULT_THUMBNAIL الصورة المصغّرة التلقائية يمكن أن يتم إنشاؤها تلقائيًا أو تحميلها من قِبل المستخدم.
THUMBNAIL_1 الصورة المصغّرة 1، تم إنشاؤها من الفيديو
THUMBNAIL_2 الصورة المصغّرة 2، التي تم إنشاؤها من الفيديو
THUMBNAIL_3 الصورة المصغّرة 3، التي تم إنشاؤها من الفيديو

VideoResponsiveAdInfo

إعلان فيديو متجاوب

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية المستخدَمة في العنوان القصير في الوقت الحالي، لا يمكن إدخال سوى قيمة واحدة للعنوان القصير.
longHeadlines[]

object (AdTextAsset)

قائمة بمواد عرض النصوص المستخدَمة للعنوان الطويل لا يمكن حاليًا إدخال سوى قيمة واحدة للعنوان الطويل.
descriptions[]

object (AdTextAsset)

قائمة بمواد العرض النصية المستخدَمة في الوصف في الوقت الحالي، لا يمكن إدخال سوى قيمة واحدة للوصف.
callToActions[]

object (AdTextAsset)

قائمة بمواد عرض النصوص المستخدَمة للزر، مثل زر "الحث على اتّخاذ إجراء" لا يمكن حاليًا استخدام سوى قيمة واحدة للزر.
videos[]

object (AdVideoAsset)

قائمة بمواد عرض فيديوهات YouTube المستخدَمة في الإعلان لا يمكن حاليًا استخدام سوى قيمة واحدة لمادة عرض فيديو YouTube.
companionBanners[]

object (AdImageAsset)

قائمة بمواد عرض الصور المستخدَمة في إعلان البانر المصاحب لا يمكن حاليًا استخدام سوى قيمة واحدة لمادة عرض البانر المصاحب.
breadcrumb1

string

الجزء الأول من النص الذي يظهر في الإعلان مع عنوان URL المعروض
breadcrumb2

string

الجزء الثاني من النص الذي يظهر في الإعلان مع عنوان URL المعروض.

ResponsiveSearchAdInfo

إعلان متجاوب على شبكة البحث

تتيح لك الإعلانات المتجاوبة على شبكة البحث إنشاء إعلان يتكيَّف لعرض المزيد من النصوص ورسائل أكثر ملاءمةً لعملائك. أدخِل عدّة عناوين وأوصاف عند إنشاء إعلان متجاوب على شبكة البحث. وبمرور الوقت، ستختبر "إعلانات Google" تلقائيًا تركيبات مختلفة وتتعرّف على أفضل التركيبات أداءً. ومن خلال تكييف محتوى إعلانك لمطابقة عبارات بحث العملاء المحتملين بشكلٍ أوثق، قد تسهم الإعلانات المتجاوبة على شبكة البحث في تحسين مستوى أداء حملتك.

مزيد من المعلومات على https://support.google.com/google-ads/answer/7684791

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية للعناوين عند عرض الإعلان، سيتم اختيار العناوين من هذه القائمة.
descriptions[]

object (AdTextAsset)

قائمة بمواد العرض النصية للأوصاف عند عرض الإعلان، سيتم اختيار الأوصاف من هذه القائمة.
path1

string

الجزء الأول من النص الذي يمكن إلحاقه بعنوان URL في الإعلان.
path2

string

الجزء الثاني من النص الذي يمكن إلحاقه بعنوان URL في الإعلان. لا يمكن ضبط هذا الحقل إلا عند ضبط path1 أيضًا.

LegacyResponsiveDisplayAdInfo

إعلان صوري متجاوب قديم يتم تصنيف الإعلانات من هذا النوع على أنّها "إعلانات متجاوبة" في واجهة مستخدم "إعلانات Google".

تمثيل JSON 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
الحقول
formatSetting

enum (DisplayAdFormatSetting)

تحدِّد هذه السمة التنسيق الذي سيتم عرض الإعلان به. القيمة التلقائية هي ALL_FORMATS.
shortHeadline

string

النسخة المختصرة من عنوان الإعلان.
longHeadline

string

النسخة الطويلة من عنوان الإعلان
description

string

وصف الإعلان
businessName

string

اسم النشاط التجاري في الإعلان.
allowFlexibleColor

boolean

موافقة المعلِن على السماح بالألوان المرنة عند ضبطها على true، قد يتم عرض الإعلان بلون مختلف إذا لزم الأمر. عندما يكون القيمة خطأ، سيتم عرض الإعلان بالألوان المحدّدة أو بلون محايد. تكون القيمة التلقائية true. يجب أن تكون صحيحة إذا لم يتم ضبط mainColor وaccentColor.
accentColor

string

اللون المميّز للإعلان بالتنسيق السداسي العشري، على سبيل المثال، #ffffff للأبيض في حال ضبط أحد العمودَين mainColor وaccentColor، يجب ضبط العمود الآخر أيضًا.
mainColor

string

اللون الرئيسي للإعلان بالتنسيق السداسي العشري، على سبيل المثال، #ffffff للأبيض في حال ضبط أحد العمودَين mainColor وaccentColor، يجب ضبط العمود الآخر أيضًا.
callToActionText

string

نص عبارة الحث على اتخاذ إجراء في الإعلان
logoImage

string

اسم مصدر MediaFile لصورة الشعار المستخدَمة في الإعلان
squareLogoImage

string

اسم مصدر MediaFile لصورة الشعار المربّع المستخدَمة في الإعلان.
marketingImage

string

اسم مصدر MediaFile للصورة التسويقية المستخدَمة في الإعلان.
squareMarketingImage

string

اسم مصدر MediaFile للصورة التسويقية المربّعة المستخدَمة في الإعلان.
pricePrefix

string

بادئة قبل السعر على سبيل المثال، "بسعر منخفض يصل إلى".
promoText

string

النص الترويجي المستخدَم في التنسيقات الديناميكية للإعلانات المتجاوبة. على سبيل المثال، "شحن مجاني خلال يومَين".

DisplayAdFormatSetting

يُدرِج إعدادات شكل الإعلانات الصورية.

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN القيمة غير معروفة في هذا الإصدار.
ALL_FORMATS النصوص والصور والأشكال المدمجة مع المحتوى
NON_NATIVE تنسيقات النصوص والصور
NATIVE على سبيل المثال، يتحكّم الناشر في عرض التنسيقات المدمجة مع المحتوى وليس Google.

AppAdInfo

إعلان تطبيق

تمثيل JSON 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ],
  "appDeepLink": {
    object (AdAppDeepLinkAsset)
  }
}
الحقول
mandatoryAdText

object (AdTextAsset)

نص الإعلان الإلزامي
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية للعناوين عند عرض الإعلان، سيتم اختيار العناوين من هذه القائمة.
descriptions[]

object (AdTextAsset)

قائمة بمواد العرض النصية للأوصاف عند عرض الإعلان، سيتم اختيار الأوصاف من هذه القائمة.
images[]

object (AdImageAsset)

قائمة بمواد عرض الصور التي قد يتم عرضها مع الإعلان
youtubeVideos[]

object (AdVideoAsset)

قائمة بمواد عرض فيديوهات YouTube التي قد تظهر مع الإعلان
html5MediaBundles[]

object (AdMediaBundleAsset)

قائمة بمواد عرض حِزم الوسائط التي يمكن استخدامها مع الإعلان

AdMediaBundleAsset

مادة عرض حِزمة وسائط مستخدَمة داخل إعلان

تمثيل JSON 
{
  "asset": string
}
الحقول
asset

string

اسم مورد مادة العرض لحزمة الوسائط هذه.

AdAppDeepLinkAsset

رابط لصفحة معيّنة في تطبيق يتم استخدامه داخل إعلان.

تمثيل JSON 
{
  "asset": string
}
الحقول
asset

string

اسم مصدر مادة العرض لمادة عرض رابط الصفحة في التطبيق هذه.

LegacyAppInstallAdInfo

إعلان قديم لتثبيت التطبيق لا يمكن استخدامه إلا من قِبل بضعة عملاء محدّدين.

تمثيل JSON 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
الحقول
appStore

enum (LegacyAppInstallAdAppStore)

متجر التطبيقات الذي يتوفّر فيه تطبيق الأجهزة الجوّالة.
appId

string

رقم تعريف التطبيق المتوافق مع الأجهزة الجوّالة
headline

string

عنوان الإعلان.
description1

string

السطر الأول من وصف الإعلان.
description2

string

سطر الوصف الثاني للإعلان.

LegacyAppInstallAdAppStore

نوع متجر التطبيقات في إعلان قديم لتثبيت التطبيق

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
APPLE_APP_STORE Apple iTunes
GOOGLE_PLAY Google Play.
WINDOWS_STORE ‫Windows Store
WINDOWS_PHONE_STORE Windows Phone Store
CN_APP_STORE يتم استضافة التطبيق في متجر تطبيقات صيني.

ResponsiveDisplayAdInfo

إعلان صوري متجاوب

تمثيل JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
الحقول
marketingImages[]

object (AdImageAsset)

الصور التسويقية التي سيتم استخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 600 × 314، ويجب أن تكون نسبة العرض إلى الارتفاع 1.91:1 (+-1%). يجب إدراج marketingImage واحد على الأقل. ويكون الحد الأقصى 15 عند دمجها مع squareMarketingImages.
squareMarketingImages[]

object (AdImageAsset)

صور تسويقية مربّعة لاستخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 300×300 ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 (+-1%). يجب توفّر مربّع marketingImage واحد على الأقل. ويكون الحد الأقصى 15 عند دمجها مع marketingImages.
logoImages[]

object (AdImageAsset)

صور الشعار التي سيتم استخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 512×128 ويجب أن تكون نسبة العرض إلى الارتفاع 4:1 (+-1%). ويكون الحدّ الأقصى 5 عند دمجها مع squareLogoImages.
squareLogoImages[]

object (AdImageAsset)

صور شعارات مربّعة لاستخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 128×128 ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 (+-1%). ويكون الحدّ الأقصى 5 عند دمجها مع logoImages.
headlines[]

object (AdTextAsset)

عناوين قصيرة للإعلان. الحد الأقصى لعدد الأحرف هو 30 حرفًا. يمكن تحديد عنوان واحد على الأقل و5 عناوين بحد أقصى.
longHeadline

object (AdTextAsset)

عنوان طويل مطلوب. الحد الأقصى للطول هو 90 حرفًا.
descriptions[]

object (AdTextAsset)

نصوص وصفية للإعلان الحد الأقصى للطول هو 90 حرفًا. يمكن تحديد عنوان واحد على الأقل و5 عناوين بحد أقصى.
youtubeVideos[]

object (AdVideoAsset)

فيديوهات اختيارية على YouTube للإعلان يمكن تحديد 5 فيديوهات كحد أقصى.
formatSetting

enum (DisplayAdFormatSetting)

تحدِّد هذه السمة التنسيق الذي سيتم عرض الإعلان به. القيمة التلقائية هي ALL_FORMATS.
controlSpec

object (ResponsiveDisplayAdControlSpec)

مواصفات عناصر التحكّم المختلفة في تصميم الإعلان
businessName

string

اسم المعلِن/العلامة التجارية الحد الأقصى لعرض الشاشة هو 25.
mainColor

string

اللون الرئيسي للإعلان بالتنسيق السداسي العشري، على سبيل المثال، #ffffff للأبيض في حال ضبط أحد العمودَين mainColor وaccentColor، يجب ضبط العمود الآخر أيضًا.
accentColor

string

اللون المميّز للإعلان بالتنسيق السداسي العشري، على سبيل المثال، #ffffff للأبيض في حال ضبط أحد العمودَين mainColor وaccentColor، يجب ضبط العمود الآخر أيضًا.
allowFlexibleColor

boolean

موافقة المعلِن على السماح بالألوان المرنة عند ضبطها على true، قد يتم عرض الإعلان بلون مختلف إذا لزم الأمر. عندما يكون القيمة خطأ، سيتم عرض الإعلان بالألوان المحدّدة أو بلون محايد. تكون القيمة التلقائية true. يجب أن تكون صحيحة إذا لم يتم ضبط mainColor وaccentColor.
callToActionText

string

نص عبارة الحث على اتخاذ إجراء في الإعلان الحد الأقصى لعرض الشاشة هو 30.
pricePrefix

string

بادئة قبل السعر على سبيل المثال، "بسعر منخفض يصل إلى".
promoText

string

النص الترويجي المستخدَم في التنسيقات الديناميكية للإعلانات المتجاوبة. على سبيل المثال، "شحن مجاني خلال يومَين".

ResponsiveDisplayAdControlSpec

مواصفات عناصر التحكّم المختلفة في المواد الإبداعية للإعلانات الصورية المتجاوبة

تمثيل JSON 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
الحقول
enableAssetEnhancements

boolean

ما إذا كان المعلِن قد فعّل ميزة "تحسينات مواد العرض"
enableAutogenVideo

boolean

ما إذا كان المعلِن قد فعّل ميزة إنشاء الفيديوهات تلقائيًا.

LocalAdInfo

إعلان محلي

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية للعناوين عند عرض الإعلان، سيتم اختيار العناوين من هذه القائمة. يجب تحديد عنوان واحد على الأقل و5 عناوين على الأكثر.
descriptions[]

object (AdTextAsset)

قائمة بمواد العرض النصية للأوصاف عند عرض الإعلان، سيتم اختيار الأوصاف من هذه القائمة. يجب تحديد وصف واحد على الأقل و5 أوصاف كحد أقصى.
callToActions[]

object (AdTextAsset)

قائمة بمواد العرض النصية لطلبات اتّخاذ إجراء عند عرض الإعلان، سيتم اختيار عبارات الحثّ على اتّخاذ إجراء من هذه القائمة. يجب تحديد عبارة واحدة لحث المستخدم على اتّخاذ إجراء على الأقل و5 عبارات كحدّ أقصى.
marketingImages[]

object (AdImageAsset)

قائمة بمواد عرض الصور التسويقية التي قد يتم عرضها مع الإعلان يجب أن تكون الصور بدقة 314×600 بكسل أو 320×320 بكسل. يجب تحديد مادة عرض صورة واحدة على الأقل و20 مادة عرض صورة بحد أقصى.
logoImages[]

object (AdImageAsset)

قائمة بمواد عرض صور الشعار التي قد يتم عرضها مع الإعلان يجب أن تكون الصور بدقة 128×128 بكسل وألّا يزيد حجمها عن 120 كيلوبايت. يجب تحديد مادة عرض صورة واحدة على الأقل و5 مواد عرض صور بحد أقصى.
videos[]

object (AdVideoAsset)

قائمة بمواد عرض فيديوهات YouTube التي قد تظهر مع الإعلان يجب تحديد مادة عرض فيديو واحدة على الأقل و20 مادة عرض فيديو كحد أقصى.
path1

string

الجزء الأول من النص الاختياري الذي يمكن إلحاقه بعنوان URL في الإعلان.
path2

string

الجزء الثاني من النص الاختياري الذي يمكن إلحاقه بعنوان URL في الإعلان. لا يمكن ضبط هذا الحقل إلا عند ضبط path1 أيضًا.

DisplayUploadAdInfo

نوع عام من الإعلانات الصورية. يتم التحكّم في شكل الإعلان الدقيق من خلال الحقل displayUploadProductType الذي يحدّد أنواع البيانات التي يجب تضمينها مع الإعلان.

تمثيل JSON 
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
الحقول
displayUploadProductType

enum (DisplayUploadProductType)

نوع المنتج لهذا الإعلان. اطّلِع على التعليقات في القائمة المحدَّدة للاطّلاع على التفاصيل.
حقل الربط media_asset بيانات مادة العرض التي تشكّل الإعلان يمكن أن يكون media_asset واحدًا فقط مما يلي:
mediaBundle

object (AdMediaBundleAsset)

مادة عرض حِزمة وسائط لاستخدامها في الإعلان للحصول على معلومات عن حِزمة الوسائط لـ HTML5_UPLOAD_AD، يُرجى الاطّلاع على https://support.google.com/google-ads/answer/1722096. تستخدِم حِزم الوسائط التي تشكّل جزءًا من أنواع المنتجات الديناميكية تنسيقًا خاصًا يجب إنشاؤه من خلال Google Web Designer. يُرجى الاطّلاع على https://support.google.com/webdesigner/answer/7543898 للحصول على مزيد من المعلومات.

DisplayUploadProductType

يسرد أنواع المنتجات التي يتم تحميلها لعرضها.

عمليات التعداد
UNSPECIFIED غير محدّد
UNKNOWN القيمة غير معروفة في هذا الإصدار.
HTML5_UPLOAD_AD إعلان HTML5 مُحمَّل يتطلّب نوع المنتج هذا ضبط حقل upload_media_bundle في DisplayUploadAdInfo.
DYNAMIC_HTML5_EDUCATION_AD إعلان تعليمي ديناميكي بتنسيق HTML5 يتطلّب نوع المنتج هذا ضبط حقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في حملة تعليمية.
DYNAMIC_HTML5_FLIGHT_AD إعلان رحلة جوية ديناميكي بتنسيق HTML5 يتطلّب نوع المنتج هذا ضبط حقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في حملة رحلات جوية.
DYNAMIC_HTML5_HOTEL_RENTAL_AD إعلان ديناميكي للفنادق والاستئجار بتنسيق HTML5 يتطلّب نوع المنتج هذا ضبط حقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في "حملة فنادق".
DYNAMIC_HTML5_JOB_AD إعلان وظائف ديناميكي بتنسيق HTML5 يتطلّب نوع المنتج هذا ضبط حقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في حملة وظائف.
DYNAMIC_HTML5_LOCAL_AD إعلان HTML5 ديناميكي محلي يتطلّب نوع المنتج هذا ضبط حقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في حملة محلية.
DYNAMIC_HTML5_REAL_ESTATE_AD إعلان عقارات ديناميكي بتنسيق HTML5 يتطلّب نوع المنتج هذا ضبط حقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في حملة متعلّقة بالعقارات.
DYNAMIC_HTML5_CUSTOM_AD إعلان مخصّص ديناميكي بتنسيق HTML5 يتطلّب نوع المنتج هذا ضبط حقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في حملة مخصّصة.
DYNAMIC_HTML5_TRAVEL_AD إعلان سفر ديناميكي بتنسيق HTML5 يتطلّب نوع المنتج هذا ضبط حقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في حملة سفر.
DYNAMIC_HTML5_HOTEL_AD إعلان فندق ديناميكي بتنسيق HTML5 يتطلّب نوع المنتج هذا ضبط حقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في "حملة فنادق".

AppEngagementAdInfo

تتيح لك إعلانات الجذب إلى التطبيقات كتابة نصّ لتشجيع المستخدمين على اتّخاذ إجراء محدّد في التطبيق، مثل تسجيل الوصول أو إجراء عملية شراء أو حجز رحلة طيران. تتيح لك إرسال مستخدمين إلى جزء محدد من تطبيقك حيث يمكنهم العثور على ما يبحثون عنه بصورة أسهل وأسرع.

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية للعناوين عند عرض الإعلان، سيتم اختيار العناوين من هذه القائمة.
descriptions[]

object (AdTextAsset)

قائمة بمواد العرض النصية للأوصاف عند عرض الإعلان، سيتم اختيار الأوصاف من هذه القائمة.
images[]

object (AdImageAsset)

قائمة بمواد عرض الصور التي قد يتم عرضها مع الإعلان
videos[]

object (AdVideoAsset)

قائمة بمواد عرض الفيديو التي قد يتم عرضها مع الإعلان

ShoppingComparisonListingAdInfo

إعلان بيانات مقارنة في Shopping

تمثيل JSON 
{
  "headline": string
}
الحقول
headline

string

عنوان الإعلان. هذا الحقل مطلوب. يتراوح الحدّ الأقصى المسموح به بين 25 و45 حرفًا.

AppPreRegistrationAdInfo

ترتبط إعلانات التسجيل المُسبَق للتطبيقات ببطاقة بيانات تطبيقك أو لعبتك على Google Play، ويمكن عرضها على Google Play وYouTube (ضمن البث فقط) وضمن التطبيقات والمواقع الإلكترونية المتوافقة مع الأجهزة الجوّالة الأخرى على "الشبكة الإعلانية". سيساعد ذلك في جذب انتباه المستخدمين إلى تطبيقك أو لعبتك وإنشاء قاعدة تثبيت مسبق لتطبيقك أو لعبتك قبل الإطلاق.

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية للعناوين عند عرض الإعلان، سيتم اختيار العناوين من هذه القائمة.
descriptions[]

object (AdTextAsset)

قائمة بمواد العرض النصية للأوصاف عند عرض الإعلان، سيتم اختيار الأوصاف من هذه القائمة.
images[]

object (AdImageAsset)

قائمة بأرقام تعريف مواد عرض الصور التي قد يتم عرض صورها مع الإعلان
youtubeVideos[]

object (AdVideoAsset)

قائمة بمعرّفات مواد عرض فيديوهات YouTube التي قد يتم عرض فيديوهاتها مع الإعلان

DemandGenMultiAssetAdInfo

إعلان يتضمّن مواد عرض متعددة لزيادة الطلب

تمثيل JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "tallPortraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
الحقول
marketingImages[]

object (AdImageAsset)

مواد عرض الصور التسويقية التي سيتم استخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 600 × 314، ويجب أن تكون نسبة العرض إلى الارتفاع 1.91:1 (+-1%). مطلوبة في حال عدم توفّر squareMarketingImages. ويكون الحد الأقصى 20 مستخدمًا عند دمج squareMarketingImages وportraitMarketingImages وtallPortraitMarketingImages.
squareMarketingImages[]

object (AdImageAsset)

مواد عرض الصور التسويقية المربّعة الشكل التي سيتم استخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 300×300 ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 (+-1%). مطلوبة في حال عدم توفّر marketingImages. ويكون الحد الأقصى 20 مستخدمًا عند دمج marketingImages وportraitMarketingImages وtallPortraitMarketingImages.
portraitMarketingImages[]

object (AdImageAsset)

مواد عرض الصور التسويقية بالوضع العمودي التي سيتم استخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 480×600 ويجب أن تكون نسبة العرض إلى الارتفاع 4:5 (+-1%). ويكون الحد الأقصى 20 مستخدمًا عند دمج marketingImages وsquareMarketingImages وtallPortraitMarketingImages.
tallPortraitMarketingImages[]

object (AdImageAsset)

مواد عرض الصور التسويقية العمودية الطويلة التي سيتم استخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو ‎600×1067 ويجب أن تكون نسبة العرض إلى الارتفاع 9:16 (+-1%). ويكون الحد الأقصى 20 رمزًا عند دمج marketingImages وsquareMarketingImages وportraitMarketingImages.
logoImages[]

object (AdImageAsset)

مواد عرض صور الشعار التي سيتم استخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 128×128 ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 (+-1%). يمكن تحديد صورة شعار واحدة على الأقل و5 صور شعار بحد أقصى.
headlines[]

object (AdTextAsset)

مادة عرض نص العنوان للإعلان. الحد الأقصى لعرض الشاشة هو 30. يمكن تحديد عنوان واحد على الأقل و5 عناوين بحد أقصى.
descriptions[]

object (AdTextAsset)

النص الوصفي للإعلان الحد الأقصى لعرض الشاشة هو 90. يمكن تحديد وصف واحد على الأقل و5 أوصاف بحد أقصى.
businessName

string

اسم المعلِن/العلامة التجارية الحد الأقصى لعرض الشاشة هو 25. مطلوب.
callToActionText

string

نص عبارة الحث على اتّخاذ إجراء
leadFormOnly

boolean

خيار منطقي يشير إلى ما إذا كان يجب عرض هذا الإعلان مع نموذج العملاء المحتملين.

DemandGenCarouselAdInfo

إعلان متبدّل لزيادة الطلب

تمثيل JSON 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDemandGenCarouselCardAsset)
    }
  ]
}
الحقول
businessName

string

مطلوب. اسم المعلِن/العلامة التجارية
logoImage

object (AdImageAsset)

مطلوب. صورة الشعار التي سيتم استخدامها في الإعلان الحد الأدنى للحجم هو 128×128 ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 (+-1%).
headline

object (AdTextAsset)

مطلوب. عنوان الإعلان.
description

object (AdTextAsset)

مطلوب. النص الوصفي للإعلان
callToActionText

string

نص عبارة الحث على اتّخاذ إجراء
carouselCards[]

object (AdDemandGenCarouselCardAsset)

مطلوب. بطاقات العرض الدوّارة التي ستظهر مع الإعلان 2 كحد أدنى و10 كحد أقصى

AdDemandGenCarouselCardAsset

مادة عرض بطاقة "الإعلان المتبدّل لزيادة الطلب" المستخدَمة داخل إعلان

تمثيل JSON 
{
  "asset": string
}
الحقول
asset

string

اسم مورد مادة العرض لبطاقة لوحة العرض الدوّارة هذه أثناء التصفّح.

DemandGenVideoResponsiveAdInfo

إعلان فيديو متجاوب لزيادة الطلب

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية المستخدَمة في العنوان القصير
longHeadlines[]

object (AdTextAsset)

قائمة بمواد عرض النصوص المستخدَمة للعنوان الطويل
descriptions[]

object (AdTextAsset)

قائمة بمواد العرض النصية المستخدَمة في الوصف
videos[]

object (AdVideoAsset)

قائمة بمواد عرض فيديوهات YouTube المستخدَمة في الإعلان
logoImages[]

object (AdImageAsset)

صورة الشعار التي سيتم استخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 128×128 ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 (+-1%).
breadcrumb1

string

الجزء الأول من النص الذي يظهر في الإعلان مع عنوان URL المعروض
breadcrumb2

string

الجزء الثاني من النص الذي يظهر في الإعلان مع عنوان URL المعروض.
businessName

object (AdTextAsset)

مطلوب. اسم المعلِن/العلامة التجارية
callToActions[]

object (AdCallToActionAsset)

مواد العرض من النوع CallToActionAsset المستخدَمة في زر "الحث على اتّخاذ إجراء"

AdCallToActionAsset

مادة عرض عبارة حثّ على اتّخاذ إجراء مستخدَمة داخل إعلان

تمثيل JSON 
{
  "asset": string
}
الحقول
asset

string

اسم مورد مادة العرض لمادة عرض عبارة الحث على اتّخاذ إجراء هذه.

DemandGenProductAdInfo

إعلان منتج لزيادة الطلب

تمثيل JSON 
{
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "logoImage": {
    object (AdImageAsset)
  },
  "callToAction": {
    object (AdCallToActionAsset)
  }
}
الحقول
breadcrumb1

string

الجزء الأول من النص الذي يظهر في الإعلان مع عنوان URL المعروض
breadcrumb2

string

الجزء الثاني من النص الذي يظهر في الإعلان مع عنوان URL المعروض.
businessName

object (AdTextAsset)

مطلوب. اسم المعلِن/العلامة التجارية
headline

object (AdTextAsset)

مطلوب. مادة عرض نصية مستخدَمة للعنوان القصير
description

object (AdTextAsset)

مطلوب. مادة العرض النصية المستخدَمة للوصف
logoImage

object (AdImageAsset)

مطلوب. صورة الشعار التي سيتم استخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 128×128 ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 (+-1%).
callToAction

object (AdCallToActionAsset)

مادة عرض من النوع CallToActionAsset المستخدَمة لزر "الحث على اتّخاذ إجراء"

TravelAdInfo

لا يحتوي هذا النوع على أي حقول.

إعلان سفر