يربط الجدول التالي حقول واجهة المستخدم بحقول واجهة برمجة التطبيقات المقابلة لها، مع الفصل بينها تبعًا
لنوع تصميم الإعلان. تجدر الإشارة إلى أنّ بعض حقول واجهة برمجة التطبيقات تتطلّب المزيد من التحديد من خلال تحديد دور أو نوع للمورد المقدَّم.
تصميم إعلان مصوّر عادي
نوع تصميم الإعلان: CREATIVE_TYPE_STANDARD
مصدر الاستضافة: HOSTING_SOURCE_HOSTED
الاسم
مطلوب
اسم حقل واجهة برمجة التطبيقات: displayName
ملفّ أصل المواد الإبداعية
مطلوب
اسم حقل واجهة برمجة التطبيقات: مواد العرض
دور مادة العرض: ASSET_ROLE_MAIN
عنوان URL للصفحة المقصودة
مطلوب
اسم حقل واجهة برمجة التطبيقات: exitEvents[].url
نوع الحدث عند الخروج: EXIT_EVENT_TYPE_DEFAULT
الحالة
مطلوب
اسم حقل واجهة برمجة التطبيقات: entityStatus
علامة تتبُّع HTML المُلحَقة
اختياريّ
اسم حقل واجهة برمجة التطبيقات: appendedTag
رمز الدمج
اختياريّ
اسم حقل واجهة برمجة التطبيقات: integrationCode
ملاحظات
اختياريّ
اسم حقل واجهة برمجة التطبيقات: ملاحظات
حالة التدقيق
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: reviewStatus
تصميم إعلان HTML5
نوع تصميم الإعلان: CREATIVE_TYPE_STANDARD
مصدر الاستضافة: HOSTING_SOURCE_HOSTED
الاسم
مطلوب
اسم حقل واجهة برمجة التطبيقات: displayName
ملفّ أصل المواد الإبداعية
مطلوب
اسم حقل واجهة برمجة التطبيقات: مواد العرض
دور مادة العرض: ASSET_ROLE_MAIN
الحالة
مطلوب
اسم حقل واجهة برمجة التطبيقات: entityStatus
الصور الاحتياطية
اختياريّ
اسم حقل واجهة برمجة التطبيقات: مواد العرض
دور مادة العرض: ASSET_ROLE_BACKUP
عنوان URL الاحتياطي للصفحة المقصودة
اختياريّ
اسم حقل واجهة برمجة التطبيقات: exitEvents[].url
نوع الحدث عند الخروج: EXIT_EVENT_TYPE_BACKUP
تصنيف إعداد تقارير المخرج الاحتياطي
اختياريّ
اسم حقل واجهة برمجة التطبيقات: exitEvents[].reportingName
نوع الحدث عند الخروج: EXIT_EVENT_TYPE_BACKUP
صور التحميل الإضافي
اختياريّ
اسم حقل واجهة برمجة التطبيقات: مواد العرض
دور مادة العرض: ASSET_ROLE_POLITE_LOAD
مرّات الخروج
مطلوب
اسم حقل واجهة برمجة التطبيقات: exitEvents[]
نوع الحدث عند الخروج: EXIT_EVENT_TYPE_DEFAULT
العدادات
اختياريّ
اسم حقل واجهة برمجة التطبيقات: counterEvents[]
الموقتات
اختياريّ
اسم حقل واجهة برمجة التطبيقات: timerEvents[]
علامة تتبُّع HTML المُلحَقة
اختياريّ
اسم حقل واجهة برمجة التطبيقات: appendedTag
رمز الدمج
اختياريّ
اسم حقل واجهة برمجة التطبيقات: integrationCode
ملاحظات
اختياريّ
اسم حقل واجهة برمجة التطبيقات: ملاحظات
حالة التدقيق
اختياريّ
اسم حقل واجهة برمجة التطبيقات: reviewStatus
تصميم إعلان صوري تابع لجهة خارجية
نوع تصميم الإعلان: CREATIVE_TYPE_STANDARD
مصدر الاستضافة: HOSTING_SOURCE_THIRD_PARTY
الاسم
مطلوب
اسم حقل واجهة برمجة التطبيقات: displayName
الحالة
مطلوب
اسم حقل واجهة برمجة التطبيقات: entityStatus
الأبعاد
مطلوب
اسم حقل واجهة برمجة التطبيقات: dimensions
عنوان URL للصفحة المقصودة
مطلوب
اسم حقل واجهة برمجة التطبيقات: exitEvents[].url
نوع الحدث عند الخروج: EXIT_EVENT_TYPE_DEFAULT
تتطلّب MRAID
اختياريّ
اسم حقل واجهة برمجة التطبيقات: requireMraid
تتطلب استخدام HTML5
اختياريّ
اسم حقل واجهة برمجة التطبيقات: requireHtml5
علامة جهة خارجية
مطلوب
اسم حقل واجهة برمجة التطبيقات: thirdPartyTag
تتطلّب إرسال إشعارات لتحديد المصدر
اختياريّ
اسم حقل واجهة برمجة التطبيقات: requirePingForAttribution
رمز الدمج
اختياريّ
اسم حقل واجهة برمجة التطبيقات: integrationCode
ملاحظات
اختياريّ
اسم حقل واجهة برمجة التطبيقات: ملاحظات
حالة التدقيق
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: reviewStatus
تصميم إعلان قابل للتوسيع تابع لجهة خارجية
نوع تصميم الإعلان: CREATIVE_TYPE_EXPANDABLE
مصدر الاستضافة: HOSTING_SOURCE_THIRD_PARTY
الاسم
مطلوب
اسم حقل واجهة برمجة التطبيقات: displayName
الحالة
مطلوب
اسم حقل واجهة برمجة التطبيقات: entityStatus
الأبعاد
مطلوب
اسم حقل واجهة برمجة التطبيقات: dimensions
عنوان URL للصفحة المقصودة
مطلوب
اسم حقل واجهة برمجة التطبيقات: exitEvents[].url
نوع الحدث عند الخروج: EXIT_EVENT_TYPE_DEFAULT
تتطلّب MRAID
اختياريّ
اسم حقل واجهة برمجة التطبيقات: requireMraid
تتطلب استخدام HTML5
اختياريّ
اسم حقل واجهة برمجة التطبيقات: requireHtml5
اتجاه التوسيع
مطلوب
اسم حقل واجهة برمجة التطبيقات: expandingDirection
التوسيع عند تمرير مؤشر الماوس
اختياريّ
اسم حقل واجهة برمجة التطبيقات: expandOnHover
جهة خارجية
مطلوب
اسم حقل واجهة برمجة التطبيقات: thirdPartyTag
تتطلّب إرسال إشعارات لتحديد المصدر
اختياريّ
اسم حقل واجهة برمجة التطبيقات: requirePingForAttribution
رمز الدمج
اختياريّ
اسم حقل واجهة برمجة التطبيقات: integrationCode
ملاحظات
اختياريّ
اسم حقل واجهة برمجة التطبيقات: ملاحظات
حالة التدقيق
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: reviewStatus
تصميم إعلان فيديو تابع لجهة خارجية
نوع تصميم الإعلان: CREATIVE_TYPE_VIDEO
مصدر الاستضافة: HOSTING_SOURCE_THIRD_PARTY
الاسم
مطلوب
اسم حقل واجهة برمجة التطبيقات: displayName
الحالة
مطلوب
اسم حقل واجهة برمجة التطبيقات: entityStatus
عنوان URL لعلامة نموذج عرض إعلانات الفيديو (VAST)
مطلوب
اسم حقل واجهة برمجة التطبيقات: vastTagUrl
VPAID
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: vpaid
فيديو HTML5
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: html5Video
تتطلّب إرسال إشعارات لتحديد المصدر
اختياريّ
اسم حقل واجهة برمجة التطبيقات: requirePingForAttribution
رمز الدمج
اختياريّ
اسم حقل واجهة برمجة التطبيقات: integrationCode
ملاحظات
اختياريّ
اسم حقل واجهة برمجة التطبيقات: ملاحظات
حالة التدقيق
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: reviewStatus
تصميم إعلان صوتي تابع لجهة خارجية
نوع تصميم الإعلان: CREATIVE_TYPE_AUDIO
مصدر الاستضافة: HOSTING_SOURCE_THIRD_PARTY
الاسم
مطلوب
اسم حقل واجهة برمجة التطبيقات: displayName
الحالة
مطلوب
اسم حقل واجهة برمجة التطبيقات: entityStatus
عنوان URL لعلامة نموذج عرض إعلانات الفيديو (VAST)
مطلوب
اسم حقل واجهة برمجة التطبيقات: vastTagUrl
تتطلّب إرسال إشعارات لتحديد المصدر
اختياريّ
اسم حقل واجهة برمجة التطبيقات: requirePingForAttribution
رمز الدمج
اختياريّ
اسم حقل واجهة برمجة التطبيقات: integrationCode
ملاحظات
اختياريّ
اسم حقل واجهة برمجة التطبيقات: ملاحظات
حالة التدقيق
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: reviewStatus
مبتدع فيديو
نوع تصميم الإعلان: CREATIVE_TYPE_VIDEO
مصدر الاستضافة: HOSTING_SOURCE_HOSTED
الاسم
مطلوب
اسم حقل واجهة برمجة التطبيقات: displayName
الحالة
مطلوب
اسم حقل واجهة برمجة التطبيقات: entityStatus
الملف المصدر
مطلوب
اسم حقل واجهة برمجة التطبيقات: مواد العرض
دور مادة العرض: ASSET_ROLE_MAIN
عنوان URL للصفحة المقصودة
مطلوب
اسم حقل واجهة برمجة التطبيقات: exitEvents[].url
نوع الحدث عند الخروج: EXIT_EVENT_TYPE_DEFAULT
تضمين زر التخطّي
اختياريّ
اسم حقل واجهة برمجة التطبيقات: skippable
المدة قبل ظهور زر التخطي
اختياريّ
اسم حقل واجهة برمجة التطبيقات: skipOffset
المدة قبل استحقاق التكلفة
اختياريّ
اسم حقل واجهة برمجة التطبيقات: progressOffset
رقم تعريف الإعلان العام
اختياريّ
اسم حقل واجهة برمجة التطبيقات: universalAdId
الإعلان استنادًا إلى سلوك المستخدم (OBA)
اختياريّ
اسم حقل واجهة برمجة التطبيقات: obaIcon
تصميمات الإعلانات المصاحبة
اختياريّ
اسم حقل واجهة برمجة التطبيقات: companionCreativeIds
ملف العرض
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: transcodes
عناوين URL التابعة لجهات خارجية
اختياريّ
اسم حقل واجهة برمجة التطبيقات: thirdPartyUrls
رمز الدمج
اختياريّ
اسم حقل واجهة برمجة التطبيقات: integrationCode
ملاحظات
اختياريّ
اسم حقل واجهة برمجة التطبيقات: ملاحظات
حالة التدقيق
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: reviewStatus
تصميم إعلان صوتي
نوع تصميم الإعلان: CREATIVE_TYPE_AUDIO
مصدر الاستضافة: HOSTING_SOURCE_HOSTED
الاسم
مطلوب
اسم حقل واجهة برمجة التطبيقات: displayName
الحالة
مطلوب
اسم حقل واجهة برمجة التطبيقات: entityStatus
الملف المصدر
مطلوب
اسم حقل واجهة برمجة التطبيقات: مواد العرض
دور مادة العرض: ASSET_ROLE_MAIN
عنوان URL للصفحة المقصودة
مطلوب
اسم حقل واجهة برمجة التطبيقات: exitEvents[].url
نوع الحدث عند الخروج: EXIT_EVENT_TYPE_DEFAULT
مادة العرض المصاحبة (تحميل أو تعيين)
مطلوب
اسم حقل واجهة برمجة التطبيقات: companionCreativeIds
اسم الملف المعروض
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: transcodes[].name
نوع الملف المعروض
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: transcodes[].mimeType
عرض معدل بت الصوت في الملف
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: transcodes[].audioBitRateKbps
معدل عينات الصوت في الملف الذي يتم عرضه
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: transcodes[].audioSampleRateHz
عناوين URL التابعة لجهات خارجية
اختياريّ
اسم حقل واجهة برمجة التطبيقات: thirdPartyUrls
رمز الدمج
اختياريّ
اسم حقل واجهة برمجة التطبيقات: integrationCode
ملاحظات
اختياريّ
اسم حقل واجهة برمجة التطبيقات: ملاحظات
حالة التدقيق
للقراءة فقط
اسم حقل واجهة برمجة التطبيقات: reviewStatus
تصميم إعلان صوري مدمج مع المحتوى
نوع تصميم الإعلان: CREATIVE_TYPE_NATIVE وCREATIVE_TYPE_NATIVE_SITE_SQUARE
تاريخ التعديل الأخير: 2025-04-09 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-04-09 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This document provides a comprehensive mapping of UI fields to their corresponding API fields for various creative types, including Standard Image, HTML5, Third-Party Display, Third-Party Expandable, Third-Party Video, Third-Party Audio, Video, Audio, Native Display, and Native Video."],["Each creative type has a specific set of required and optional fields, along with their API field names and any further specifications for asset roles or exit event types."],["Creative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names."],["Campaign Manager 360 tracking ad can optionally be included using the `cmTrackingAd` API field."],["This mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system."]]],[]]
