REST Resource: advertisers.creatives

المرجع: تصميم الإعلان

تصميم إعلان واحد

تمثيل JSON 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean
}
الحقول
name

string

النتائج فقط. اسم مورد تصميم الإعلان.
advertiserId

string (int64 format)

النتائج فقط. المعرّف الفريد للمعلِن الذي ينتمي إليه تصميم الإعلان.
creativeId

string (int64 format)

النتائج فقط. المعرّف الفريد لتصميم الإعلان تمّ تعيينه من قِبل النظام.
cmPlacementId

string (int64 format)

النتائج فقط. رقم التعريف الفريد لموضع الإعلان على "مدير الحملة 360" المرتبط بتصميم الإعلان. لا ينطبق هذا الحقل إلّا على تصميمات الإعلانات التي تتم مزامنتها من "مدير الحملة".
displayName

string

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

يجب أن يكون بترميز UTF-8 بحد أقصى 240 بايت.
entityStatus

enum (EntityStatus)

مطلوب. تتحكّم هذه السمة في ما إذا كان يمكن عرض تصميم الإعلان أم لا.

القيم المقبولة هي:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر تعديل على تصميم الإعلان، سواء من قِبل المستخدم أو النظام (مثل مراجعة تصميم الإعلان) تمّ تعيينه من قِبل النظام.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
createTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لوقت إنشاء تصميم الإعلان تمّ تعيينه من قِبل النظام.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
creativeType

enum (CreativeType)

مطلوب. غير قابل للتغيير نوع تصميم الإعلان
hostingSource

enum (HostingSource)

مطلوب. يشير إلى مكان استضافة تصميم الإعلان.
dynamic

boolean

النتائج فقط. تشير إلى ما إذا كان تصميم الإعلان ديناميكيًا.
dimensions

object (Dimensions)

مطلوب. السمات الأساسية لتصميم الإعلان تنطبق على جميع أنواع تصميمات الإعلانات. تكون قيمة widthPixels وheightPixels تلقائيًا 0 عندما تكون creativeType إحدى القيم التالية:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

سمات إضافية تنطبق هذه السمة عندما يكون creativeType أحد الخيارات التالية:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

في حال تحديد هذا الحقل، يجب إدخال widthPixels وheightPixels ويجب أن تكونا أكبر من أو تساوي 0.
mediaDuration

string (Duration format)

النتائج فقط. مدة الوسائط لتصميم الإعلان تنطبق هذه السمة عندما يكون creativeType أحد الخيارات التالية:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

النتائج فقط. قائمة بسمات تصميم الإعلان التي ينشئها النظام
reviewStatus

object (ReviewStatusInfo)

النتائج فقط. الحالة الحالية لعملية مراجعة تصميم الإعلان
assets[]

object (AssetAssociation)

مطلوب. مواد العرض المرتبطة بهذه المادة الإبداعية
exitEvents[]

object (ExitEvent)

مطلوب. أحداث الخروج لتصميم الإعلان هذا. نقطة الخروج (المعروفة أيضًا باسم علامة النقر) هي أيّ منطقة في تصميم إعلانك يمكن لأحد المستخدمين النقر عليها لفتح الصفحة المقصودة للمعلِن. يجب أن يتضمّن كل تصميم إعلان مخرجًا واحدًا على الأقل. يمكنك إضافة عنصر خروج إلى تصميم إعلانك بإحدى الطرق التالية:

  • استخدِم منطقة النقر في Google Web Designer.
  • حدِّد متغيّر JavaScript باسم "clickTag".
  • استخدِم عنصر التفعيل (Enabler.exit()) لتتبُّع عمليات الخروج في أشكال الوسائط التفاعلية المتقدّمة.
timerEvents[]

object (TimerEvent)

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

object (CounterEvent)

أحداث العداد لتصميم إعلانات الوسائط المتعددة التفاعلية تتتبّع العدّادات عدد المرات التي يتفاعل فيها المستخدِم مع أي جزء من تصميم إعلان الوسائط الغنية بطريقة محدّدة (مرّات تمرير الماوس فوق العناصر ومرّات الخروج من العناصر والنقرات واللمس وتحميل البيانات وإدخالات لوحة المفاتيح وما إلى ذلك). يمكن تسجيل أيّ حدث يمكن تسجيله في تصميم الإعلان كمعدّل. اترك هذا الحقل فارغًا أو غير محدّد لتصميمات الإعلانات التي تحتوي على مواد عرض الصور فقط.
appendedTag

string

علامة تتبُّع HTML تابعة لجهة خارجية ليتم إلحاقها بعلامة تصميم الإعلان
integrationCode

string

