REST Resource: customers.ads

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

CustomParameter

تعيين يمكن استخدامه بواسطة علامات المعلّمات المخصّصة في trackingUrlTemplate أو finalUrls أو mobile_final_urls.

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

string

المفتاح الذي يطابق اسم علامة المعلمة.

value

string

القيمة المطلوب استبدالها.

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 هذا الإعلان هو إعلان مقارنة أسعار.
VIDEO_BUMPER_AD إعلان ملصق الفيديو الصغير.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD إعلان فيديو غير قابل للتخطي ضمن البث.
VIDEO_OUTSTREAM_AD إعلان خارج بث الفيديو
VIDEO_TRUEVIEW_IN_STREAM_AD إعلان فيديو TrueView أثناء عرض الفيديو.
VIDEO_RESPONSIVE_AD إعلان فيديو متجاوب.
SMART_CAMPAIGN_AD إعلان حملة ذكية.
CALL_AD إعلان للاتصال
APP_PRE_REGISTRATION_AD إعلان تسجيل مُسبَق للتطبيقات العامة
IN_FEED_VIDEO_AD إعلان فيديو ضمن الخلاصة.
DISCOVERY_MULTI_ASSET_AD إعلان متعدد مواد العرض أثناء التصفّح
TRAVEL_AD إعلان سفر
DISCOVERY_VIDEO_RESPONSIVE_AD إعلان فيديو متجاوب أثناء التصفّح
DEMAND_GEN_PRODUCT_AD إعلان منتجات لزيادة الطلب

الجهاز

لتعداد أجهزة "إعلانات Google" المتاحة للاستهداف.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN القيمة غير معروفة في هذا الإصدار.
MOBILE الأجهزة الجوّالة المجهزة بمتصفّحات إنترنت كاملة الوظائف.
TABLET الأجهزة اللوحية المزودة بمتصفحات الإنترنت كاملة الوظائف
DESKTOP أجهزة الكمبيوتر
CONNECTED_TV أجهزة التلفزيون الذكية ووحدات تحكّم الألعاب
OTHER أنواع الأجهزة الأخرى

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 أيضًا. اختياريّ.

CallConversionReportingState

أنواع البيانات المحتملة لحالة إجراء إحالة ناجحة عبر الاتصال الهاتفي.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
DISABLED تم إيقاف إجراء الإحالة الناجحة للمكالمة.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION سيستخدِم إجراء الإحالة الناجحة للمكالمة نوع الإحالة الناجحة للمكالمات الذي تمّ ضبطه على مستوى الحساب.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION سيستخدِم إجراء الإحالة الناجحة للمكالمة نوع الإحالة الناجحة للمكالمات الذي تمّ ضبطه على مستوى المورد (إعلانات للاتصال فقط/إضافات المكالمات).

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. الصورة المراد إنشاء إعلان مصوَّر منها. يمكن تحديد ذلك بإحدى طريقتين. 1. مورد حالي في MediaFile. 2. بيانات الصورة الأولية كبايت. يمكن أن يكون image واحدًا فقط مما يلي:
imageAsset

object (AdImageAsset)

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

data

string (bytes format)

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

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

adIdToCopyImageFrom

string (int64 format)

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

MimeType

نوع MIME

عمليات التعداد
UNSPECIFIED لم يتم تحديد نوع MIME.
UNKNOWN

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

هذه قيمة مخصّصة للردّ فقط.

IMAGE_JPEG نوع MIME للصورة/jpeg.
IMAGE_GIF نوع MIME للصورة/صورة GIF
IMAGE_PNG نوع الصورة MIME/png
FLASH نوع MIME للتطبيق/x-shockwave-flash.
TEXT_HTML نوع MIME للنص/html.
PDF نوع MIME للتطبيق/ملف pdf.
MSWORD نوع MIME للتطبيق/كلمة msword.
MSEXCEL نوع MIME للتطبيق/vnd.ms-excel
RTF نوع MIME للتطبيق/rtf.
AUDIO_WAV نوع MIME للصوت/wav.
AUDIO_MP3 نوع MIME للصوت/mp3.
HTML5_AD_ZIP نوع MIME للتطبيق/x-html5-ad-zip.

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
}
الحقول
asset

string

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

VideoTrueViewInStreamAdInfo

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

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

string

تسمية زر الحث على اتخاذ إجراء (CTA) الذي ينقل المستخدم إلى رابط عنوان URL النهائي لإعلان الفيديو. مطلوب لحملات TrueView for Action، اختياري في الحالات الأخرى.

