اعتبارًا من
8 سبتمبر 2025، يجب أن يحدّد كل عنصر جديد في الحملة ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على
صفحة الإيقاف النهائي لمزيد من التفاصيل حول كيفية تعديل عملية الدمج لإجراء هذا البيان.
الملحق: ربط حقول واجهة المستخدم بحقول واجهة برمجة التطبيقات حسب نوع تصميم الإعلان
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يربط الجدول التالي حقول واجهة المستخدم بحقول واجهة برمجة التطبيقات المقابلة لها، مع الفصل بينها تبعًا
لنوع تصميم الإعلان. تجدر الإشارة إلى أنّ بعض حقول واجهة برمجة التطبيقات تتطلّب المزيد من التحديد من خلال تحديد دور أو نوع للمورد المقدَّم.
تصميم إعلان مصوّر عادي
نوع تصميم الإعلان: 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 |
مصدر الاستضافة: HOSTING_SOURCE_HOSTED |
الاسم
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: displayName
|
|
status
|
مطلوب
|
اسم حقل واجهة برمجة التطبيقات: 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
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: trackingUrls[]
|
|
عنوان URL لتتبُّع مرّات الظهور 2
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: trackingUrls[]
|
|
عنوان URL للتتبّع في JavaScript
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: jsTrackerUrl
|
|
رمز الدمج
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: integrationCode
|
|
ملاحظات
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: ملاحظات
|
|
حالة التدقيق
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: 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
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: trackingUrls[]
|
|
عنوان URL لتتبُّع مرّات الظهور 2
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: trackingUrls[]
|
|
عنوان URL للتتبّع في JavaScript
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: jsTrackerUrl
|
|
رمز الدمج
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: integrationCode
|
|
ملاحظات
|
اختياريّ
|
اسم حقل واجهة برمجة التطبيقات: ملاحظات
|
|
حالة التدقيق
|
للقراءة فقط
|
اسم حقل واجهة برمجة التطبيقات: reviewStatus
|
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis 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.\u003c/p\u003e\n"],["\u003cp\u003eEach 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.\u003c/p\u003e\n"],["\u003cp\u003eCreative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names.\u003c/p\u003e\n"],["\u003cp\u003eCampaign Manager 360 tracking ad can optionally be included using the \u003ccode\u003ecmTrackingAd\u003c/code\u003e API field.\u003c/p\u003e\n"],["\u003cp\u003eThis mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system.\u003c/p\u003e\n"]]],[],null,[]]