معلومات التعريف المستخدَمة لربط تصميم الإعلان هذا بنظام خارجي يجب أن يكون ترميزه UTF-8 وألا يزيد طوله عن 10,000 حرف.
notes

string

ملاحظات المستخدِم لهذا تصميم الإعلان. يجب أن يكون بترميز UTF-8 وألا يزيد طوله عن 20,000 حرف.
iasCampaignMonitoring

boolean

يشير إلى ما إذا كان قد تم تفعيل ميزة مراقبة الحملات في Integral Ad Science (IAS). لتفعيل هذه الميزة للتصميم الإبداعي، تأكَّد من ضبط Advertiser.creative_config.ias_client_id على معرّف عميل IAS.
companionCreativeIds[]

string (int64 format)

أرقام تعريف تصميمات الإعلانات المصاحبة لتصميم إعلان فيديو

يمكنك تخصيص تصميمات إعلانات صورية حالية (مع مواد عرض الصور أو HTML5) لعرضها حول مشغّل الفيديو الخاص بالناشر. تظهر العناصر المصاحبة حول مشغّل الفيديو أثناء تشغيل الفيديو وتبقى ظاهرة بعد انتهاء تشغيله.

لا يمكن أن تكون تصميمات الإعلانات التي تحتوي على additional dimensions إعلانات مصاحبة.

لا يُسمَح باستخدام هذا الحقل إلا في creativeType التالية:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

ما إذا كان بإمكان المستخدم اختيار تخطّي تصميم إعلان الفيديو

لا يمكن استخدام هذا الحقل إلا مع creativeType التالية:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

المدة التي يتم فيها تشغيل الفيديو قبل ظهور زر التخطّي

هذا الحقل مطلوب عندما تكون قيمة skippable صحيحة.

لا يمكن استخدام هذا الحقل إلا مع creativeType التالية:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

مدة تشغيل الفيديو قبل احتساب مشاهدة

هذا الحقل مطلوب عندما تكون قيمة skippable صحيحة.

لا يمكن استخدام هذا الحقل إلا مع creativeType التالية:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

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

يُعدّ "رقم تعريف الإعلان العالمي" جزءًا من معيار VAST 4.0. ويمكن تعديله بعد إنشاء تصميم الإعلان.

لا يمكن استخدام هذا الحقل إلا مع creativeType التالية:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

تتبُّع عناوين URL من جهات خارجية لتتبُّع التفاعلات مع تصميم إعلان الفيديو

لا يمكن استخدام هذا الحقل إلا مع creativeType التالية:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

النتائج فقط. عمليات تحويل ترميز الصوت/الفيديو

تُعيد "مساحة العرض والفيديو 360" ترميز مادة العرض الرئيسية إلى عدد من الإصدارات البديلة التي تستخدم تنسيقات ملفات مختلفة أو لها خصائص مختلفة (درجة الدقة ومعدّل نقل البيانات الصوتي ومعدّل نقل البيانات في الفيديو)، وكلّ إصدار مصمّم لمشغّلات فيديو أو سرعات نقل بيانات معيّنة.

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

لا يتوفّر هذا الحقل إلّا في creativeType التالية:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

عناوين URL للتتبّع لمزوّدي الإحصاءات أو مورّدي تقنية الإعلان التابعين لجهات خارجية

يجب أن تبدأ عناوين URL بـ https (باستثناء المستودع الذي لا يتطلّب الامتثال لبروتوكول طبقة المقابس الآمنة). في حال استخدام وحدات الماكرو في عنوان URL، استخدِم فقط وحدات الماكرو المتوافقة مع "مساحة العرض والفيديو 360".

عناوين URL عادية فقط، بدون علامات IMG أو SCRIPT

لا يمكن الكتابة في هذا الحقل إلا في creativeType التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

عنوان URL لقياس JavaScript من مقدّمي خدمات إثبات الهوية التابعين لجهات خارجية المعتمَدين (ComScore وDoubleVerify وIAS وMoat) لا يُسمح باستخدام علامات النصوص البرمجية بتنسيق HTML.

لا يمكن الكتابة في هذا الحقل إلا في creativeType التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

إعلان التتبّع في "مدير الحملة 360" المرتبط بتصميم الإعلان.

اختياري للعناصر التالية creativeType عند إنشائها من قِبل معلِن يستخدم كلًّا من "مدير الحملة 360" وعرض الإعلانات التابع لجهة خارجية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

يتم عرض البيانات فقط للحالات الأخرى.
obaIcon

object (ObaIcon)

تُحدِّد رمز إعلانات "الحملات على شبكة البحث" لتصميم إعلان فيديو.

لا يتوفّر هذا الحقل إلّا في creativeType التالية:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

