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.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

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

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

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

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

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

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_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 للنطاقات التالية:

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

string

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

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

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

string

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

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

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

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

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