- المورد: تصميم الإعلان
- HostingSource
- CreativeAttribute
- ReviewStatusInfo
- ApprovalStatus
- ReviewStatus
- ExchangeReviewStatus
- PublisherReviewStatus
- AssetAssociation
- مادة العرض
- AssetRole
- ExitEvent
- ExitEventType
- TimerEvent
- CounterEvent
- AudioVideoOffset
- UniversalAdId
- UniversalAdRegistry
- ThirdPartyUrl
- ThirdPartyUrlType
- تحويل الترميز
- CmTrackingAd
- ObaIcon
- ObaIconPosition
- ExpandingDirection
- الطُرق
المرجع: تصميم الإعلان
تصميم إعلان واحد
تمثيل JSON |
---|
{ "name": string, "advertiserId": string, "creativeId": string, "cmPlacementId": string, "displayName": string, "entityStatus": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم مورد تصميم الإعلان. |
advertiser |
النتائج فقط. المعرّف الفريد للمعلِن الذي ينتمي إليه تصميم الإعلان. |
creative |
النتائج فقط. المعرّف الفريد لتصميم الإعلان. تمّ تعيينه من قِبل النظام. |
cm |
النتائج فقط. رقم التعريف الفريد لموضع الإعلان على "مدير الحملة 360" المرتبط بتصميم الإعلان. لا ينطبق هذا الحقل إلّا على تصميمات الإعلانات التي تتم مزامنتها من "مدير الحملة". |
display |
مطلوب. الاسم المعروض لتصميم الإعلان. يجب أن يكون بترميز UTF-8 بحيث لا يزيد حجمه عن 240 بايت. |
entity |
مطلوب. تتحكّم هذه السمة في ما إذا كان يمكن عرض تصميم الإعلان أم لا. القيم المقبولة هي:
|
update |
النتائج فقط. الطابع الزمني لآخر تعديل على تصميم الإعلان، سواء من قِبل المستخدم أو النظام (مثل مراجعة تصميم الإعلان) تمّ تعيينه من قِبل النظام. يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
create |
النتائج فقط. الطابع الزمني لوقت إنشاء تصميم الإعلان. تمّ تعيينه من قِبل النظام. يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
creative |
مطلوب. غير قابل للتغيير نوع تصميم الإعلان |
hosting |
مطلوب. يشير إلى مكان استضافة تصميم الإعلان. |
dynamic |
النتائج فقط. يشير إلى ما إذا كان تصميم الإعلان ديناميكيًا. |
dimensions |
مطلوب. السمات الأساسية لتصميم الإعلان تنطبق على جميع أنواع تصميمات الإعلانات. يتم ضبط قيمة
|
additional |
السمات الإضافية سارٍ عندما تكون السمة
في حال تحديد هذا الحقل، يكون الحقلان |
media |
النتائج فقط. مدة الوسائط لتصميم الإعلان. تنطبق هذه السمة عندما يكون
المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
creative |
النتائج فقط. قائمة بسمات تصميم الإعلان التي ينشئها النظام |
review |
النتائج فقط. الحالة الحالية لعملية مراجعة تصميم الإعلان |
assets[] |
مطلوب. مواد العرض المرتبطة بتصميم الإعلان هذا |
exit |
مطلوب. يمكنك الخروج من الأحداث لهذا تصميم الإعلان. نقطة الخروج (المعروفة أيضًا باسم علامة النقر) هي أيّ منطقة في تصميم إعلانك يمكن لأحد المستخدمين النقر عليها لفتح الصفحة المقصودة للمعلِن. يجب أن يتضمّن كل تصميم إعلان مسار خروج واحدًا على الأقل. يمكنك إضافة عنصر خروج إلى تصميم إعلانك بإحدى الطرق التالية:
|
timer |
أحداث مخصّصة للموقّت لتصميم إعلان وسائط متعددة تتتبّع الموقّتات الوقت الذي يشاهد فيه المستخدِم جزءًا محدّدًا من تصميم إعلان الوسائط التفاعلية المتقدّمة ويتفاعل معه. يمكن أن يتضمن تصميم الإعلان أحداثًا متعددة ومؤقتات، ويتم تحديد وقت كل حدث على حدة. اترك هذا الحقل فارغًا أو غير محدّد لتصميمات الإعلانات التي تحتوي على مواد عرض الصور فقط. |
counter |
أحداث العداد لتصميم إعلانات الوسائط المتعددة التفاعلية تتتبع العدادات عدد المرات التي يتفاعل فيها المستخدم مع أي جزء من تصميم إعلان الوسائط المتعددة التفاعلية بطريقة محددة (تمرير الماوس فوقه، وسحب الماوس، والنقرات، والنقرات، وتحميل البيانات، وإدخالات لوحة المفاتيح، وما إلى ذلك). يمكن تسجيل أي حدث يمكن تسجيله في تصميم الإعلان على أنه عدّاد. اترك هذا الحقل فارغًا أو غير محدّد لتصميمات الإعلانات التي تحتوي على مواد عرض الصور فقط. |
appended |
علامة تتبُّع HTML تابعة لجهة خارجية ليتم إلحاقها بعلامة تصميم الإعلان |
integration |
معلومات التعريف المستخدَمة لربط تصميم الإعلان هذا بنظام خارجي يجب أن يكون ترميزه UTF-8 وألا يزيد طوله عن 10,000 حرف. |
notes |
ملاحظات المستخدِم لهذا تصميم الإعلان. يجب أن يكون بترميز UTF-8 وألا يزيد طوله عن 20,000 حرف. |
ias |
يشير إلى ما إذا كان قد تم تفعيل ميزة مراقبة الحملات في Integral Ad Science (IAS). لتفعيل هذا التصميم لتصميم الإعلان، تأكّد من ضبط |
companion |
أرقام تعريف تصميمات الإعلانات المصاحبة لتصميم إعلان فيديو يمكنك تخصيص تصميمات إعلانات صورية حالية (مع مواد عرض الصور أو HTML5) لعرضها حول مشغّل الفيديو الخاص بالناشر. يتم عرض الإعلانات المصاحبة حول مشغّل الفيديو أثناء تشغيل الفيديو، وتظل معروضة بعد انتهاء تشغيله. لا يمكن أن تكون تصميمات الإعلانات التي تحتوي على لا يُسمَح باستخدام هذا الحقل إلا في
|
skippable |
ما إذا كان بإمكان المستخدم اختيار تخطّي تصميم إعلان الفيديو لا يتوفّر هذا الحقل إلا لـ
|
skip |
الفترة الزمنية لتشغيل الفيديو قبل ظهور زر التخطّي. يجب ملء هذا الحقل عند ضبط السمة لا يمكن استخدام هذا الحقل إلا مع
|
progress |
مدة تشغيل الفيديو قبل احتساب مشاهدة هذا الحقل مطلوب عندما يكون لا يتوفّر هذا الحقل إلا لـ
|
universal |
اختياريّ. معرّف اختياري لتصميم الإعلان يقدّمه قاعدة بيانات معرّفات فريدة على مستوى جميع المنصّات. يُعدّ "رقم تعريف الإعلان العالمي" جزءًا من معيار VAST 4.0. ويمكن تعديله بعد إنشاء تصميم الإعلان. لا يمكن استخدام هذا الحقل إلا مع
|
third |
تتبُّع عناوين URL من جهات خارجية لتتبُّع التفاعلات مع تصميمات إعلانات الفيديو. لا يمكن استخدام هذا الحقل إلا مع
|
transcodes[] |
النتائج فقط. عمليات تحويل ترميز الصوت أو الفيديو تُعيد "مساحة العرض والفيديو 360" ترميز مادة العرض الرئيسية إلى عدد من الإصدارات البديلة التي تستخدم تنسيقات ملفات مختلفة أو لها خصائص مختلفة (درجة الدقة ومعدّل نقل البيانات الصوتي ومعدّل نقل البيانات في الفيديو)، وكلّ إصدار مصمّم لمشغّلات فيديو أو سرعات نقل بيانات معيّنة. تتيح عمليات تحويل الرموز هذه لنظام الناشر مزيدًا من الخيارات للاختيار من بينها لكل مرة ظهور في الفيديو، كما تضمن عرض الملف المناسب استنادًا إلى اتصال المشاهد وحجم الشاشة. لا يتوفّر هذا الحقل إلا في
|
tracker |
عناوين URL للتتبّع لمزوّدي الإحصاءات أو مورّدي تقنية الإعلان التابعين لجهات خارجية يجب أن تبدأ عناوين URL بـ https (باستثناء المستودع الذي لا يتطلّب الامتثال لبروتوكول SSL). في حال استخدام وحدات الماكرو في عنوان URL، استخدِم فقط وحدات الماكرو المتوافقة مع "مساحة العرض والفيديو 360". عناوين URL عادية فقط، بدون علامات IMG أو SCRIPT لا يمكن الكتابة في هذا الحقل إلّا في
|
js |
عنوان URL لقياس JavaScript من مزوّدي خدمات إثبات الهوية التابعين لجهات خارجية المعتمَدين (ComScore وDoubleVerify وIAS وMoat) علامات نص HTML البرمجي غير متوافقة. يمكن كتابة هذا الحقل فقط في ما يلي:
|
cm |
إعلان تتبُّع "مدير الحملة 360" المرتبط بتصميم الإعلان. اختياري للعناصر التالية
يتم عرض النتائج للحالات الأخرى فقط. |
oba |
تُحدِّد رمز إعلانات "الحملات على شبكة البحث" لتصميم إعلان فيديو. لا يمكن استخدام هذا الحقل إلّا في
|
third |
اختياريّ. علامة الطرف الثالث الأصلية المستخدَمة لتصميم الإعلان. مطلوب وصالح فقط لمواد عرض العلامات التابعة لجهات خارجية. المواد الإبداعية لعلامات الجهات الخارجية هي مواد إبداعية تتضمّن
تم دمجها مع
|
require |
اختياريّ. تشير إلى أنّ تصميم الإعلان يتطلّب MRAID (نظام تعريفات واجهة عرض الإعلانات للوسائط التفاعلية المتقدّمة على الأجهزة الجوّالة). عيِّن ذلك إذا كان تصميم الإعلان يعتمد على إيماءات الأجهزة الجوّالة للتفاعل، مثل التمرير السريع أو النقر. اختيارية وصالحة فقط لتصميمات علامات الجهات الخارجية. المواد الإبداعية لعلامات الجهات الخارجية هي مواد إبداعية تتضمّن
مع
|
require |
اختياريّ. تشير هذه السمة إلى أنّ تصميم الإعلان يعتمد على HTML5 لعرضه بشكل صحيح. اختياري وصالح فقط لمواد عرض العلامات التابعة لجهات خارجية. المواد الإبداعية لعلامات الجهات الخارجية هي مواد إبداعية تتضمّن
تم دمجها مع
|
require |
اختياريّ. يشير إلى أنّ تصميم الإعلان سينتظر تلقّي إشعار إرجاع للإسناد. لا تكون صالحة إلا عند استخدام إعلان تتبُّع في "مدير الحملة 360" مع مَعلمة خادم إعلانات تابع لجهة خارجية ووحدة الماكرو ${DC_DBM_TOKEN}. اختيارية وصالحة فقط لتصميمات إعلانات العلامات التابعة لجهات خارجية أو تصميمات علامات VAST التابعة لجهات خارجية. تصميمات علامات الجهات الخارجية هي مواد إبداعية تتضمّن
مع
تصميمات إعلانات علامات VAST التابعة لجهات خارجية هي مواد إبداعية تتضمّن
مع
|
expanding |
اختياريّ. لتحديد اتجاه توسيع تصميم الإعلان. مطلوبة وصالحة فقط للمواد الإبداعية القابلة للتوسيع التابعة لجهات خارجية. المواد الإبداعية القابلة للتوسيع التابعة لجهات خارجية هي مواد إبداعية مصدر استضافتها هو:
تم دمجها مع
|
expand |
اختياريّ. يشير إلى أنّ تصميم الإعلان سيتم توسيعه تلقائيًا عند التمرير فوقه. اختياري وصالح فقط لتصميمات الإعلانات القابلة للتوسيع التابعة لجهات خارجية. المواد الإبداعية القابلة للتوسيع التابعة لجهات خارجية هي مواد إبداعية مصدر استضافتها هو:
مع
|
vast |
اختياريّ. عنوان URL لعلامة VAST لمواد إبداعية لعلامة VAST تابعة لجهة خارجية. مطلوبة وصالحة فقط لتصميمات علامات VAST التابعة لجهات خارجية. مواد إبداعية علامات VAST التابعة لجهات خارجية هي مواد إبداعية تتضمّن ما يلي
تم دمجها مع
|
vpaid |
النتائج فقط. يشير ذلك إلى أنّ تصميم إعلان علامة VAST التابعة لجهة خارجية يتطلّب استخدام معيار VPAID (واجهة عرض الإعلانات على مشغّل الفيديو الرقمي). النتائج فقط، وهي صالحة فقط لمواد إبداعية علامات VAST التابعة لجهات خارجية. مواد إبداعية علامات VAST التابعة لجهات خارجية هي مواد إبداعية تتضمّن ما يلي
مع
|
html5 |
النتائج فقط. يشير ذلك إلى أنّ تصميم الإعلان المزوّد بعلامة VAST التابعة لجهة خارجية يتطلّب توفّر فيديو HTML5. للمخرجات فقط ولا يصلح إلا لتصميمات علامات VAST التابعة لجهات خارجية. مواد إبداعية علامات VAST التابعة لجهات خارجية هي مواد إبداعية تتضمّن ما يلي
مع
|
line |
النتائج فقط. أرقام تعريف العناصر التي يرتبط بها تصميم الإعلان هذا. لربط تصميم إعلان بعنصر، استخدِم |
mp3 |
النتائج فقط. يشير إلى أنّ تصميم الإعلان الصوتي التابع لجهة خارجية متوافق مع ملفات MP3. النتائج فقط، وهي صالحة للمواد الإبداعية الصوتية التابعة لجهات خارجية فقط. تصميمات الإعلانات الصوتية التابعة لجهات خارجية هي تصاميم إعلانات مع
مع
|
ogg |
النتائج فقط. يشير إلى أنّ تصميم الإعلان الصوتي التابع لجهة خارجية متوافق مع OGG. النتائج فقط، وهي صالحة للمواد الإبداعية الصوتية التابعة لجهات خارجية فقط. تصميمات الإعلانات الصوتية التابعة لجهات خارجية هي تصاميم إعلانات مع
مع
|
HostingSource
مصادر الاستضافة المحتملة لتصميم الإعلان يشير إلى مكان إنشاء تصميم الإعلان واستضافته.
عمليات التعداد | |
---|---|
HOSTING_SOURCE_UNSPECIFIED |
لم يتم تحديد مصدر الاستضافة أو هو غير معروف في هذا الإصدار. |
HOSTING_SOURCE_CM |
تصميم إعلان تمت مزامنته من "مدير الحملة 360". لا تتوفّر طرق الإنشاء والتعديل لهذا النوع من الاستضافة. |
HOSTING_SOURCE_THIRD_PARTY |
تصميم إعلان مستضاف من خادم إعلانات تابع لجهة خارجية يمكن استخدام طُرق الإنشاء والتعديل لهذا النوع من الاستضافة إذا كانت
|
HOSTING_SOURCE_HOSTED |
تصميم إعلان تم إنشاؤه في "مساحة العرض والفيديو 360" ويستضيفه "مدير الحملة 360". تتوفّر طرق الإنشاء والتعديل لهذا النوع من الاستضافة إذا كان
|
HOSTING_SOURCE_RICH_MEDIA |
تصميم إعلان من الوسائط التفاعلية المتقدّمة تم إنشاؤه في "استوديو YouTube" ويستضيفه "مدير الحملة 360". لا تتوافق طرق الإنشاء والتحديث مع هذا النوع من الاستضافة. |
CreativeAttribute
السمات المحتمَلة لتصميم الإعلان
عمليات التعداد | |
---|---|
CREATIVE_ATTRIBUTE_UNSPECIFIED |
لم يتم تحديد سمة تصميم الإعلان أو هي غير معروفة في هذا الإصدار. |
CREATIVE_ATTRIBUTE_VAST |
تصميم الإعلان هو تصميم إعلان VAST. |
CREATIVE_ATTRIBUTE_VPAID_LINEAR |
تصميم الإعلان هو تصميم إعلان خطي بمعيار VPAID. |
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR |
تصميم الإعلان عبارة عن تصميم إعلان VPAID غير خطي. |
ReviewStatusInfo
راجِع حالات تصميم الإعلان.
تمثيل JSON |
---|
{ "approvalStatus": enum ( |
الحقول | |
---|---|
approval |
تمثّل الموافقة الأساسية المطلوبة لبدء عرض تصميم الإعلان. ملخّص عن |
creative |
حالة مراجعة تصميم الإعلان والصفحة المقصودة لتصميم الإعلان. |
content |
حالة مراجعة المحتوى والسياسة لتصميم الإعلان |
exchange |
تبادل حالات المراجعة لتصميم الإعلان. |
publisherReviewStatuses[] |
حالات مراجعة الناشر لتصميم الإعلان |
حالة الموافقة
أنواع حالات الموافقة المحتملة وهو ملخّص 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 |
حالة مراجعة عملية الاستبدال |
PublisherReviewStatus
حالة مراجعة الناشر لتصميم الإعلان.
تمثيل JSON |
---|
{
"publisherName": string,
"status": enum ( |
الحقول | |
---|---|
publisher |
الناشر الذي يراجع تصميم الإعلان |
status |
حالة مراجعة الناشر |
AssetAssociation
ربط مادة العرض بتصميم الإعلان
تمثيل JSON |
---|
{ "asset": { object ( |
الحقول | |
---|---|
asset |
مادة العرض المرتبطة |
role |
دور مادة العرض هذه في تصميم الإعلان |
مادة العرض
مادة عرض واحدة
تمثيل JSON |
---|
{ "mediaId": string, "content": string } |
الحقول | |
---|---|
media |
رقم تعريف الوسائط لمادة العرض المحمَّلة. هذا هو المعرّف الفريد لمادة العرض. ويمكن تمرير رقم التعريف هذا إلى طلبات بيانات من واجهة برمجة التطبيقات الأخرى، مثل تم تعديل مساحة معرّف الوسائط في 5 نيسان (أبريل) 2023. يمكنك تعديل معرّفات الوسائط المخزّنة مؤقتًا قبل 5 نيسان (أبريل) 2023 من خلال استرداد معرّف الوسائط الجديد من موارد المواد الإبداعية المرتبطة أو إعادة تحميل مادة العرض. |
content |
محتوى مادة العرض بالنسبة إلى مواد العرض المحمَّلة، يكون المحتوى هو مسار العرض. |
AssetRole
دور مادة العرض هذه في تصميم الإعلان
عمليات التعداد | |
---|---|
ASSET_ROLE_UNSPECIFIED |
لم يتم تحديد دور مادة العرض أو هو غير معروف في هذا الإصدار. |
ASSET_ROLE_MAIN |
مادة العرض هي مادة العرض الرئيسية لتصميم الإعلان. |
ASSET_ROLE_BACKUP |
مادة العرض هي مادة عرض احتياطية للتصميم الإعلاني. |
ASSET_ROLE_POLITE_LOAD |
مادة العرض هي مادة عرض تحميل لتصميم الإعلان. |
ASSET_ROLE_HEADLINE |
عنوان تصميم إعلان أصلي يجب أن يكون هذا الدور متاح فقط في ما يلي من "
|
ASSET_ROLE_LONG_HEADLINE |
العنوان الطويل لتصميم إعلان أصلي يجب أن يكون لا يتوفّر هذا الدور إلّا في
|
ASSET_ROLE_BODY |
النص الأساسي لتصميم الإعلان المدمج مع المحتوى يجب أن يكون لا يتوفّر هذا الدور إلّا في
|
ASSET_ROLE_LONG_BODY |
النص الأساسي الطويل لتصميم الإعلان المدمج مع المحتوى يجب أن يكون لا يتوفّر هذا الدور إلّا في
|
ASSET_ROLE_CAPTION_URL |
نسخة قصيرة ومألوفة من عنوان URL للصفحة المقصودة سيتمّ عرضها في تصميم الإعلان. يقدّم عنوان URL هذا للمستخدِمين فكرة عن الصفحة التي سيتم توجيههم إليها بعد النقر على تصميم الإعلان. يجب أن يكون على سبيل المثال، إذا كان عنوان URL للصفحة المقصودة هو "http://www.example.com/page"، يمكن أن يكون عنوان URL للشرح هو "example.com". يكون بروتوكول HTTP:// اختياريًا، ولكن لا يمكن أن يحتوي عنوان URL على مسافات أو رموز خاصة. لا يتوفّر هذا الدور إلّا في
|
ASSET_ROLE_CALL_TO_ACTION |
النص المطلوب استخدامه على زر عبارة الحث على اتخاذ إجراء لتصميم الإعلان المدمج مع المحتوى. يجب أن يكون لا يتوفّر هذا الدور إلّا في
|
ASSET_ROLE_ADVERTISER_NAME |
النص الذي يحدّد المعلِن أو اسم العلامة التجارية يجب أن يكون لا يتوفّر هذا الدور إلّا في
|
ASSET_ROLE_PRICE |
سعر شراء تطبيقك في "متجر Google Play" أو متجر تطبيقات iOS (على سبيل المثال، 5.99 دولار أمريكي) يُرجى العلم أنّ هذه القيمة لا تتم مزامنتها تلقائيًا مع القيمة الفعلية المدرَجة في المتجر. وسيكون هذا العنوان هو العنوان المقدَّم دائمًا عند حفظ تصميم الإعلان. يجب أن يكون تكون مواد عرض هذا الدور للقراءة فقط. |
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 |
رمز تصميم إعلان لا يتوفّر هذا الدور إلّا في
|
ASSET_ROLE_COVER_IMAGE |
صورة غلاف تصميم إعلان فيديو مدمج مع المحتوى لا يتوفّر هذا الدور إلّا في
|
ExitEvent
حدث الخروج من تصميم الإعلان
تمثيل JSON |
---|
{
"type": enum ( |
الحقول | |
---|---|
type |
مطلوب. نوع حدث الخروج. |
url |
مطلوب. عنوان URL للنقرة لحدث الخروج. يكون هذا الإجراء مطلوبًا عندما يكون
|
name |
اسم علامة النقر لحدث الخروج ويجب أن يكون الاسم فريدًا ضمن تصميم إعلان واحد. اترك هذا الحقل فارغًا أو غير محدّد لتصميمات الإعلانات التي تحتوي على مواد عرض الصور فقط. |
reporting |
الاسم المستخدَم لتحديد هذا الحدث في التقارير. اترك هذا الحقل فارغًا أو غير محدّد لتصميمات الإعلانات التي تحتوي على مواد عرض الصور فقط. |
ExitEventType
نوع حدث الخروج.
عمليات التعداد | |
---|---|
EXIT_EVENT_TYPE_UNSPECIFIED |
نوع حدث الخروج غير محدّد أو غير معروف في هذا الإصدار. |
EXIT_EVENT_TYPE_DEFAULT |
حدث الخروج هو الحدث التلقائي. |
EXIT_EVENT_TYPE_BACKUP |
حدث الخروج هو حدث احتياطي للخروج. يمكن أن تكون هناك أحداث خروج احتياطية متعدّدة في تصميم الإعلان. |
TimerEvent
حدث الموقّت لتصميم الإعلان.
تمثيل JSON |
---|
{ "name": string, "reportingName": string } |
الحقول | |
---|---|
name |
مطلوب. اسم حدث الموقّت. |
reporting |
مطلوب. الاسم المستخدَم لتحديد حدث الموقّت هذا في التقارير. |
CounterEvent
حدث مضاد لتصميم الإعلان.
تمثيل JSON |
---|
{ "name": string, "reportingName": string } |
الحقول | |
---|---|
name |
مطلوب. اسم حدث العداد |
reporting |
مطلوب. الاسم المستخدَم لتحديد حدث العداد هذا في التقارير. |
AudioVideoOffset
مدة تشغيل الصوت أو الفيديو
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الربط offset قيمة العنصر المُعوض. يمكن أن يكون offset واحدًا فقط مما يلي: |
|
percentage |
المعادلة في النسبة المئوية لمدة الصوت أو الفيديو |
seconds |
الفَرق بالثواني من بداية الصوت أو الفيديو |
UniversalAdId
معرّف تصميم إعلان يقدّمه سجلّ معرّفات فريد على مستوى جميع المنصّات هذا جزء من معيار VAST 4.0.
تمثيل JSON |
---|
{
"id": string,
"registry": enum ( |
الحقول | |
---|---|
id |
المعرّف الفريد لتصميم الإعلان |
registry |
توفّر قاعدة بيانات المسجّلين معرّفات فريدة لتصميمات الإعلانات. |
UniversalAdRegistry
يقدّم السجلّ معرّفات فريدة لتصاميم الإعلانات في معرّف إعلان عالمي.
عمليات التعداد | |
---|---|
UNIVERSAL_AD_REGISTRY_UNSPECIFIED |
لم يتم تحديد "قاعدة بيانات Universal Ad" أو غير معروفة في هذا الإصدار. |
UNIVERSAL_AD_REGISTRY_OTHER |
استخدِم موفِّرًا مخصّصًا لتقديم المعرّف الإعلاني العالمي. |
UNIVERSAL_AD_REGISTRY_AD_ID |
استخدِم المعرّف الإعلاني لتقديم المعرّف الإعلاني العالمي. |
UNIVERSAL_AD_REGISTRY_CLEARCAST |
استخدم clearcast.co.uk لتقديم رقم تعريف الإعلان العام. |
UNIVERSAL_AD_REGISTRY_DV360 |
استخدِم "مساحة العرض والفيديو 360" لتقديم رقم تعريف الإعلان العالمي. |
UNIVERSAL_AD_REGISTRY_CM |
استخدِم "مدير الحملة 360" لتقديم رقم تعريف الإعلان الشامل. |
ThirdPartyUrl
تتبُّع عناوين URL من جهات خارجية لتتبُّع التفاعلات مع تصميم إعلان صوتي أو تصميم فيديو
تمثيل JSON |
---|
{
"type": enum ( |
الحقول | |
---|---|
type |
يجب أن يتم تتبع نوع التفاعل من خلال عنوان URL للتتبع |
url |
عنوان URL للتتبع المستخدَم لتتبع التفاعل. قدِّم عنوان URL يتضمّن مسارًا أو سلسلة طلب بحث اختيارية تبدأ بـ |
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 ( |
الحقول | |
---|---|
name |
اسم الملف الذي تم تحويل ترميزه |
mime |
نوع MIME للملف الذي تم تحويل ترميزه |
transcoded |
يشير هذا الحقل إلى ما إذا تم تحويل الترميز بنجاح. |
dimensions |
سمات الفيديو الذي تم تحويل ترميزه |
bit |
معدّل نقل البيانات لتحويل ترميز الفيديو الذي تم تحويل ترميزه، بالكيلوبايت في الثانية |
frame |
عدد اللقطات في الثانية للفيديو الذي تم تحويل ترميزه، وفقًا لعدد اللقطات المعروضة في الثانية |
audio |
معدل نقل البيانات للبث الصوتي للفيديو الذي تم تحويل ترميزه، أو معدل نقل البيانات للصوت الذي تم تحويل ترميزه، بالكيلوبت في الثانية |
audio |
معدّل العيّنة للبث الصوتي للفيديو الذي تم تحويل ترميزه، أو معدّل العيّنة للصوت الذي تم تحويل ترميزه بالهرتز |
file |
حجم الملف الذي تم تحويل ترميزه، بالبايت. |
CmTrackingAd
إعلان تتبُّع في "مدير الحملة 360"
تمثيل JSON |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
الحقول | |
---|---|
cm |
رقم تعريف موضع الإعلان الذي يتتبّعه "مدير الحملة 360". |
cm |
رقم تعريف تصميم الإعلان لإعلان التتبّع في "مدير الحملة 360". |
cm |
رقم تعريف الإعلان لإعلان التتبّع في "مدير الحملة 360". |
ObaIcon
رمز OBA لتصميم إعلان
تمثيل JSON |
---|
{ "resourceUrl": string, "resourceMimeType": string, "position": enum ( |
الحقول | |
---|---|
resource |
عنوان URL لمصدر رمز OBA |
resource |
نوع MIME لمورد رمز OBA |
position |
موضع رمز OBA على تصميم الإعلان |
dimensions |
أبعاد رمز OBA |
program |
برنامج رمز OBA على سبيل المثال: "خيارات الإعلانات". |
landing |
مطلوب. عنوان URL للصفحة المقصودة لرمز OBA يُسمح فقط بعناوين URL للنطاقات التالية: |
click |
مطلوب. عنوان URL لتتبُّع النقرات على رمز OBA يُسمح فقط بعناوين URL للنطاقات التالية: |
view |
مطلوب. عنوان URL لتتبُّع المشاهدة لرمز OBA يُسمح فقط بعناوين URL للنطاقات التالية: |
ObaIconPosition
موضع رمز OBA على تصميم الإعلان
عمليات التعداد | |
---|---|
OBA_ICON_POSITION_UNSPECIFIED |
لم يتم تحديد موضع رمز OBA. |
OBA_ICON_POSITION_UPPER_RIGHT |
في أعلى يسار تصميم الإعلان. |
OBA_ICON_POSITION_UPPER_LEFT |
في أعلى يمين تصميم الإعلان. |
OBA_ICON_POSITION_LOWER_RIGHT |
في أسفل يسار تصميم الإعلان |
OBA_ICON_POSITION_LOWER_LEFT |
في أسفل يمين تصميم الإعلان. |
ExpandingDirection
اتجاه التوسيع للتصميم الإعلاني القابل للتوسيع التابع لجهة خارجية
عمليات التعداد | |
---|---|
EXPANDING_DIRECTION_UNSPECIFIED |
لم يتم تحديد اتجاه التوسيع. |
EXPANDING_DIRECTION_NONE |
لا يتم توسيعها في أي اتجاه. |
EXPANDING_DIRECTION_UP |
توسيع لأعلى |
EXPANDING_DIRECTION_DOWN |
توسيع لأسفل |
EXPANDING_DIRECTION_LEFT |
توسيع لليمين |
EXPANDING_DIRECTION_RIGHT |
توسيع لليمين |
EXPANDING_DIRECTION_UP_AND_LEFT |
يتم التوسيع للأعلى وإلى اليسار. |
EXPANDING_DIRECTION_UP_AND_RIGHT |
يتم التوسيع للأعلى ولليمين. |
EXPANDING_DIRECTION_DOWN_AND_LEFT |
يتم توسيعها للأسفل وإلى اليسار. |
EXPANDING_DIRECTION_DOWN_AND_RIGHT |
توسيع لأسفل وإلى الجانب الأيمن. |
EXPANDING_DIRECTION_UP_OR_DOWN |
يتم توسيعها للأعلى أو للأسفل. |
EXPANDING_DIRECTION_LEFT_OR_RIGHT |
توسيع إلى الجانب الأيسر أو الأيمن. |
EXPANDING_DIRECTION_ANY_DIAGONAL |
يمكن توسيعها في أي اتجاه قطري. |
الطُرق |
|
---|---|
|
لإنشاء تصميم إعلان جديد. |
|
حذف تصميم إعلان. |
|
الحصول على تصميم إعلان |
|
يُدرج تصميمات الإعلانات في حساب المعلِن. |
|
تعديل تصميم إعلان حالي |