اختياريّ. علامة الطرف الثالث الأصلية المستخدَمة لتصميم الإعلان.

مطلوب وصالح فقط لمواد عرض العلامات التابعة لجهات خارجية.

المواد الإبداعية لعلامات الجهات الخارجية هي مواد إبداعية تتضمّن ما يلي من hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

اختياريّ. تشير إلى أنّ تصميم الإعلان يتطلّب MRAID (نظام تعريفات واجهة عرض الإعلانات للوسائط التفاعلية المتقدّمة على الأجهزة الجوّالة).

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

اختياري وصالح فقط لمواد عرض العلامات التابعة لجهات خارجية.

المواد الإبداعية لعلامات الجهات الخارجية هي مواد إبداعية تتضمّن ما يلي من hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

اختياريّ. تشير هذه السمة إلى أنّ تصميم الإعلان يعتمد على HTML5 لعرضه بشكل صحيح.

اختياري وصالح فقط لمواد عرض العلامات التابعة لجهات خارجية. المواد الإبداعية لعلامات الجهات الخارجية هي مواد إبداعية تتضمّن ما يلي من hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

اختياريّ. يشير إلى أنّ تصميم الإعلان سينتظر تلقّي إشعار بإعادة الإحالة لتحديد المصدر.

لا تكون صالحة إلا عند استخدام إعلان تتبُّع على "مدير الحملة 360" مع مَعلمة خادم إعلانات تابع لجهة خارجية ووحدة الماكرو ${DC_DBM_TOKEN}.

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

المواد الإبداعية لعلامات الجهات الخارجية هي مواد إبداعية تتضمّن ما يلي من hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

إنّ مواد علامة نموذج عرض إعلانات الفيديو (VAST) التابعة لجهات خارجية هي مواد إبداعية تتضمّن ما يلي من hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

اختياريّ. لتحديد اتجاه توسيع تصميم الإعلان.

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

المواد الإبداعية القابلة للتوسيع التابعة لجهات خارجية هي مواد إبداعية مصدر استضافتها هو:

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

اختياريّ. يشير إلى أنّ تصميم الإعلان سيتم توسيعه تلقائيًا عند التمرير فوقه.

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

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

اختياريّ. عنوان URL لعلامة VAST لمواد إبداعية لعلامة VAST تابعة لجهة خارجية.

مطلوبة وصالحة فقط للمواد الإبداعية لعلامات VAST التابعة لجهات خارجية.

إنّ مواد علامة نموذج عرض إعلانات الفيديو (VAST) التابعة لجهات خارجية هي مواد إبداعية تتضمّن ما يلي من hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

النتائج فقط. يشير ذلك إلى أنّ تصميم إعلان علامة VAST التابعة لجهة خارجية يتطلّب استخدام معيار VPAID (واجهة عرض الإعلانات على مشغّل الفيديو الرقمي).

النتائج فقط، وهي صالحة فقط للمواد الإبداعية لعلامات VAST التابعة لجهات خارجية.

إنّ مواد علامة نموذج عرض إعلانات الفيديو (VAST) التابعة لجهات خارجية هي مواد إبداعية تتضمّن ما يلي من hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

النتائج فقط. يشير ذلك إلى أنّ تصميم الإعلان المزوّد بعلامة VAST التابعة لجهة خارجية يتطلّب توفّر فيديو HTML5.

النتائج فقط، وهي صالحة فقط للمواد الإبداعية لعلامات VAST التابعة لجهات خارجية.

إنّ مواد علامة نموذج عرض إعلانات الفيديو (VAST) التابعة لجهات خارجية هي مواد إبداعية تتضمّن ما يلي من hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

النتائج فقط. أرقام تعريف العناصر المرتبطة بهذا تصميم الإعلان.

لربط تصميم إعلان بعنصر، استخدِم LineItem.creative_ids بدلاً من ذلك.
mp3Audio

boolean

النتائج فقط. يشير إلى أنّ تصميم الإعلان الصوتي التابع لجهة خارجية متوافق مع ملفات MP3.

النتائج فقط، وهي صالحة للمواد الإبداعية الصوتية التابعة لجهات خارجية فقط.

المواد الإبداعية الصوتية التابعة لجهات خارجية هي مواد إبداعية تتضمّن ما يلي hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

النتائج فقط. يشير إلى أنّ تصميم الإعلان الصوتي التابع لجهة خارجية متوافق مع OGG.

النتائج فقط، وهي صالحة للمواد الإبداعية الصوتية التابعة لجهات خارجية فقط.

المواد الإبداعية الصوتية التابعة لجهات خارجية هي مواد إبداعية تتضمّن ما يلي hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_AUDIO

HostingSource

