REST Resource: advertisers.creatives

المورد: تصميم الإعلان

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

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

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

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

enum (EntityStatus)

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

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

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

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

يستخدم RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 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-normalized ويستخدم 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

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

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

HostingSource

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

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

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

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

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

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

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

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

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

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

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

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

CreativeAttribute

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

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

ReviewStatusInfo

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

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

enum (ApprovalStatus)

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

enum (ReviewStatus)

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

enum (ReviewStatus)

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

object (ExchangeReviewStatus)

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

object (PublisherReviewStatus)

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

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

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

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

ReviewStatus

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

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

ExchangeReviewStatus

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

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

enum (Exchange)

الشبكة الإعلانية التي تراجع تصميم الإعلان
status

enum (ReviewStatus)

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

PublisherReviewStatus

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

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

string

تمثّل هذه السمة الناشر الذي يراجع تصميم الإعلان.
status

enum (ReviewStatus)

تمثّل هذه السمة حالة مراجعة الناشر.

AssetAssociation

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

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

object (Asset)

اختياريّ. مادة العرض المرتبطة
role

enum (AssetRole)

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

مادة العرض

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

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

string (int64 format)

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

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

string

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

AssetRole

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

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

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

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

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

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

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

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

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

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

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

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

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

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

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

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

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

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

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

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

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

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

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

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

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

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

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

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

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

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

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

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

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

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

يشير ذلك إلى تقييم التطبيق في "متجر Google Play" أو متجر تطبيقات iOS.

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

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

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

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

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

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

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

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

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

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

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

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

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

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

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

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

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

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

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

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

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

enum (ExitEventType)

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

string

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

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

اختياريّ. اسم علامة النقر الخاصة بحدث الخروج.

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

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

string

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

ExitEventType

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

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

TimerEvent

حدث المؤقّت الخاص بتصميم الإعلان.

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

string

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

string

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

CounterEvent

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

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

string

مطلوب. اسم حدث العداد.
reportingName

string

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

AudioVideoOffset

تمثّل هذه السمة المدة التي تم فيها تشغيل محتوى صوتي أو فيديو.

تمثيل JSON 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
الحقول
حقل الدمج offset قيمة الإزاحة يمكن أن تكون offset إحدى القيم التالية فقط:
percentage

string (int64 format)

اختياريّ. الإزاحة كنسبة مئوية من مدة الصوت أو الفيديو
seconds

string (int64 format)

اختياريّ. مقدار الإزاحة بالثواني من بداية الصوت أو الفيديو

UniversalAdId

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

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

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

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

string

اختياريّ. تمثّل هذه السمة عنوان URL لمصدر رمز الإعلانات المستندة إلى الاهتمامات.
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

 تعدّل هذه الطريقة تصميم إعلان حالي.