actionHeadline

string

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

companionBanner

object (AdImageAsset)

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

VideoBumperInStreamAdInfo

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

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

object (AdImageAsset)

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

actionButtonLabel

string

تصنيف على عبارة "الحث على اتخاذ إجراء" الذي ينقل المستخدِم إلى رابط عنوان URL النهائي لإعلان الفيديو.

actionHeadline

string

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

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 المعروض.

AdTextAsset

مادة عرض نصية تُستخدم داخل إعلان.

تمثيل JSON
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
الحقول
pinnedField

enum (ServedAssetFieldType)

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

assetPerformanceLabel

enum (AssetPerformanceLabel)

تصنيف أداء مادة العرض النصية هذه

policySummaryInfo

object (AdAssetPolicySummary)

ملخّص السياسات لمادة العرض النصية هذه

text

string

نص مادة العرض.

ServedAssetFieldType

أنواع حقول مواد العرض المحتملة

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

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

هذه قيمة مخصّصة للردّ فقط.

HEADLINE_1 يتم استخدام مادة العرض في العنوان 1.
HEADLINE_2 يتم استخدام مادة العرض في العنوان 2.
HEADLINE_3 يتم استخدام مادة العرض في العنوان 3.
DESCRIPTION_1 يتم استخدام مادة العرض في الوصف 1.
DESCRIPTION_2 تُستخدم مادة العرض في الوصف 2.
HEADLINE تم استخدام مادة العرض في عنوان. يمكنك استخدام هذه الطريقة فقط في حال وجود عنوان واحد فقط في الإعلان. وبخلاف ذلك، يمكنك استخدام تعداد HEADLINE_1 أو HEADLINE_2 أو HEADLINE_3
HEADLINE_IN_PORTRAIT تم استخدام مادة العرض كعنوان في صورة عمودية.
LONG_HEADLINE تم استخدام مادة العرض في عنوان طويل (مستخدَم في MultiAssetWebAd).
DESCRIPTION تم استخدام مادة العرض في الوصف. لا تستخدِم هذه السمة إلّا إذا كان هناك وصف واحد فقط في الإعلان. في الحالات الأخرى، يُرجى استخدام التعداد DESCRIPTION_1 أو DESCRIPTION_@.
DESCRIPTION_IN_PORTRAIT تم استخدام مادة العرض كوصف في الصورة العمودية.
BUSINESS_NAME_IN_PORTRAIT تم استخدام مادة العرض كاسم للنشاط التجاري في صورة عمودية.
BUSINESS_NAME تم استخدام مادة العرض كاسم للنشاط التجاري.
MARKETING_IMAGE تم استخدام مادة العرض كصورة تسويقية.
MARKETING_IMAGE_IN_PORTRAIT تم استخدام مادة العرض كصورة تسويقية في صورة عمودية.
SQUARE_MARKETING_IMAGE تم استخدام مادة العرض كصورة تسويقية مربّعة.
PORTRAIT_MARKETING_IMAGE تم استخدام مادة العرض كصورة تسويقية عمودية.
CALL_TO_ACTION تم استخدام مادة العرض كعبارة تحث المستخدم على اتخاذ إجراء.
YOU_TUBE_VIDEO وتم استخدام مادة العرض كفيديو على YouTube.
CALL يتم استخدام مادة العرض هذه كمكالمة.
MOBILE_APP يتم استخدام مادة العرض هذه كتطبيق للأجهزة الجوّالة.
CALLOUT يتم استخدام مادة العرض هذه كوسيلة شرح.
STRUCTURED_SNIPPET يتم استخدام مادة العرض هذه كمقتطف من الموقع.
PRICE يتم استخدام مادة العرض هذه كسعر.
PROMOTION يتم استخدام مادة العرض هذه كعرض ترويجي.
AD_IMAGE يتم استخدام مادة العرض هذه كصورة.
LEAD_FORM تُستخدَم مادة العرض كنموذج عملاء محتملين.

AssetPerformanceLabel

يشير التعداد إلى تصنيفات الأداء المحتملة لمادة عرض، ويتم احتسابه عادةً في سياق عملية الربط.

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
PENDING لا تتوفّر أي معلومات عن الأداء لمادة العرض هذه إلى الآن. قد يرجع السبب في ذلك إلى أنّه لا يزال قيد المراجعة.
LEARNING بدأت مادة العرض في تلقّي مرّات ظهور، لكنّ الإحصاءات ليست ذات دلالة إحصائية بما يكفي للحصول على تصنيف لأداء مادة العرض.
LOW مواد العرض الأسوأ أداءً.
GOOD مواد عرض جيدة الأداء.
BEST مواد العرض الأفضل أداءً.