مصادر الاستضافة المحتمَلة لتصميم إعلان يشير إلى مكان إنشاء تصميم الإعلان واستضافته.

عمليات التعداد
HOSTING_SOURCE_UNSPECIFIED لم يتم تحديد مصدر الاستضافة أو هو غير معروف في هذا الإصدار.
HOSTING_SOURCE_CM

تصميم إعلان تمت مزامنته من "مدير الحملة 360".

لا تتوفّر طرق الإنشاء والتعديل لهذا النوع من الاستضافة.
HOSTING_SOURCE_THIRD_PARTY

تصميم إعلان مستضاف من خادم إعلانات تابع لجهة خارجية

تتوفّر طرق الإنشاء والتعديل لهذا النوع من الاستضافة إذا كان creativeType أحد الخيارات التالية:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

تصميم إعلان تم إنشاؤه في "مساحة العرض والفيديو 360" ويستضيفه "مدير الحملة 360".

تتوفّر طرق الإنشاء والتعديل لهذا النوع من الاستضافة إذا كان creativeType أحد الخيارات التالية:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_RICH_MEDIA

تصميم إعلان غني بالوسائط تم إنشاؤه في "استوديو" واستضافته من خلال "مدير الحملة 360".

لا تتوفّر طرق الإنشاء والتعديل لهذا النوع من الاستضافة.

CreativeAttribute

السمات المحتمَلة لتصميم الإعلان

عمليات التعداد
CREATIVE_ATTRIBUTE_UNSPECIFIED لم يتم تحديد سمة تصميم الإعلان أو هي غير معروفة في هذا الإصدار.
CREATIVE_ATTRIBUTE_VAST تصميم الإعلان هو تصميم إعلان VAST.
CREATIVE_ATTRIBUTE_VPAID_LINEAR تصميم الإعلان هو تصميم إعلان خطي بمعيار VPAID.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR تصميم الإعلان هو تصميم إعلان غير خطي بمعيار VPAID.

ReviewStatusInfo

راجِع حالات تصميم الإعلان.

تمثيل JSON 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}
الحقول
approvalStatus

enum (ApprovalStatus)

تمثّل الموافقة الأساسية المطلوبة لبدء عرض تصميم الإعلان. ملخّص عن creativeAndLandingPageReviewStatus وcontentAndPolicyReviewStatus
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

حالة مراجعة تصميم الإعلان والصفحة المقصودة لتصميم الإعلان.
contentAndPolicyReviewStatus

enum (ReviewStatus)

حالة مراجعة المحتوى والسياسة لتصميم الإعلان
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

تبادل حالات المراجعة لتصميم الإعلان.
publisherReviewStatuses[]
(deprecated)

object (PublisherReviewStatus)

حالات مراجعة الناشر لتصميم الإعلان

حالة الموافقة

أنواع حالات الموافقة المحتملة وهو ملخّص creativeAndLandingPageReviewStatus وcontentAndPolicyReviewStatus.

عمليات التعداد
APPROVAL_STATUS_UNSPECIFIED لم يتم تحديد قيمة النوع أو هي غير معروفة في هذا الإصدار.
APPROVAL_STATUS_PENDING_NOT_SERVABLE لا يزال تصميم الإعلان قيد المراجعة ولا يمكن عرضه.
APPROVAL_STATUS_PENDING_SERVABLE اجتازت مادة العرض مراجعة المواد الإبداعية والصفحات المقصودة ويمكن عرضها، ولكنّها في انتظار مراجعة إضافية للمحتوى والسياسات.
APPROVAL_STATUS_APPROVED_SERVABLE تمّت الموافقة على كلّ من مراجعة المواد الإبداعية والصفحة المقصودة ومراجعة المحتوى والسياسة. أن يكون تصميم الإعلان قابلاً للعرض
APPROVAL_STATUS_REJECTED_NOT_SERVABLE هناك مشكلة في تصميم الإعلان يجب حلّها قبل أن يتم عرض الإعلان.

ReviewStatus

أنواع الحالات المحتمَلة للمراجعة

عمليات التعداد
REVIEW_STATUS_UNSPECIFIED لم يتم تحديد قيمة النوع أو هي غير معروفة في هذا الإصدار.
REVIEW_STATUS_APPROVED تمت الموافقة على تصميم الإعلان.
REVIEW_STATUS_REJECTED تم رفض تصميم الإعلان.
REVIEW_STATUS_PENDING مادة العرض في انتظار المراجعة.

ExchangeReviewStatus

حالة مراجعة تصميم الإعلان في Exchange

تمثيل JSON 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
الحقول
exchange

enum (Exchange)

مراجعة فريق التبادل لتصميم الإعلان
status

