الملحق: ربط حقول واجهة المستخدم بحقول واجهة برمجة التطبيقات حسب نوع تصميم الإعلان
يربط الجدول أدناه حقول واجهة المستخدم بحقول واجهة برمجة التطبيقات المقابلة، مفصولةً حسب نوع تصميم الإعلان. لاحظ أن بعض حقول واجهة برمجة التطبيقات تتطلب مزيدًا من المواصفات من خلال الدور أو نوع تعيين المورد المقدّم.
تصميم إعلان الصورة العادية
نوع تصميم الإعلان: CREATIVE_TYPE_STANDARD |
مصدر الاستضافة: HOSTING_SOURCE_HOSTED |
الاسم
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: displayName
|
|
ملف أصل المواد الإبداعية
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_MAIN
|
|
عنوان URL للصفحة المقصودة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: exitEvents[].url
|
الخروج من نوع الحدث: EXIT_EVENT_TYPE_DEFAULT
|
|
الحالة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: entityStatus
|
|
علامة تتبع HTML ملحقة
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: appendedTag
|
|
رمز الدمج
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: integrationCode
|
|
Notes
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: ملاحظات
|
|
حالة التدقيق
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: 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[]
|
|
ضبط الموقّتات
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات:TIMEEvents[]
|
|
علامة تتبع HTML ملحقة
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: appendedTag
|
|
رمز الدمج
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: integrationCode
|
|
Notes
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: ملاحظات
|
|
حالة التدقيق
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: ReviewStatus
|
|
تصميم إعلان الشبكة الإعلانية لجهة خارجية
نوع تصميم الإعلان: CREATIVE_TYPE_STANDARD |
مصدر الاستضافة: HOSTING_SOURCE_3_PARTY |
الاسم
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: displayName
|
|
الحالة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: entityStatus
|
|
الأبعاد
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: السمات
|
|
عنوان URL للصفحة المقصودة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: exitEvents[].url
|
الخروج من نوع الحدث: EXIT_EVENT_TYPE_DEFAULT
|
|
يتطلب MRAID
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: يتطلب Mraid
|
|
يجب استخدام HTML5
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: requestHtml5
|
|
علامة جهة خارجية
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات:rdPartyTag
|
|
مطلوب إرسال إشعار لتحديد المصدر
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: requestPingForAttribution
|
|
رمز الدمج
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: integrationCode
|
|
Notes
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: ملاحظات
|
|
حالة التدقيق
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: ReviewStatus
|
|
تصميم إعلان جهة خارجية قابل للتوسيع
نوع تصميم الإعلان: CREATIVE_TYPE_EXPANDABLE |
مصدر الاستضافة: HOSTING_SOURCE_3_PARTY |
الاسم
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: displayName
|
|
الحالة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: entityStatus
|
|
الأبعاد
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: السمات
|
|
عنوان URL للصفحة المقصودة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: exitEvents[].url
|
الخروج من نوع الحدث: EXIT_EVENT_TYPE_DEFAULT
|
|
يتطلب MRAID
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: يتطلب Mraid
|
|
يجب استخدام HTML5
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: requestHtml5
|
|
توسيع الاتجاه
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: expandDirection
|
|
التوسيع عند التمرير
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: expandOnHover
|
|
الطرف الثالث
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات:rdPartyTag
|
|
مطلوب إرسال إشعار لتحديد المصدر
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: requestPingForAttribution
|
|
رمز الدمج
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: integrationCode
|
|
Notes
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: ملاحظات
|
|
حالة التدقيق
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: ReviewStatus
|
|
تصميم إعلان فيديو تابع لجهة خارجية
نوع تصميم الإعلان: CREATIVE_TYPE_VIDEO |
مصدر الاستضافة: HOSTING_SOURCE_3_PARTY |
الاسم
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: displayName
|
|
الحالة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: entityStatus
|
|
عنوان URL لعلامة نموذج عرض إعلانات فيديو (VAST)
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات:FastTagUrl
|
|
VPAID
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: vpaid
|
|
فيديو HTML5
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: html5Video
|
|
مطلوب إرسال إشعار لتحديد المصدر
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: requestPingForAttribution
|
|
رمز الدمج
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: integrationCode
|
|
Notes
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: ملاحظات
|
|
حالة التدقيق
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: ReviewStatus
|
|
تصميم إعلان صوتي لجهة خارجية
نوع تصميم الإعلان: CREATIVE_TYPE_AUDIO |
مصدر الاستضافة: HOSTING_SOURCE_3_PARTY |
الاسم
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: displayName
|
|
الحالة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: entityStatus
|
|
عنوان URL لعلامة نموذج عرض إعلانات فيديو (VAST)
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات:FastTagUrl
|
|
مطلوب إرسال إشعار لتحديد المصدر
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: requestPingForAttribution
|
|
رمز الدمج
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: integrationCode
|
|
Notes
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: ملاحظات
|
|
حالة التدقيق
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: ReviewStatus
|
|
تصميم إعلان الفيديو
نوع تصميم الإعلان: CREATIVE_TYPE_VIDEO |
مصدر الاستضافة: HOSTING_SOURCE_HOSTED |
الاسم
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: displayName
|
|
الحالة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: entityStatus
|
|
ملف المصدر
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_MAIN
|
|
عنوان URL للصفحة المقصودة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: exitEvents[].url
|
الخروج من نوع الحدث: EXIT_EVENT_TYPE_DEFAULT
|
|
تضمين زر التخطّي
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: قابل للتخطي
|
|
المدة قبل ظهور زر التخطي
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: traceOffset
|
|
المدة قبل استحقاق التكلفة
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: إزاحة التقدم
|
|
رقم تعريف الإعلان العام
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: universalAdId
|
|
الإعلان استنادًا إلى سلوك المستخدم (OBA)
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: obaIcon
|
|
تصميمات الإعلانات المصاحبة
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: أرقام تعريف الإعلانات المصاحبة
|
|
عرض الملف
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: تحويلات الرموز
|
|
عناوين URL التابعة لجهات خارجية
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات:rdPartyUrls
|
|
رمز الدمج
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: integrationCode
|
|
Notes
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: ملاحظات
|
|
حالة التدقيق
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: ReviewStatus
|
|
تصميم الإعلان الصوتي
نوع تصميم الإعلان: CREATIVE_TYPE_AUDIO |
مصدر الاستضافة: HOSTING_SOURCE_HOSTED |
الاسم
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: displayName
|
|
الحالة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: entityStatus
|
|
ملف المصدر
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_MAIN
|
|
عنوان URL للصفحة المقصودة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: exitEvents[].url
|
الخروج من نوع الحدث: EXIT_EVENT_TYPE_DEFAULT
|
|
مادة عرض مصاحبة (تحميل أو تعيين)
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: أرقام تعريف الإعلانات المصاحبة
|
|
اسم ملف العرض
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: تحويل الترميز [].name
|
|
نوع ملف العرض
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: Transcodes[].mimeType
|
|
معدل البت لصوت ملف العرض
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: Transcodes[].audioBitRateKbps
|
|
معدل عينة الصوت لملف العرض
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: Transcodes[].audioSampleRateHz
|
|
عناوين URL التابعة لجهات خارجية
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات:rdPartyUrls
|
|
رمز الدمج
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: integrationCode
|
|
Notes
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: ملاحظات
|
|
حالة التدقيق
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: ReviewStatus
|
|
تصميم الإعلان على الشبكة الإعلانية المدمجة مع المحتوى
نوع تصميم الإعلان: CREATIVE_TYPE_NATIVE، CREATIVE_TYPE_NATIVE_SITE_DOMAIN |
مصدر الاستضافة: HOSTING_SOURCE_HOSTED |
الاسم
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: displayName
|
|
الحالة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: entityStatus
|
|
Logo
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_ICON
|
|
صورة / صورة مربّعة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_MAIN
|
|
العنوان
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_HEADLINE
|
|
العنوان الطويل
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_long_HEADLINE
|
|
النص الأساسي
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_Body
|
|
النص الأساسي الطويل
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_long_body
|
|
عنوان URL للصفحة المقصودة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: exitEvents[].url
|
الخروج من نوع الحدث: EXIT_EVENT_TYPE_DEFAULT
|
|
عنوان URL للشرح
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_CAPTION_URL
|
|
الحث على اتخاذ إجراء
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_CALL_TO_ACTION
|
|
إعلان تتبُّع "مدير الحملة 360"
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: cmTrackingAd
|
|
عنوان URL لتتبع مرات الظهور 1
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: عناوين URL للتتبّع[]
|
|
عنوان URL لتتبع مرات الظهور 2
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: عناوين URL للتتبّع[]
|
|
عنوان URL للتتبُّع باستخدام JavaScript
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: jsTrackerUrl
|
|
رمز الدمج
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: integrationCode
|
|
Notes
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: ملاحظات
|
|
حالة التدقيق
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: ReviewStatus
|
|
تصميم إعلان فيديو مدمج مع المحتوى
نوع تصميم الإعلان: CREATIVE_TYPE_NATIVE_VIDEO |
مصدر الاستضافة: HOSTING_SOURCE_HOSTED |
الاسم
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: displayName
|
|
الحالة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: entityStatus
|
|
Logo
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_ICON
|
|
حملة فيديو
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_MAIN
|
|
صورة الغلاف
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_COVER_IMAGE
|
|
اسم المُعلِن
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_ADVERTISER_NAME
|
|
العنوان
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_HEADLINE
|
|
العنوان الطويل
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_long_HEADLINE
|
|
النص الأساسي
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_Body
|
|
النص الأساسي الطويل
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_long_body
|
|
عنوان URL للصفحة المقصودة
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: exitEvents[].url
|
الخروج من نوع الحدث: EXIT_EVENT_TYPE_DEFAULT
|
|
عنوان URL للشرح
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_CAPTION_URL
|
|
الحث على اتخاذ إجراء
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: مواد العرض
|
دور مادة العرض: ASSET_role_CALL_TO_ACTION
|
|
عنوان URL لتتبع مرات الظهور 1
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: عناوين URL للتتبّع[]
|
|
عنوان URL لتتبع مرات الظهور 2
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: عناوين URL للتتبّع[]
|
|
عنوان URL للتتبُّع باستخدام JavaScript
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: jsTrackerUrl
|
|
رمز الدمج
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: integrationCode
|
|
Notes
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: ملاحظات
|
|
حالة التدقيق
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: ReviewStatus
|
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2023-12-01 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2023-12-01 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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."]]],[]]