- المورد: تصميم الإعلان
- 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 |
النتائج فقط. اسم مورد تصميم الإعلان. |
advertiserId |
النتائج فقط. رقم التعريف الفريد للمعلِن الذي ينتمي إليه تصميم الإعلان. |
creativeId |
النتائج فقط. رقم التعريف الفريد لتصميم الإعلان. تم تعيينه من قِبل النظام. |
cmPlacementId |
النتائج فقط. رقم التعريف الفريد لموضع إعلان "مدير الحملة 360" المرتبط بتصميم الإعلان. لا ينطبق هذا الحقل إلا على تصميمات الإعلانات التي تتم مزامنتها من "مدير الحملة". |
displayName |
مطلوبة. الاسم المعروض لتصميم الإعلان. يجب ترميزها باستخدام UTF-8 بحجم 240 بايت كحد أقصى. |
entityStatus |
مطلوبة. تحديد ما إذا كان يمكن عرض تصميم الإعلان أم لا. القيم المقبولة هي:
|
updateTime |
النتائج فقط. الطابع الزمني لوقت إجراء آخر تعديل على تصميم الإعلان، إمّا من قِبل المستخدم أو النظام (مثل مراجعة تصميم الإعلان). تم تعيينه من قِبل النظام. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
createTime |
النتائج فقط. الطابع الزمني عند إنشاء تصميم الإعلان. تم تعيينه من قِبل النظام. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
creativeType |
مطلوبة. غير قابل للتغيير. نوع تصميم الإعلان. |
hostingSource |
مطلوبة. يشير إلى مكان استضافة تصميم الإعلان. |
dynamic |
النتائج فقط. يشير هذا العمود إلى ما إذا كان تصميم الإعلان ديناميكيًا. |
dimensions |
مطلوبة. الأبعاد الأساسية لتصميم الإعلان. ينطبق ذلك على جميع أنواع تصميمات الإعلانات. يتم ضبط قيمة
|
additionalDimensions[] |
السمات الإضافية. يسري هذا العرض الترويجي عندما تكون السمة
في حال تحديد هذا الحقل، تكون قيمة الحقلين |
mediaDuration |
النتائج فقط. مدة الوسائط لتصميم الإعلان. يسري هذا العرض الترويجي عندما تكون السمة
مدة بالثواني يصل عددها إلى تسعة أرقام كسرية وتنتهي بـ " |
creativeAttributes[] |
النتائج فقط. قائمة بسمات تصميم الإعلان التي يُنشئها النظام. |
reviewStatus |
النتائج فقط. الحالة الراهنة لعملية مراجعة المواد الإبداعية |
assets[] |
مطلوبة. مواد العرض المرتبطة بتصميم الإعلان هذا. |
exitEvents[] |
مطلوبة. الخروج من الأحداث لتصميم الإعلان هذا. المخرج (المعروف أيضًا باسم علامة النقر) هو أي منطقة في تصميم الإعلان يمكن لشخص ما النقر عليها أو النقر عليها لفتح الصفحة المقصودة للمعلِن. يجب أن يحتوي كل تصميم إعلان على مخرج واحد على الأقل. يمكنك إضافة مخرج إلى تصميمك بأيّ من الطرق التالية:
|
timerEvents[] |
أحداث مخصّصة للمؤقّتات لتصميم إعلان وسائط متعددة تفاعلية. تتتبّع المؤقتات الوقت الذي يعرض فيه المستخدم جزءًا محددًا من تصميم إعلان الوسائط التفاعلية ويتفاعل معه. يمكن أن يشتمل تصميم الإعلان على أحداث موقِّتات متعددة، يتم ضبط كلّ منها على حدة. يمكنك ترك هذا الحقل فارغًا أو بدون ضبط لتصاميم الإعلانات التي تحتوي على مواد عرض صور فقط. |
counterEvents[] |
الفعاليات المضادة لتصميم إعلان من الوسائط التفاعلية المتقدّمة. تتتبّع العدّادات عدد المرات التي يتفاعل فيها المستخدم مع أي جزء من تصميم إعلان الوسائط التفاعلية المتقدّمة بطريقة محددة (تمرير الماوس فوقه، وتمرير الماوس خارجه، والنقرات، والنقرات، وتحميل البيانات، وإدخالات لوحة المفاتيح، وما إلى ذلك). يمكن تسجيل أي حدث يمكن تسجيله في تصميم الإعلان كعدّاد. يمكنك ترك هذا الحقل فارغًا أو بدون ضبط لتصاميم الإعلانات التي تحتوي على مواد عرض صور فقط. |
appendedTag |
علامة تتبُّع HTML التابعة لجهة خارجية التي سيتم إلحاقها بعلامة تصميم الإعلان. |
integrationCode |
معلومات المعرّف المستخدمة لربط تصميم الإعلان هذا بنظام خارجي. يجب أن يكون ترميز UTF-8 بطول لا يزيد عن 10,000 حرف. |
notes |
ملاحظات المستخدم لتصميم الإعلان هذا يجب أن يكون ترميز UTF-8 بطول لا يزيد عن 20,000 حرف. |
iasCampaignMonitoring |
يشير إلى ما إذا كانت خدمة Integral Ad Science (IAS) مفعَّلة لمراقبة الحملة. لتفعيل هذا الإعداد في تصميم الإعلان، تأكّد من ضبط |
companionCreativeIds[] |
أرقام تعريف تصميمات الإعلانات المصاحبة لتصميم فيديو. يمكنك تحديد تصاميم إعلانات صورية حالية (تتضمّن مواد عرض صور أو مواد عرض HTML5) ليتم عرضها حول مشغّل الفيديو الخاص بالناشر. تظهر الإعلانات المصاحبة المُصاحبة حول مشغّل الفيديو أثناء تشغيله، وتظل معروضة بعد انتهاء الفيديو. لا يمكن أن تكون تصميمات الإعلانات التي تحتوي على هذا الحقل متوافق فقط مع أنواع
|
skippable |
ما إذا كان يمكن للمستخدم اختيار تخطّي تصميم إعلان الفيديو هذا الحقل متاح فقط لأنواع
|
skipOffset |
مقدار الوقت المستغرَق لتشغيل الفيديو قبل ظهور زر التخطّي يجب ملء هذا الحقل عندما تكون قيمة هذا الحقل متاح فقط لأنواع
|
progressOffset |
مقدار الوقت اللازم لتشغيل الفيديو قبل احتساب عدد المشاهدات. يجب ملء هذا الحقل عندما تكون قيمة هذا الحقل متاح فقط لأنواع
|
universalAdId |
اختياريّ. معرّف اختياري لتصميم الإعلان يقدّمه قاعدة بيانات المسجّلين ويكون فريدًا في جميع المنصات يشكّل معرّف الإعلان العالمي جزءًا من معيار "نموذج عرض إعلانات فيديو" 4.0. ويمكن تعديله بعد إنشاء تصميم الإعلان. هذا الحقل متاح فقط لأنواع
|
thirdPartyUrls[] |
تتبُّع عناوين URL من جهات خارجية لتتبُّع التفاعلات مع تصميم إعلان الفيديو هذا الحقل متاح فقط لأنواع
|
transcodes[] |
النتائج فقط. عمليات تحويل ترميز الصوت/الفيديو تحوّل "مساحة العرض والفيديو 360" ترميز مادة العرض الرئيسية إلى عدد من الإصدارات البديلة التي تستخدم تنسيقات ملفات مختلفة أو لها خصائص مختلفة (درجة الدقة ومعدل نقل بيانات الصوت ومعدّل نقل بيانات الفيديو)، ويتم تصميم كل منها لمشغّلات فيديو أو معدّلات نقل بيانات معيّنة. وتمنح هذه الرموز لنظام الناشر مزيدًا من الخيارات للاختيار من بينها لكل مرة ظهور على الفيديو وتضمن عرض الملف المناسب استنادًا إلى اتصال المشاهد وحجم الشاشة. لا يتوفّر هذا الحقل إلا في أنواع
|
trackerUrls[] |
تتبُّع عناوين URL لمزوّدي خدمة التحليلات أو مورّدي تقنية الإعلان التابعين لجهات خارجية يجب أن تبدأ عناوين URL ببروتوكول https (باستثناء المستودع الذي لا يتطلب التوافق مع طبقة المقابس الآمنة). في حال استخدام وحدات ماكرو في عنوان URL، استخدِم فقط وحدات الماكرو المتوافقة مع "مساحة العرض والفيديو 360". عناوين URL القياسية فقط، بدون علامات {8} أو سيناريو. لا يمكن كتابة هذا الحقل إلا بلغة
|
jsTrackerUrl |
عنوان URL لقياس JavaScript من مزوِّدي التحقق التابعين لجهات خارجية والمعتمَدين (ComScore وDoubleCheck وIAS وMoat). علامات نص HTML البرمجي غير متوافقة. لا يمكن كتابة هذا الحقل إلا بلغة
|
cmTrackingAd |
إعلان تتبُّع "مدير الحملة 360" المرتبط بتصميم الإعلان. اختيارية لحملة
النتائج للحالات الأخرى فقط. |
obaIcon |
تحدّد رمز OBA لتصميم إعلان الفيديو. لا يتوفّر هذا الحقل إلا في أنواع
|
thirdPartyTag |
اختياريّ. العلامة الأصلية للجهة الخارجية المستخدَمة في تصميم الإعلان. مطلوبة وصالحة فقط لتصميمات علامات الجهات الخارجية. تصميمات إعلانات علامة الجهة الخارجية هي تصميمات إعلانات تستخدم
بالإضافة إلى
|
requireMraid |
اختياريّ. يشير إلى أن تصميم الإعلان يتطلب MRAID (نظام تعريفات واجهة إعلانات الوسائط المتعددة التفاعلية على الأجهزة الجوّالة). اضبط هذا الخيار إذا كان تصميم الإعلان يعتمد على إيماءات الأجهزة الجوّالة للتفاعل، مثل التمرير السريع أو النقر. اختيارية وصالحة فقط لتصميمات علامات الجهات الخارجية. تصميمات إعلانات علامة الجهة الخارجية هي تصميمات إعلانات تستخدم
بالإضافة إلى
|
requireHtml5 |
اختياريّ. يشير إلى أن تصميم الإعلان يعتمد على HTML5 ليتم عرضه بشكل صحيح. اختيارية وصالحة فقط لتصميمات علامات الجهات الخارجية. تصميمات إعلانات علامة الجهة الخارجية هي تصميمات إعلانات تستخدم
بالإضافة إلى
|
requirePingForAttribution |
اختياريّ. تشير هذه القيمة إلى أنّ تصميم الإعلان سينتظر إرسال إشعار للإرجاع لتحديد مصدر الإحالة. صالح فقط عند استخدام إعلان تتبع "مدير الحملة 360" مع معلمة خادم إعلانات جهة خارجية ووحدة الماكرو ${DC_DBM_TOKEN}. اختيارية وصالحة فقط لتصميمات علامات الجهات الخارجية أو تصميمات إعلانات علامات VAST التابعة لجهة خارجية. تصميمات إعلانات علامة الجهة الخارجية هي تصميمات إعلانات تستخدم
بالإضافة إلى
تصميمات إعلانات علامات نموذج عرض إعلانات الفيديو التابعة لجهة خارجية هي مواد إبداعية تتضمّن
بالإضافة إلى
|
expandingDirection |
اختياريّ. تحدد اتجاه توسيع تصميم الإعلان. مطلوبة وصالحة فقط لتصميمات الإعلانات القابلة للتوسيع التابعة لجهات خارجية. تصميمات الإعلانات القابلة للتوسعة التابعة لجهة خارجية هي تصميمات إعلانات لها مصدر الاستضافة التالي:
بالإضافة إلى
|
expandOnHover |
اختياريّ. يشير إلى أن تصميم الإعلان سيتم توسيعه تلقائيًا عند التمرير فوقه. اختيارية وصالحة فقط لتصميمات الإعلانات القابلة للتوسيع التابعة لجهات خارجية. تصميمات الإعلانات القابلة للتوسعة التابعة لجهة خارجية هي تصميمات إعلانات لها مصدر الاستضافة التالي:
بالإضافة إلى
|
vastTagUrl |
اختياريّ. عنوان URL لعلامة VAST لتصميم علامة VAST التابعة لجهة خارجية. مطلوبة وصالحة فقط لتصميمات علامات VAST التابعة لجهات خارجية. تصميمات إعلانات علامات نموذج عرض إعلانات الفيديو التابعة لجهة خارجية هي مواد إبداعية تتضمّن
بالإضافة إلى
|
vpaid |
النتائج فقط. يشير إلى أن تصميم إعلان علامة نموذج عرض إعلانات الفيديو (VAST) التابع لجهة خارجية يتطلب معيار VPAID (واجهة إعلان-مشغّل الفيديو الرقمي). النتائج فقط صالحة فقط لتصميمات علامات نموذج عرض إعلانات الفيديو (VAST) التابعة لجهات خارجية. تصميمات إعلانات علامات نموذج عرض إعلانات الفيديو التابعة لجهة خارجية هي مواد إبداعية تتضمّن
بالإضافة إلى
|
html5Video |
النتائج فقط. يشير إلى أن تصميم إعلان علامة نموذج عرض إعلانات الفيديو (VAST) التابع لجهة خارجية يتطلب دعم فيديو HTML5. النتائج فقط صالحة فقط لتصميمات علامات نموذج عرض إعلانات الفيديو (VAST) التابعة لجهات خارجية. تصميمات إعلانات علامات نموذج عرض إعلانات الفيديو التابعة لجهة خارجية هي مواد إبداعية تتضمّن
بالإضافة إلى
|
lineItemIds[] |
النتائج فقط. أرقام تعريف العناصر المرتبطة بتصميم الإعلان هذا. ولربط تصميم إعلان بعنصر، استخدِم |
mp3Audio |
النتائج فقط. يشير إلى توافق تصميم الإعلان الصوتي التابع لجهة خارجية مع MP3. النتائج فقط صالحة للتصاميم الصوتية التابعة لجهات خارجية فقط. تصميمات الإعلانات الصوتية التابعة لجهة خارجية هي تصميمات إعلانات تتضمّن
بالإضافة إلى
|
oggAudio |
النتائج فقط. يشير هذا الرمز إلى أنّ تصميم الإعلان الصوتي التابع لجهة خارجية متوافق مع OGG. النتائج فقط صالحة للتصاميم الصوتية التابعة لجهات خارجية فقط. تصميمات الإعلانات الصوتية التابعة لجهة خارجية هي تصميمات إعلانات تتضمّن
بالإضافة إلى
|
HostingSource
مصادر الاستضافة المحتملة لتصميم الإعلان يشير إلى مكان إنشاء تصميم الإعلان واستضافته.
عمليات التعداد | |
---|---|
HOSTING_SOURCE_UNSPECIFIED |
لم يتم تحديد مصدر الاستضافة أو غير معروف في هذا الإصدار. |
HOSTING_SOURCE_CM |
تصميم إعلان تمت مزامنته من "مدير الحملة 360". إنّ طرق الإنشاء والتعديل غير متوافقة مع نوع الاستضافة هذا. |
HOSTING_SOURCE_THIRD_PARTY |
تصميم إعلان يستضيفه خادم إعلانات تابع لجهة خارجية (3PAS). تتوفّر طرق الإنشاء والتعديل لنوع الاستضافة هذا إذا كانت قيمة
|
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 ( |
الحقول | |
---|---|
approvalStatus |
يمثل الموافقة الأساسية اللازمة لبدء عرض تصميم الإعلان. ملخّص عن |
creativeAndLandingPageReviewStatus |
حالة مراجعة تصميم الإعلان والصفحة المقصودة لتصميم الإعلان. |
contentAndPolicyReviewStatus |
حالة مراجعة المحتوى والسياسات لتصميم الإعلان |
exchangeReviewStatuses[] |
تبادل حالات مراجعة تصميم الإعلان. |
publisherReviewStatuses[] |
حالات مراجعة الناشر لتصميم الإعلان تحذير: سيتم إيقاف هذا الحقل نهائيًا في 26 حزيران (يونيو) 2024. بعد هذا التاريخ، سيكون هذا الحقل فارغًا. يمكنك الاطّلاع على الإشعار عن إيقاف الميزات نهائيًا للحصول على مزيد من المعلومات. |
ApprovalStatus
الأنواع المحتملة من حالات الموافقة إنّه ملخّص 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 ( |
الحقول | |
---|---|
publisherName |
الناشر الذي يراجع تصميم الإعلان. |
status |
حالة مراجعة الناشر |
AssetAssociation
ارتباط مادة العرض لتصميم الإعلان.
تمثيل JSON |
---|
{ "asset": { object ( |
الحقول | |
---|---|
asset |
مادة العرض المرتبطة |
role |
دور مادة العرض هذه في تصميم الإعلان. |
مادة العرض
مادة عرض واحدة
تمثيل JSON |
---|
{ "mediaId": string, "content": string } |
الحقول | |
---|---|
mediaId |
رقم تعريف الوسائط لمادة العرض التي تم تحميلها. هذا الرقم هو معرّف فريد لمادة العرض. يمكن تمرير رقم التعريف هذا إلى طلبات بيانات أخرى من واجهة برمجة التطبيقات، مثل تم تعديل مساحة Media ID في 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 |
اسم علامة النقر لحدث الخروج. يجب أن يكون الاسم فريدًا في تصميم إعلان واحد. يمكنك ترك هذا الحقل فارغًا أو بدون ضبط لتصاميم الإعلانات التي تحتوي على مواد عرض صور فقط. |
reportingName |
الاسم المستخدَم لتحديد هذا الحدث في التقارير. يمكنك ترك هذا الحقل فارغًا أو بدون ضبط لتصاميم الإعلانات التي تحتوي على مواد عرض صور فقط. |
ExitEventType
نوع حدث الخروج.
عمليات التعداد | |
---|---|
EXIT_EVENT_TYPE_UNSPECIFIED |
نوع حدث الخروج غير محدّد أو غير معروف في هذا الإصدار. |
EXIT_EVENT_TYPE_DEFAULT |
حدث الخروج هو الحدث التلقائي. |
EXIT_EVENT_TYPE_BACKUP |
حدث الخروج هو حدث خروج احتياطي. قد تكون هناك عدة أحداث خروج احتياطية في تصميم إعلان. |
TimerEvent
حدث الموقّت لتصميم الإعلان.
تمثيل JSON |
---|
{ "name": string, "reportingName": string } |
الحقول | |
---|---|
name |
مطلوبة. اسم حدث الموقّت. |
reportingName |
مطلوبة. الاسم المستخدَم لتحديد حدث الموقّت هذا في التقارير. |
CounterEvent
الحدث المضاد لتصميم الإعلان.
تمثيل JSON |
---|
{ "name": string, "reportingName": string } |
الحقول | |
---|---|
name |
مطلوبة. اسم الحدث المضاد |
reportingName |
مطلوبة. الاسم المستخدَم لتحديد هذا الحدث المضاد في التقارير |
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_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 |
اسم الملف الذي تم تحويل ترميزه |
mimeType |
تمثّل هذه السمة نوع MIME للملف الذي تم تحويل ترميزه. |
transcoded |
يشير إلى ما إذا كان تحويل الترميز قد تم بنجاح. |
dimensions |
أبعاد الفيديو الذي تم تحويل ترميزه. |
bitRateKbps |
معدّل نقل بيانات تحويل الترميز للفيديو الذي تم تحويل ترميزه بالكيلوبت في الثانية |
frameRate |
عدد اللقطات في الثانية للفيديو الذي تم تحويل ترميزه، باللقطات في الثانية. |
audioBitRateKbps |
معدّل نقل البيانات للبث الصوتي للفيديو الذي تم تحويل ترميزه، أو معدّل نقل بيانات الصوت الذي تم تحويل ترميزه، بالكيلوبت في الثانية. |
audioSampleRateHz |
معدّل البيانات في الملف الصوتي للبث الصوتي للفيديو الذي تم تحويل ترميزه، أو معدّل العيّنة للصوت الذي تم تحويل ترميزه، بالهرتز |
fileSizeBytes |
تمثّل هذه السمة حجم الملف الذي تم تحويل ترميزه بالبايت. |
CmTrackingAd
إعلان تتبُّع في "مدير الحملة 360".
تمثيل JSON |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
الحقول | |
---|---|
cmPlacementId |
رقم تعريف موضع إعلان تتبع "مدير الحملة 360". |
cmCreativeId |
رقم تعريف تصميم الإعلان لإعلان التتبُّع في "مدير الحملة 360". |
cmAdId |
رقم تعريف إعلان التتبّع 360 في "مدير الحملة". |
ObaIcon
رمز OBA لتصاميم الإعلانات
تمثيل JSON |
---|
{ "resourceUrl": string, "resourceMimeType": string, "position": enum ( |
الحقول | |
---|---|
resourceUrl |
تمثّل هذه السمة عنوان URL لمورد رمز OBA. |
resourceMimeType |
تمثّل هذه السمة نوع MIME لمورد رمز OBA. |
position |
تمثّل هذه السمة موضع رمز OBA في تصميم الإعلان. |
dimensions |
تمثّل هذه السمة أبعاد رمز OBA. |
program |
برنامج رمز OBA. على سبيل المثال: "خيارات الإعلان". |
landingPageUrl |
مطلوبة. تمثّل هذه السمة عنوان URL للصفحة المقصودة لرمز OBA. يُسمح فقط بعناوين URL للنطاقات التالية: |
clickTrackingUrl |
مطلوبة. عنوان URL لتتبُّع النقرات لرمز OBA. يُسمح فقط بعناوين URL للنطاقات التالية: |
viewTrackingUrl |
مطلوبة. عنوان 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 |
يمكن توسيعه في أي اتجاه قُطري. |
الطُرق |
|
---|---|
|
تنشئ تصميم إعلان جديدًا. |
|
لحذف تصميم إعلان. |
|
إبداع بلا حدود. |
|
يسرد تصميمات الإعلانات في أحد المعلنين. |
|
تعديل تصميم إعلان حالي |