enum (ReviewStatus)

حالة مراجعة عملية الاستبدال

PublisherReviewStatus

حالة مراجعة الناشر لتصميم الإعلان.

تمثيل JSON 
{
  "publisherName": string,
  "status": enum (ReviewStatus)
}
الحقول
publisherName

string

الناشر الذي يراجع تصميم الإعلان
status

enum (ReviewStatus)

حالة مراجعة الناشر

AssetAssociation

ربط مادة العرض بتصميم الإعلان

تمثيل JSON 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
الحقول
asset

object (Asset)

مادة العرض المرتبطة
role

enum (AssetRole)

دور مادة العرض هذه في تصميم الإعلان.

مادة العرض

مادة عرض واحدة

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

string (int64 format)

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

تم تعديل مساحة معرّف الوسائط في 5 نيسان (أبريل) 2023. عدِّل أرقام تعريف الوسائط المخزّنة مؤقتًا قبل 5 نيسان (أبريل) 2023 من خلال استرداد معرّف الوسائط الجديد من موارد تصميم الإعلان المرتبطة أو إعادة تحميل مادة العرض.
content

string

محتوى مادة العرض بالنسبة إلى مواد العرض المحمَّلة، يكون المحتوى هو مسار العرض.

AssetRole

دور مادة العرض هذه في تصميم الإعلان.

عمليات التعداد
ASSET_ROLE_UNSPECIFIED لم يتم تحديد دور مادة العرض أو هو غير معروف في هذا الإصدار.
ASSET_ROLE_MAIN مادة العرض هي مادة العرض الرئيسية لتصميم الإعلان.
ASSET_ROLE_BACKUP مادة العرض هي مادة عرض احتياطية للتصميم الإعلاني.
ASSET_ROLE_POLITE_LOAD مادة العرض هي مادة عرض تحميل لتصميم الإعلان.
ASSET_ROLE_HEADLINE

عنوان مواد إبداعية أصلية

يجب أن يكون content بترميز UTF-8 وطول لا يزيد عن 25 حرفًا.

لا يتوفّر هذا الدور إلّا في creativeType التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

العنوان الطويل لمواد إبداعية أصلية

يجب أن يكون content بترميز UTF-8 وطول لا يزيد عن 50 حرفًا.

لا يتوفّر هذا الدور إلّا في creativeType التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

النص الأساسي لتصميم إعلان أصلي

يجب أن يكون content بترميز UTF-8 وطول لا يزيد عن 90 حرفًا.

لا يتوفّر هذا الدور إلّا في creativeType التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

النص الأساسي الطويل لتصميم إعلان مدمج مع المحتوى

يجب أن يكون content بترميز UTF-8 وألا يزيد طوله عن 150 حرفًا.

لا يتوفّر هذا الدور إلّا في creativeType التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

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

يجب أن يكون content بترميز UTF-8 ولا يزيد طوله عن 30 حرفًا.

على سبيل المثال، إذا كان عنوان URL للصفحة المقصودة هو "http://www.example.com/page"، يمكن أن يكون عنوان URL للترجمة والشرح هو "example.com". يكون بروتوكول HTTP:// اختياريًا، ولكن لا يمكن أن يحتوي عنوان URL على مسافات أو رموز خاصة.

لا يتوفّر هذا الدور إلّا في creativeType التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

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

يجب أن يكون content بترميز UTF-8 وطول لا يزيد عن 15 حرفًا.

لا يتوفّر هذا الدور إلّا في creativeType التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

النص الذي يحدّد المعلِن أو اسم العلامة التجارية

يجب أن يكون content بترميز UTF-8 وطول لا يزيد عن 25 حرفًا.

لا يتوفّر هذا الدور إلّا في creativeType التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

سعر شراء تطبيقك في "متجر Google Play" أو متجر تطبيقات iOS (على سبيل المثال، 5.99 دولار أمريكي).

يُرجى العلم أنّ هذه القيمة لا تتم مزامنتها تلقائيًا مع القيمة الفعلية المدرَجة في المتجر. وسيكون هذا العنوان هو العنوان المقدَّم دائمًا عند حفظ تصميم الإعلان.

يجب أن يكون content بترميز UTF-8 وطول لا يزيد عن 15 حرفًا.

تكون مواد عرض هذا الدور للقراءة فقط.
ASSET_ROLE_ANDROID_APP_ID

معرّف تطبيق Android في "متجر Google Play"

يمكنك العثور على هذا المعرّف في عنوان URL الخاص بالتطبيق على "متجر Google Play" بعد "id". على سبيل المثال، في https://play.google.com/store/apps/details?id=com.company.appname، المعرّف هو com.company.appname.