AdAssetPolicySummary

تحتوي على معلومات السياسة لمادة عرض داخل إعلان.

تمثيل JSON
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
الحقول
policyTopicEntries[]

object (PolicyTopicEntry)

قائمة نتائج السياسة لمادة العرض هذه

reviewStatus

enum (PolicyReviewStatus)

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

approvalStatus

enum (PolicyApprovalStatus)

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

PolicyTopicEntry

نتيجة السياسة المرفقة بمورد (مثل سياسة الكحول المرتبطة بموقع إلكتروني يبيع الكحول)

يحتوي كل PolicyTopicEntry على موضوع يشير إلى سياسة الإعلانات المحدّدة التي تتناولها الملاحظة ونوع يشير إلى تأثير ذلك الإدخال في عرض الإعلانات. وقد يحتوي بشكل اختياري على دليل واحد أو أكثر يشير إلى سبب النتيجة. وقد يتضمّن أيضًا بشكلٍ اختياري قيدًا واحدًا أو أكثر يقدّم تفاصيل عن كيفية تقييد العرض.

تمثيل JSON
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
الحقول
type

enum (PolicyTopicEntryType)

يصف التأثير السلبي أو الإيجابي لهذه السياسة في عرض الإعلانات.

evidences[]

object (PolicyTopicEvidence)

معلومات إضافية تشرح النتائج التي تم تحقيقها بموجب السياسة (مثل اسم العلامة التجارية لإحدى النتائج المتعلقة بعلامة تجارية)

constraints[]

object (PolicyTopicConstraint)

يشير إلى مدى تأثُّر عرض هذا المورد (على سبيل المثال، عدم عرض الإعلانات في بلد معيّن).

topic

string

موضوع السياسة الذي يشير إليه هذا الاستنتاج على سبيل المثال، "ALCOHOL" أو "TRADEMARKS_IN_AD_TEXT" أو "Destination_NOT_WORKING". لا يتم تثبيت مجموعة مواضيع السياسات المحتمَلة لإصدار معيّن من واجهة برمجة التطبيقات وقد تتغيّر في أي وقت.

PolicyTopicEntryType

أنواع إدخالات مواضيع السياسة المحتملة

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

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

هذه قيمة مخصّصة للردّ فقط.

PROHIBITED لن يتم عرض المورد.
LIMITED لن يتم عرض المورد في بعض الظروف.
FULLY_LIMITED لا يمكن عرض المورد على الإطلاق بسبب معايير الاستهداف الحالية.
DESCRIPTIVE قد يكون ذا أهمية، ولكنه لا يحدّ من كيفية عرض المورد.
BROADENING قد تزيد التغطية إلى أكثر من المعتاد.
AREA_OF_INTEREST_ONLY مقيَّدة لجميع البلدان المستهدفة، ولكن يمكن عرضها في بلدان أخرى من خلال مجال الاهتمام.

PolicyTopicEvidence

معلومات إضافية تشرح نتيجة السياسة.

