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 (نظام Mobile Rich Media Ad Interface Definitions).

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

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

المواد الإبداعية التي تستخدم علامات الجهات الخارجية هي مواد إبداعية تتضمّن ما يلي 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 Video.

النتائج فقط، وهي صالحة فقط للمواد الإبداعية التي تستخدم علامة 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

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

يمكن العثور على رقم التعريف هذا في عنوان 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 ID.
UNIVERSAL_AD_REGISTRY_AD_ID استخدِم Ad-ID لتقديم معرّف الإعلان العالمي.
UNIVERSAL_AD_REGISTRY_CLEARCAST استخدِم clearcast.co.uk لتقديم معرّف الإعلان العالمي.
UNIVERSAL_AD_REGISTRY_DV360 استخدِم "مساحة العرض والفيديو 360" لتقديم "معرّف الإعلان الشامل".
UNIVERSAL_AD_REGISTRY_CM استخدِم "مدير الحملة 360" لتقديم Universal Ad ID.

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

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