تكون مواد عرض هذا الدور للقراءة فقط.
ASSET_ROLE_IOS_APP_ID

رقم تعريف تطبيق iOS في متجر تطبيقات Apple

يمكن العثور على رقم التعريف هذا في عنوان URL الخاص بمتجر Apple App Store كسلسلة من الأرقام مباشرةً بعد "id". على سبيل المثال، في https://apps.apple.com/us/app/gmail-email-by-google/id422689480، يكون رقم التعريف هو 422689480.

تكون مواد عرض هذا الدور للقراءة فقط.
ASSET_ROLE_RATING

تقييم تطبيق في "متجر Google Play" أو متجر تطبيقات iOS

يُرجى العلم أنّ هذه القيمة لا تتم مزامنتها تلقائيًا مع التقييم الفعلي في المتجر. وسيكون هذا العنوان هو العنوان المقدَّم دائمًا عند حفظ تصميم الإعلان.

تكون مواد عرض هذا الدور للقراءة فقط.
ASSET_ROLE_ICON

رمز تصميم إعلان

لا يتوفّر هذا الدور إلّا في creativeType التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

صورة غلاف تصميم إعلان فيديو أصلي

لا يتوفّر هذا الدور إلّا في creativeType التالية:

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

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

لا يتوفّر هذا الدور إلّا في creativeType التالية:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

لون التمييز المُستخدَم في تصميم الإعلان.

لا يتوفّر هذا الدور إلّا في creativeType التالية:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

ما إذا كان يجب أن يستخدم تصميم الإعلان مادة عرض صورة.

لا يتوفّر هذا الدور إلّا في creativeType التالية:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

ما إذا كان يمكن تطبيق تحسينات مواد العرض على تصميم الإعلان

لا يتوفّر هذا الدور إلّا في creativeType التالية:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

حدث الخروج من تصميم الإعلان

تمثيل JSON 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
الحقول
type

enum (ExitEventType)

مطلوب. نوع حدث الخروج
url

string

مطلوب. عنوان URL للنقرة لحدث الخروج. يكون هذا الإجراء مطلوبًا عندما تكون type:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

اسم علامة النقر لحدث الخروج

يجب أن يكون الاسم فريدًا في تصميم إعلان واحد.

اترك هذا الحقل فارغًا أو غير محدّد لتصميمات الإعلانات التي تحتوي على مواد عرض الصور فقط.
reportingName

string

الاسم المستخدَم لتحديد هذا الحدث في التقارير. اترك هذا الحقل فارغًا أو غير محدّد لتصميمات الإعلانات التي تحتوي على مواد عرض الصور فقط.

ExitEventType

نوع حدث الخروج

عمليات التعداد
EXIT_EVENT_TYPE_UNSPECIFIED لم يتم تحديد نوع حدث الخروج أو هو غير معروف في هذا الإصدار.
EXIT_EVENT_TYPE_DEFAULT حدث الخروج هو الحدث التلقائي.
EXIT_EVENT_TYPE_BACKUP حدث الخروج هو حدث احتياطي للخروج. يمكن أن تكون هناك أحداث خروج احتياطية متعدّدة في تصميم الإعلان.

TimerEvent

حدث الموقّت لتصميم الإعلان.

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

string

مطلوب. اسم حدث الموقّت
reportingName

string

مطلوب. الاسم المستخدَم لتحديد حدث الموقّت هذا في التقارير.

CounterEvent

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

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

string

مطلوب. اسم الحدث المُحتسَب
reportingName

string

مطلوب. الاسم المستخدَم لتحديد حدث العداد هذا في التقارير.

AudioVideoOffset

مدة تشغيل الصوت أو الفيديو

تمثيل JSON 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
الحقول
حقل الربط offset قيمة العنصر المُعوض. يمكن أن يكون offset واحدًا مما يلي فقط:
percentage

string (int64 format)

المدة الزمنية التي تم اقتطاعها كنسبة مئوية من مدة الصوت أو الفيديو
seconds

string (int64 format)

الفَرق بالثواني من بداية الصوت أو الفيديو

UniversalAdId

معرّف تصميم إعلان يقدّمه سجلّ معرّفات فريد على جميع المنصّات يُعدّ ذلك جزءًا من معيار VAST 4.0.

تمثيل JSON 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
الحقول
id

string

المعرّف الفريد لتصميم الإعلان
registry

enum (UniversalAdRegistry)

يقدّم السجلّ معرّفات فريدة لتصاميم الإعلانات.

UniversalAdRegistry

يقدّم السجلّ معرّفات فريدة لتصاميم الإعلانات في المعرّف العالمي للإعلان.

