- المورد: تصميم الإعلان
- 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 عادية فقط، بدون علامات IMG أو سيناريو. لا يمكن كتابة هذا الحقل إلّا بلغة
|
jsTrackerUrl |
عنوان URL لقياس JavaScript من مقدّمي خدمات التحقُّق التابعين لجهات خارجية والمعتمَدين (ComScore وDoubleCheck وIAS وMoat). علامات نصوص HTML البرمجية غير متوافقة. لا يمكن كتابة هذا الحقل إلّا بلغة
|
cmTrackingAd |
إعلان تتبُّع "مدير الحملة 360" المرتبط بتصميم الإعلان. اختيارية للسمة
يتم عرض النتائج للحالات الأخرى فقط. |
obaIcon |
تحدّد رمز OBA لتصميم إعلان الفيديو. هذا الحقل متاح فقط في
|
thirdPartyTag |
اختياريّ. علامة الجهة الخارجية الأصلية المستخدَمة في تصميم الإعلان. مطلوبة وصالحة فقط لتصميمات علامات الجهات الخارجية. تصميمات إعلانات علامة الجهة الخارجية هي تصميمات إعلانات تتضمّن
مع
|
requireMraid |
اختياريّ. يشير إلى أن تصميم الإعلان يتطلب MRAID (نظام تعريفات واجهة إعلانات الوسائط الغنية على الأجهزة الجوّالة). اضبط هذا الخيار إذا كان تصميم الإعلان يعتمد على إيماءات الأجهزة الجوّالة للتفاعل، مثل التمرير السريع أو النقر. اختيارية وصالحة فقط لتصميمات علامات الجهات الخارجية. تصميمات إعلانات علامة الجهة الخارجية هي تصميمات إعلانات تتضمّن
مع
|
requireHtml5 |
اختياريّ. يشير إلى أن تصميم الإعلان يعتمد على HTML5 ليتم عرضه بشكل صحيح. اختيارية وصالحة فقط لتصميمات علامات الجهات الخارجية. تصميمات إعلانات علامة الجهة الخارجية هي تصميمات إعلانات تتضمّن
مع
|
requirePingForAttribution |
اختياريّ. تشير هذه السمة إلى أنّ تصميم الإعلان سينتظر إشعار عودة لتحديد المصدر. صالح فقط عند استخدام إعلان تتبُّع في "مدير الحملة 360" مع مَعلمة خادم إعلانات تابعة لجهة خارجية ووحدة ماكرو ${DC_DBM_TOKEN}. اختيارية وصالحة فقط لتصميمات علامات الجهات الخارجية أو تصميمات إعلانات علامات VAST التابعة لجهة خارجية. تصميمات إعلانات علامة الجهة الخارجية هي تصميمات إعلانات تتضمّن
مع
تصميمات إعلانات علامات VAST التابعة لجهة خارجية هي تصميمات إعلانات تتضمّن
مع
|
expandingDirection |
اختياريّ. تحدد اتجاه توسيع تصميم الإعلان. مطلوبة وصالحة فقط لتصميمات الإعلانات القابلة للتوسيع التابعة لجهات خارجية. تصميمات الإعلانات القابلة للتوسعة التابعة لجهة خارجية هي تصميمات إعلانات لها مصدر الاستضافة التالي:
مع
|
expandOnHover |
اختياريّ. تشير إلى أنّه سيتم توسيع تصميم الإعلان تلقائيًا عند التمرير فوقه. اختيارية وصالحة فقط لتصميمات الإعلانات القابلة للتوسيع التابعة لجهات خارجية. تصميمات الإعلانات القابلة للتوسعة التابعة لجهة خارجية هي تصميمات إعلانات لها مصدر الاستضافة التالي:
مع
|
vastTagUrl |
اختياريّ. عنوان URL لعلامة VAST لتصميم علامة VAST التابعة لجهة خارجية. مطلوب وصالح فقط لتصميمات علامات VAST التابعة لجهة خارجية. تصميمات إعلانات علامات VAST التابعة لجهة خارجية هي تصميمات إعلانات تتضمّن
مع
|
vpaid |
النتائج فقط. يشير إلى أن تصميم إعلان علامة VAST التابع لجهة خارجية يتطلب VPAID (واجهة إعلانات - مشغّل الفيديو الرقمي). ناتج فقط وصالح فقط لتصميمات علامات VAST التابعة لجهة خارجية. تصميمات إعلانات علامات VAST التابعة لجهة خارجية هي تصميمات إعلانات تتضمّن
مع
|
html5Video |
النتائج فقط. يشير إلى أن تصميم إعلان علامة نموذج عرض إعلانات الفيديو (VAST) التابع لجهة خارجية يتطلب دعم فيديو HTML5. ناتج فقط وصالح فقط لتصميمات علامات VAST التابعة لجهة خارجية. تصميمات إعلانات علامات 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[] |
حالات مراجعة تصميم الإعلان من خلال Exchange |
publisherReviewStatuses[] |
حالات مراجعة الناشر لتصميم الإعلان |
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
تبادل حالة مراجعة تصميم الإعلان.
تمثيل JSON |
---|
{ "exchange": enum ( |
الحقول | |
---|---|
exchange |
التبادل الذي يراجع تصميم الإعلان. |
status |
حالة مراجعة Exchange |
PublisherReviewStatus
حالة مراجعة الناشر لتصميم الإعلان
تمثيل JSON |
---|
{
"publisherName": string,
"status": enum ( |
الحقول | |
---|---|
publisherName |
تمثل هذه السمة الناشر الذي يراجع تصميم الإعلان. |
status |
حالة مراجعة الناشر |
AssetAssociation
ارتباط مادة عرض تصميم الإعلان.
تمثيل JSON |
---|
{ "asset": { object ( |
الحقول | |
---|---|
asset |
مادة العرض المرتبطة. |
role |
دور مادة العرض هذه في تصميم الإعلان. |
مادة العرض
مادة عرض واحدة.
تمثيل JSON |
---|
{ "mediaId": string, "content": string } |
الحقول | |
---|---|
mediaId |
رقم تعريف الوسائط لمادة العرض التي تم تحميلها. هذا المعرّف فريد لمادة العرض. يمكن تمرير هذا المعرّف إلى طلبات بيانات أخرى من واجهة برمجة التطبيقات، مثل تم تعديل مساحة معرّف الوسائط في 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 |
يمكن توسيعه في أي اتجاه قطري. |
الطُرق |
|
---|---|
|
يتم إنشاء تصميم إعلان جديد. |
|
حذف تصميم إعلان. |
|
أضِف لمستك الإبداعية. |
|
يُدرِج تصميمات الإعلانات في المعلِن. |
|
تعديل تصميم إعلان حالي |