تمثيل JSON
{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
الحقول
حقل الاتحاد value. معلومات محدّدة حول الأدلة استنادًا إلى نوع الدليل يمكن أن يكون value واحدًا فقط مما يلي:
websiteList

object (WebsiteList)

قائمة بالمواقع الإلكترونية المرتبطة بهذا المرجع

textList

object (TextList)

قائمة بالأدلة الموجودة في نص المرجع

languageCode

string

اللغة التي تم رصد كتابة المورد بها. هذه علامة لغة لمجموعة مهندسي شبكة الإنترنت (IETF)، مثل "en-US".

destinationTextList

object (DestinationTextList)

النص في وجهة المورد الذي يتسبب في العثور على السياسة.

destinationMismatch

object (DestinationMismatch)

لا يتطابق مع وجهات عناوين URL الخاصة بالمصدر.

destinationNotWorking

object (DestinationNotWorking)

التفاصيل التي تعرض فيها الوجهة رمز خطأ HTTP أو لا تعمل في جميع المواقع الجغرافية للأجهزة الشائعة الاستخدام

WebsiteList

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

تمثيل JSON
{
  "websites": [
    string
  ]
}
الحقول
websites[]

string

المواقع الإلكترونية التي أدت إلى نتيجة السياسة.

TextList

قائمة بأجزاء النص التي انتهكت إحدى السياسات

تمثيل JSON
{
  "texts": [
    string
  ]
}
الحقول
texts[]

string

تشير هذه السمة إلى أجزاء النص من المرجع التي أدّت إلى العثور على السياسة.

DestinationTextList

قائمة بالسلاسل التي تم العثور عليها في صفحة مقصودة أدت إلى العثور على السياسة.

تمثيل JSON
{
  "destinationTexts": [
    string
  ]
}
الحقول
destinationTexts[]

string

قائمة النصوص التي تم العثور عليها في الصفحة المقصودة للمورد

DestinationMismatch

دليل على عدم تطابق بين عناوين URL لمورد معيّن

تمثيل JSON
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
الحقول
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

مجموعة عناوين URL غير المتطابقة مع بعضها البعض.

PolicyTopicEvidenceDestinationMismatchUrlType

أنواع عناوين URL المحتملة لعدم تطابق الوجهة المتعلقة بموضوع السياسة.

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

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

هذه قيمة مخصّصة للردّ فقط.

DISPLAY_URL عنوان URL المعروض.
FINAL_URL عنوان URL النهائي.
FINAL_MOBILE_URL عنوان URL النهائي للأجهزة الجوّالة.
TRACKING_URL نموذج عنوان URL للتتبع، مع عنوان URL البديل لسطح المكتب.
MOBILE_TRACKING_URL نموذج عنوان URL للتتبع، مع عنوان URL البديل المخصص للأجهزة الجوّالة

DestinationNotWorking

تفاصيل الأدلة عندما تعرض الوجهة رمز خطأ HTTP أو لا تعمل في جميع المواقع الجغرافية للأجهزة الشائعة الاستخدام

تمثيل JSON
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
الحقول
device

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

نوع الجهاز الذي تعذّر تحميل عنوان URL

expandedUrl

string

عنوان URL الكامل الذي لا يعمل.

lastCheckedDateTime

string

المرة الأخيرة التي تم فيها التحقّق من عنوان URL التنسيق هو "YYYY-MM-DD HH:MM:SS". أمثلة: "2018-03-05 09:15:00" أو "2018-02-01 14:34:30"

حقل الاتحاد reason. يشير إلى سبب ظهور السياسة Destination_NOT_WORKING. يمكن أن يكون reason واحدًا فقط مما يلي:
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

نوع خطأ نظام أسماء النطاقات.

httpErrorCode

string (int64 format)

رمز خطأ HTTP.

PolicyTopicEvidenceDestinationNotWorkingDevice

أجهزة عدم عمل وجهة الأدلة المحتملة لموضوع السياسة.

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

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

هذه قيمة مخصّصة للردّ فقط.

DESKTOP لا تعمل الصفحة المقصودة على أجهزة الكمبيوتر المكتبي.
ANDROID لا تعمل الصفحة المقصودة على جهاز Android.
IOS لا تعمل الصفحة المقصودة على جهاز iOS.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

أنواع أخطاء نظام أسماء النطاقات المحتملة لموضوع السياسة المحتملة لا تعمل.

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

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

هذه قيمة مخصّصة للردّ فقط.

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

PolicyTopicConstraint

يصف تأثير إدخال موضوع السياسة في عرض الإعلانات.

تمثيل JSON
{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
الحقول
حقل الاتحاد value. تمثّل هذه السمة معلومات محدّدة عن القيد. يمكن أن يكون value واحدًا فقط مما يلي:
countryConstraintList

object (CountryConstraintList)

البلدان التي لا يمكن عرض المورد فيها.

resellerConstraint

object (ResellerConstraint)

قيد المورّد.

certificateMissingInCountryList

object (CountryConstraintList)

البلدان التي يشترط فيها تقديم شهادة.

certificateDomainMismatchInCountryList

object (CountryConstraintList)

البلدان التي لا يشمل نطاق المورد فيها الشهادات المرتبطة به.

CountryConstraintList

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

تمثيل JSON
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
الحقول
countries[]

object (CountryConstraint)

البلدان التي يتم حظر عرض الإعلانات فيها

totalTargetedCountries

integer

إجمالي عدد البلدان التي يستهدفها المورد.

CountryConstraint

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

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

string

الاستهداف الجغرافي لاسم مورد ثابت للبلد الذي يتقيد فيه العرض.

ResellerConstraint

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

يشير إلى أنّه تم تقييد موضوع متعلّق بالسياسة بسبب رفض الموقع الإلكتروني لأغراض المورّدين.

PolicyReviewStatus

الحالات المحتملة للتحقّق من الالتزام بالسياسات.

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

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

هذه قيمة مخصّصة للردّ فقط.

REVIEW_IN_PROGRESS قيد المراجعة حاليًا.
REVIEWED اكتملت المراجعة الأولية. وقد تكون المراجعات الأخرى مستمرة.
UNDER_APPEAL تمّت إعادة إرسال المرجع للموافقة عليه، أو تم تقديم طلب بإعادة النظر في قرار متعلّق بالسياسة.
ELIGIBLE_MAY_SERVE المورد مؤهَّل وقد يتم عرضه، ولكن قد يخضع لمراجعة إضافية.

PolicyApprovalStatus

الحالات المحتملة للموافقة على السياسة. وفي حال توفُّر عدة حالات موافقة، سيتم استخدام الحالة الأكثر شدّة. ترتيب مستوى الخطورة هو:DAPPROVED وAREA_OF_INTEREST_ONLY وAPPROVED_LIMITED وAPPROVED.

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

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

هذه قيمة مخصّصة للردّ فقط.

DISAPPROVED لن يتم عرض الإعلانات.
APPROVED_LIMITED يتم العمل مع قيود.
APPROVED يتم تقديم الخدمة بدون قيود.
AREA_OF_INTEREST_ONLY لن يتم عرض الإعلانات في البلدان المستهدفة، ولكن قد يتم عرضها للمستخدمين الذين يبحثون عن معلومات حول البلدان المستهدفة.

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. يجب أن تكون القيمة صحيحة إذا لم يتم ضبط 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)
    }
  ]
}
الحقول
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

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

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.
WINDOWS_PHONE_STORE متجر Windows Phone.
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 واحد على الأقل. وعند جمعها مع squareMarketingImages، يكون الحد الأقصى هو 15.