عمليات التعداد
UNIVERSAL_AD_REGISTRY_UNSPECIFIED لم يتم تحديد "قاعدة بيانات Universal Ad" أو هي غير معروفة في هذا الإصدار.
UNIVERSAL_AD_REGISTRY_OTHER استخدِم موفِّرًا مخصّصًا لتقديم المعرّف الإعلاني العالمي.
UNIVERSAL_AD_REGISTRY_AD_ID استخدِم المعرّف الإعلاني لتقديم المعرّف الإعلاني العالمي.
UNIVERSAL_AD_REGISTRY_CLEARCAST استخدِم clearcast.co.uk لتقديم المعرّف الإعلاني العالمي.
UNIVERSAL_AD_REGISTRY_DV360 استخدِم "مساحة العرض والفيديو 360" لتقديم رقم تعريف الإعلان العالمي.
UNIVERSAL_AD_REGISTRY_CM استخدِم "مدير الحملة 360" لتقديم رقم تعريف الإعلان الشامل.

ThirdPartyUrl

تتبُّع عناوين URL من جهات خارجية لتتبُّع التفاعلات مع تصميم إعلان صوتي أو فيديو

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

enum (ThirdPartyUrlType)

يجب تتبُّع نوع التفاعل من خلال عنوان URL للتتبُّع.
url

string

عنوان URL للتتبُّع المستخدَم لتتبُّع التفاعل

قدِّم عنوان URL يتضمّن مسارًا أو سلسلة طلب بحث اختيارية تبدأ بـ https:. على سبيل المثال، https://www.example.com/path

ThirdPartyUrlType

يجب تتبُّع نوع التفاعل من خلال عنوان URL لتتبُّع الجهات الخارجية.

عمليات التعداد
THIRD_PARTY_URL_TYPE_UNSPECIFIED نوع عنوان URL التابع لجهة خارجية غير محدّد أو غير معروف في هذا الإصدار.
THIRD_PARTY_URL_TYPE_IMPRESSION تُستخدَم هذه السمة لاحتساب مرّات ظهور تصميم الإعلان بعد اكتمال تخزين الصوت أو الفيديو مؤقتًا.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING تُستخدَم هذه السمة لتتبُّع نقرات المستخدِمين على الصوت أو الفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START يُستخدَم لتتبُّع عدد المرات التي بدأ فيها المستخدِم تشغيل الصوت أو الفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE يُستخدَم لتتبُّع عدد مرّات تشغيل المحتوى الصوتي أو الفيديو حتى 25% من مدّته.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT تُستخدَم هذه السمة لتتبُّع عدد مرّات تشغيل الصوت أو الفيديو حتى 50% من مدّته.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE يُستخدَم لتتبُّع عدد مرّات تشغيل الصوت أو الفيديو حتى 75% من مدّته.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE تُستخدَم هذه السمة لتتبُّع عدد المرات التي تم فيها تشغيل الصوت أو الفيديو حتى النهاية.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE تُستخدَم هذه السمة لتتبُّع عدد المرات التي كتم فيها المستخدم الصوت أو الفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE تُستخدَم هذه السمة لتتبُّع عدد المرات التي أوقف فيها المستخدِم الصوت أو الفيديو مؤقتًا.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND تُستخدَم هذه السمة لتتبُّع عدد مرّات إعادة تشغيل المستخدم للمحتوى الصوتي أو الفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN يُستخدَم لتتبُّع عدد المرات التي يوسّع فيها المستخدم مشغّل الفيديو إلى حجم ملء الشاشة.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP يُستخدَم لتتبُّع عدد المرات التي أوقف فيها المستخدِم الصوت أو الفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM تُستخدَم هذه السمة لتتبُّع عدد المرات التي يُجري فيها المستخدِم نقرة مخصّصة، مثل النقر على نقطة ساخنة في الفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP تُستخدَم لتتبُّع عدد المرات التي تم فيها تخطّي المحتوى الصوتي أو الفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS تُستخدَم هذه السمة لتتبُّع عدد مرّات تشغيل الصوت أو الفيديو إلى مدة تم تحديدها من خلال progressOffset.

تحويل الترميز

يعرض معلومات عن ملف الصوت أو الفيديو الذي تم تحويل ترميزه.

