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,
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
الحقول
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 (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: (باستثناء المستودع الإعلاني الذي لا يتطلّب الامتثال لبروتوكول SSL). في حال استخدام وحدات ماكرو في عنوان 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)

اختيارية: تحدّد هذه السمة رمز الإعلان استنادًا إلى سلوك المستخدم (OBA) لتصميم إعلان الفيديو.

يتوفّر هذا الحقل في 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

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

لا يكون صالحًا إلا عند استخدام إعلان تتبُّع في "مدير الحملة 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
syntheticContentAttestationStatus

enum (SyntheticContentAttestationStatus)

اختيارية: تحديد ما إذا كان سيتم إضافة تصنيف إلى تصميم الإعلان للإشارة إلى أنّه تم إنشاؤه أو تعديله باستخدام الذكاء الاصطناعي عند عرضه في مناطق تسري فيها اللوائح التنظيمية المحلية المتعلقة بتصنيف المحتوى من إنشاء الذكاء الاصطناعي

HostingSource

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

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

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

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

تصميم إعلان مستضاف من خادم إعلانات من جهة خارجية (3PAS)

تتوفّر طريقتَي الإنشاء والتعديل لنوع الاستضافة هذا إذا كانت قيمة 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

مواد إبداعية من الوسائط التفاعلية المتقدّمة تم إنشاؤها في "استوديو Google" واستضافتها في "مدير الحملة 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)
    }
  ]
}
الحقول
approvalStatus

enum (ApprovalStatus)

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

enum (ReviewStatus)

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

enum (ReviewStatus)

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

object (ExchangeReviewStatus)

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

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

أنواع حالات الموافقة المحتملة وهو ملخّص 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

حالة مراجعة المواد الإبداعية في شبكة التبادل

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

enum (Exchange)

الشبكة الإعلانية التي تراجع تصميم الإعلان
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "percentage": string,
  "seconds": string
  // End of mutually exclusive fields.
}
الحقول
تمثّل هذه السمة قيمة الإزاحة. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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 استخدِم Ad-ID لتقديم معرّف الإعلان الشامل.
UNIVERSAL_AD_REGISTRY_CLEARCAST استخدِم clearcast.co.uk لتقديم معرّف الإعلان الشامل.
UNIVERSAL_AD_REGISTRY_DV360 استخدِم "مساحة العرض والفيديو 360" لتقديم Universal Ad ID.
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 لمورد رمز الإعلانات المستندة إلى الاهتمامات
position

enum (ObaIconPosition)

اختيارية: موضع رمز الإعلانات المستندة إلى الاهتمامات على تصميم الإعلان
dimensions

object (Dimensions)

اختيارية: أبعاد رمز الإعلانات المستندة إلى الاهتمامات
program

string

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

string

الحقل مطلوب. تمثّل هذه السمة عنوان URL الخاص بالصفحة المقصودة لرمز الإعلانات المستندة إلى الاهتمامات.

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

  • https://info.evidon.com
  • https://l.betrad.com
clickTrackingUrl

string

الحقل مطلوب. عنوان URL لتتبُّع النقرات على رمز الإعلانات المستندة إلى الاهتمامات

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

  • https://info.evidon.com
  • https://l.betrad.com
viewTrackingUrl

string

الحقل مطلوب. عنوان URL لتتبُّع عرض رمز الإعلانات المستندة إلى الاهتمامات

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

  • https://info.evidon.com
  • https://l.betrad.com

ObaIconPosition

موضع رمز الإعلانات المستندة إلى الاهتمامات على تصميم الإعلان

عمليات التعداد
OBA_ICON_POSITION_UNSPECIFIED لم يتم تحديد موضع رمز الإعلانات المستندة إلى الاهتمامات.
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

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