squareMarketingImages[]

object (AdImageAsset)

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

logoImages[]

object (AdImageAsset)

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

squareLogoImages[]

object (AdImageAsset)

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

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. يجب أن تكون القيمة صحيحة إذا لم يتم ضبط 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 حرفًا.

SmartCampaignAdInfo

إعلان حملة ذكية.

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

object (AdTextAsset)

قائمة مواد العرض النصية، يتوافق كل منها مع عنوان رئيسي عند عرض الإعلان. تتألف هذه القائمة من 3 مواد عرض نصية على الأقل و15 مادة عرض نصية.

descriptions[]

object (AdTextAsset)

قائمة مواد العرض النصية، يتوافق كل منها مع وصف الإعلان عند عرضه. تتألف هذه القائمة من مادتَي عرض على الأقل و4 مواد عرض نصية على الأكثر.

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 التي قد يتمّ عرض فيديوهاتها مع الإعلان.

DiscoveryMultiAssetAdInfo

"إعلان متعدد مواد العرض" أثناء التصفّح

تمثيل JSON
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      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 غير متوفّرة. ويكون الحدّ الأقصى عند مجموعه مع squareMarketingImages وportraitMarketingImages هو 20.

squareMarketingImages[]

object (AdImageAsset)

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

portraitMarketingImages[]

object (AdImageAsset)

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

logoImages[]

object (AdImageAsset)

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

headlines[]

object (AdTextAsset)

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

descriptions[]

object (AdTextAsset)

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

businessName

string

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

callToActionText

string

نص الحث على اتخاذ إجراء.

leadFormOnly

boolean

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

DiscoveryCarouselAdInfo

إعلان متبدّل أثناء التصفّح

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

string

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

logoImage

object (AdImageAsset)

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

headline

object (AdTextAsset)

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

description

object (AdTextAsset)

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

callToActionText

string

نص الحث على اتخاذ إجراء.

carouselCards[]

object (AdDiscoveryCarouselCardAsset)

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

AdDiscoveryCarouselCardAsset

مادة عرض بطاقة منصّة عرض بعناصر متغيّرة أثناء التصفّح مُستخدَمة داخل إعلان.

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

string

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

DiscoveryVideoResponsiveAdInfo

إعلان فيديو متجاوب أثناء التصفّح

تمثيل 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. الحد الأدنى للحجم هو 128x128 ويجب أن تكون نسبة العرض إلى الارتفاع 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. الحد الأدنى للحجم هو 128x128 ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 ( -1%).

callToAction

object (AdCallToActionAsset)

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

TravelAdInfo

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

إعلان سفر

الطُرق

get

لعرض الإعلان المطلوب بالتفصيل.

mutate

يتم تحديث الإعلانات.