تمثيل JSON 
{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
الحقول
name

string

اسم الملف الذي تم تحويل ترميزه
mimeType

string

نوع MIME للملف الذي تم تحويل ترميزه
transcoded

boolean

يشير إلى ما إذا كانت عملية تحويل الترميز قد تمت بنجاح.
dimensions

object (Dimensions)

أبعاد الفيديو الذي تم تحويل ترميزه
bitRateKbps

string (int64 format)

معدّل نقل البيانات لتحويل ترميز الفيديو الذي تم تحويل ترميزه، بالكيلوبايت في الثانية
frameRate

number

عدد اللقطات في الثانية للفيديو الذي تم تحويل ترميزه، وفقًا لعدد اللقطات المعروضة في الثانية
audioBitRateKbps

string (int64 format)

معدّل نقل البيانات لبثّ الصوت في الفيديو الذي تم تحويل ترميزه، أو معدّل نقل البيانات للصوت الذي تم تحويل ترميزه، بالكيلوبايت في الثانية
audioSampleRateHz

string (int64 format)

معدّل أخذ العينات لمقطع الصوت في الفيديو الذي تم تحويل ترميزه، أو معدّل أخذ العينات للصوت الذي تم تحويل ترميزه، بالهرتز
fileSizeBytes

string (int64 format)

حجم الملف الذي تم تحويل ترميزه، بالبايت

CmTrackingAd

إعلان تتبُّع في "مدير الحملة 360"

تمثيل JSON 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
الحقول
cmPlacementId

string (int64 format)

رقم تعريف موضع الإعلان الذي يتتبّعه "مدير الحملة 360".
cmCreativeId

string (int64 format)

رقم تعريف تصميم الإعلان لإعلان التتبّع في "مدير الحملة 360".
cmAdId

string (int64 format)

رقم تعريف الإعلان لإعلان التتبّع في "مدير الحملة 360".

ObaIcon

رمز OBA لتصميم إعلان

تمثيل JSON 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
الحقول
resourceUrl

string

عنوان URL لمصدر رمز OBA
resourceMimeType

string

نوع MIME لمورد رمز OBA
position

enum (ObaIconPosition)

موضع رمز OBA على تصميم الإعلان
dimensions

object (Dimensions)

أبعاد رمز OBA
program

string

برنامج رمز OBA على سبيل المثال: "خيارات الإعلانات".
landingPageUrl

string

مطلوب. عنوان URL للصفحة المقصودة لرمز OBA

يُسمح فقط بعناوين URL للنطاقات التالية:
clickTrackingUrl

string

مطلوب. عنوان URL لتتبُّع النقرات على رمز OBA

يُسمح فقط بعناوين URL للنطاقات التالية:
viewTrackingUrl

string

مطلوب. عنوان URL لتتبُّع المشاهدات لرمز OBA

يُسمح فقط بعناوين URL للنطاقات التالية:

ObaIconPosition

موضع رمز OBA على تصميم الإعلان

عمليات التعداد
OBA_ICON_POSITION_UNSPECIFIED لم يتم تحديد موضع رمز OBA.
OBA_ICON_POSITION_UPPER_RIGHT في أعلى يسار تصميم الإعلان.
OBA_ICON_POSITION_UPPER_LEFT في أعلى يمين تصميم الإعلان.
OBA_ICON_POSITION_LOWER_RIGHT في أسفل يسار تصميم الإعلان
OBA_ICON_POSITION_LOWER_LEFT في أسفل يمين تصميم الإعلان.

ExpandingDirection

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

عمليات التعداد
EXPANDING_DIRECTION_UNSPECIFIED لم يتم تحديد اتجاه التوسيع.
EXPANDING_DIRECTION_NONE لا يتم توسيعها في أي اتجاه.
EXPANDING_DIRECTION_UP توسيع لأعلى
EXPANDING_DIRECTION_DOWN توسيع لأسفل
EXPANDING_DIRECTION_LEFT يتم التوسيع لليسار.
EXPANDING_DIRECTION_RIGHT توسيع لليمين
EXPANDING_DIRECTION_UP_AND_LEFT يتم التوسيع للأعلى وإلى اليسار.
EXPANDING_DIRECTION_UP_AND_RIGHT يتم التوسيع للأعلى ولليمين.
EXPANDING_DIRECTION_DOWN_AND_LEFT يتم توسيعها للأسفل وإلى اليسار.
EXPANDING_DIRECTION_DOWN_AND_RIGHT يتم توسيعه للأسفل ولليمين.
EXPANDING_DIRECTION_UP_OR_DOWN يتم التوسيع للأعلى أو للأسفل.
EXPANDING_DIRECTION_LEFT_OR_RIGHT يتم توسيعها على يمين الشاشة أو يسارها.
EXPANDING_DIRECTION_ANY_DIAGONAL يمكن توسيعها في أي اتجاه قطري.

الطُرق

create

 لإنشاء تصميم إعلان جديد.

delete

 لحذف تصميم إعلان.

get

 الحصول على تصميم إعلان

list

 يُدرج تصميمات الإعلانات في حساب معلِن.

patch

 تعديل تصميم إعلان حالي