تقدّم هذه الصفحة معلومات عامة عن توافق حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA) من جهة العميل في HTML5 مع المتصفحات وتنسيقات الفيديو والمنصات.
تنسيقات الفيديو والمتصفحات المتوافقة
يختلف توفّر الميزات المتنوعة بين المتصفحات، ولا يوجد تنسيق فيديو تلقائي واحد متوافق مع جميع المتصفحات الرئيسية. تنسيقات الفيديو الثلاثة الرئيسية المستخدمة في غالبية المتصفحات هي H.264 وWebM وOgg Theora.
مشغّلات الفيديو المتوافقة
تتوافق معظم ميزات IMA مع مشغّلات فيديو HTML5 العادية، بما في ذلك علامة HTML
<video>. يمكنك الاطّلاع على برنامج شركاء تكنولوجيا الفيديو للحصول على قائمة بمشغّلات الفيديو المعروفة التي تتيح استخدام حزمة تطوير البرامج للإعلانات التفاعلية.
التوافق مع أحداث VAST
يسرد هذا القسم أحداث VAST التي يتم إبلاغ الخادم بها تلقائيًا استنادًا إلى المعلومات التي يتم عرضها في استجابة VAST.
متوافقة بالكامل
complete وcreativeView وfirstQuartile وimpression وmidpoint وpause وresume وrewind (يتم تشغيلها عند حدوث أي تقديم أو ترجيع كبير في الاتجاه الخلفي) وstart وthirdQuartile
جهاز متوافق جزئيًا
clickلا يتم إرسال الحدث
Clickإلا لإعلانات الفيديو. لا يمكن تسجيل النقرات على مشغّلات ملء الشاشة المدمجة على أجهزة Android أو iOS أو أجهزة الكمبيوتر المكتبي، ولكن يمكن تسجيل النقرات من خلال عنصر تتبُّع النقرات في الصفحة عند إغلاق الفيديو. ومع ذلك، إذا كان عنصر الفيديو يستخدم عناصر تحكّم أصلية على iPad، لا يمكن تسجيل النقرات.fullscreen
تتوافق حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK) مع وضع ملء الشاشة المُحاكَى، حيث يشغل الفيديو نافذة المتصفّح بالكامل. نعتبر أنّ الفيديو في وضع ملء الشاشة عندما يكون
offsetWidthوoffsetHeightبحجم نص المستند على الأقل. يتوافق هذا الوضع مع جميع المتصفّحات. للاطّلاع على مثال على وضع ملء الشاشة المحاكي، نزِّل النموذج.على أجهزة iPhone وأنظمة Android الأساسية التي تسبق الإصدار 3.0، سيتم تشغيل الفيديو دائمًا في وضع ملء الشاشة.
mute،unmuteيوفّر نظاما التشغيل iOS وAndroid فقط إمكانية التحكّم في مستوى الصوت بشكل أصلي. وبالتالي، لا يمكن لـ "حزمة تطوير البرامج للإعلانات التفاعلية" (IMA SDK) تحديد مستوى الصوت أو حالة كتم الصوت، ولا يتم إعلامنا بالتغييرات. في ما يلي قائمة بإصدارات المتصفّحات التي تتوافق والتي لا تتوافق مع
mute،unmute:- المتصفحات المتوافقة: Firefox 3.5 والإصدارات الأحدث وChrome 8 والإصدارات الأحدث وSafari 4 والإصدارات الأحدث
- غير متوافق مع: iOS وAndroid
لمزيد من التفاصيل حول عرض إعلانات VAST، يُرجى الرجوع إلى إرشادات IAB.
تحذيرات بشأن أُطر عمل JavaScript
هناك اعتبارات معيّنة عند استخدام إطار عمل JavaScript، مثل React أو AngularJS، مع حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية (IMA) في HTML5. غالبًا ما تنقل أُطر العمل هذه عناصر DOM، ما قد يؤدي إلى تعطُّل وظائف IMA لأنّ IMA يتوقّع أن يكون DOM ثابتًا عند بدء حزمة تطوير البرامج (SDK). تتوافق "حزمة تطوير البرامج للإعلانات التفاعلية" مع أُطر عمل JavaScript طالما أنّه يتم بدء الحزمة بعد انتهاء إطار العمل من نقل عناصر DOM. على وجه التحديد، يجب عدم نقل عنصر HTML5 الذي تم تمريره كوسيطة containerElement عند إنشاء AdDisplayContainer بعد إنشاء مثيل له.
منصات مشغّلات الفيديو المتوافقة
تتوفّر حزم تطوير البرامج (SDK) للإعلانات التفاعلية (IMA) من Google على المنصات التالية:
| المنصة | الإصدار | نوع الإعلان |
|---|---|---|
| HTML5 | أجهزة الكمبيوتر المكتبية: Chrome وFirefox وSafari وEdge وOpera الأجهزة الجوّالة: Chrome/متصفّح Android (أجهزة Android للهواتف والأجهزة اللوحية) وSafari وChrome (أجهزة iOS) |
إعلانات الفيديو الخطية والإعلانات الصورية الخطية والإعلانات غير الخطية والإعلانات المصاحبة وحلول الفيديو في "مدير الإعلانات" وفيديو Ad Exchange وإعلانات AFV |
| iOS | الإصدار 10.0 من نظام التشغيل iOS أو إصدار أحدث | "الإعلانات المصاحبة" و"الإعلانات المتسلسلة" و"إعلانات الفيديو في Ad Manager" و"إعلانات الفيديو في Ad Exchange" و"إعلانات AdSense للفيديو" |
| Android | Android 4.4 والإصدارات الأحدث | "الإعلانات المصاحبة" و"الإعلانات المتسلسلة" و"إعلانات الفيديو في Ad Manager" و"إعلانات الفيديو في Ad Exchange" و"إعلانات AdSense للفيديو" |
| tvOS | الإصدار 15 من نظام التشغيل tvOS أو إصدار أحدث | الإعلانات الخطية وفيديو "مدير إعلانات Google" وفيديو Ad Exchange |
ميزات الفيديو وإصدارات حِزم تطوير البرامج (SDK)
لمزيد من المعلومات عن الميزات التالية، يُرجى الاطّلاع على نظرة عامة على الإعلانات عبر الفيديو.
| HTML5 v3 | الإصدار 3 من iOS | الإصدار 3 من Android | tvOS | |
|---|---|---|---|---|
| حزمة فيديو IAB | ||||
| VAST 4 |  9 |
9 |
9 |
9 |
| VAST 3 |  |
1 |
1 |
1 |
| VAST 2 | |
|
|
|
| SIMID 1.0 | |
|
|
 |
| VPAID 2 (HTML5) | |
|
|
|
| الإصدار 1.0.1 من VMAP | 2 3 |
2 |
2 |
2 |
| الإصدار 1.3 من حزمة تطوير البرامج (SDK) لخدمة Open Measurement | |
|
|
|
| ميزات الفيديو في "مدير إعلانات Google" | ||||
| الإعلانات الخطية | |
|
|
|
| الإعلانات الصورية الخطية |
|
|
|
|
| مواد العرض المستضافة على YouTube | 4 |
|
|
|
| الإعلانات غير الخطية (الإعلانات التي تظهر على سطح الفيديو) | 5 |
|
|
|
| الإعلانات المُصاحبة | |
|
|
|
| موارد الإعلانات المصاحبة البديلة في الإصدار 3 من نموذج عرض إعلانات الفيديو (VAST) | |
|
|
|
| إمكانية العرض في "العرض النشط" | |
|
|
|
| إعلانات صوتية | |
|
|
|
| عمليات إعادة توجيه VAST | |
|
|
|
| استبدال الإعلان المصاحب بطلب إعلان صوري | |
|
|
|
| توافق علامة "ناشر Google" (GPT) | |
|
|
|
| الوعي بالمحتوى | |
|
|
|
| قواعد الإعلانات | 3 |
|
|
|
| الفواصل الإعلانية اليدوية في قواعد الإعلانات |
|
|
|
|
| تحديد عدد مرّات الظهور 6 | |
|
|
|
| منع إعلانات المنافسين (البث) | |
|
|
|
| منع إعلانات المنافسين (المجموعة الإعلانية) | |
|
|
|
| منع إعلانات المنافسين (الصفحة بأكملها) | |
|
|
|
| بودكاست | 3 |
|
|
|
| ملصقات صغيرة | |
|
|
|
| إعداد تقارير حول ميزة "تتبُّع الأحداث المتعدّدة" | |
|
|
|
| التخصيص الديناميكي ("AdSense للفيديو" و"Ad Exchange في مدير الإعلانات") | |
|
|
|
| إعلانات قابلة للتخطّي (ليست من TrueView) 8 | 5 |
|
|
|
| InStream Select | |
|
|
|
| التحميل المُسبَق لمواد العرض | 7 |
|
|
|
| ميزات "AdSense للفيديو" | ||||
| TrueView InStream | 5 |
|
|
|
| InStream Select | |
|
|
|
| إعلانات عادية أثناء عرض الفيديو | |
|
|
|
| الخانة الكاملة | |
|
|
|
| الإعلانات المُصاحبة | |
|
|
|
| تعبئة الإعلانات المصاحبة السابقة | |
|
|
|
| تراكبات | 5 |
|
|
|
| التحميل المُسبَق لمواد العرض | 7 |
|
|
|
| ميزات Ad Exchange في "مدير إعلانات Google" | ||||
| TrueView InStream | 5 |
|
|
|
| InStream Select | |
|
|
|
| إعلانات عادية أثناء عرض الفيديو | |
|
|
|
| الخانة الكاملة | |
|
|
|
| الإعلانات المُصاحبة | |
|
|
|
| تعبئة الإعلانات المصاحبة السابقة | |
|
|
|
| تراكبات | 5 |
|
|
|
| إمكانية العرض في "العرض النشط" | |
|
|
|
| التحميل المُسبَق لمواد العرض | 7 |
|
|
|
| لماذا هذا الإعلان؟ | |
|
|
|
1 ميزات VAST 3.0 التالية غير متاحة بعد في حِزم تطوير البرامج (SDK) التي لا تستخدم HTML5:
- وضع المزاملة
adSlotId - خيارات عرض الإعلانات المصاحبة
- الرموز
2 ميزات VMAP التالية غير متاحة بعد:
- أحداث التتبُّع الخاصة بـ VMAP
- رموز الخطأ الخاصة بـ VMAP
- الإعلانات التي تظهر على سطح الفيديو
- فروق التوقيت بخلاف hh:mm:ss أو "start" و "end"
- عرض السمة
breakType - سمة واحدة (
repeatAfter)
3 يتطلّب استخدام قائمة تشغيل إعلانات الفيديو المتعددة (VMAP) وقواعد الإعلانات على iPhone تشغيل الإعلانات المخصّصة.
4 تصاميم الإعلانات المستضافة على YouTube متوافقة مع أجهزة الكمبيوتر المكتبي ولكنّها غير متوافقة مع الويب على الأجهزة الجوّالة.
5 يتم دعم الإعلانات غير الخطية (الإعلانات التي تظهر على سطح الفيديو) والإعلانات القابلة للتخطي (غير TrueView) وإعلانات TrueView أثناء عرض الفيديو على الويب على الأجهزة الجوّالة التي تستخدم HTML5 على نظام التشغيل iOS 10 والإصدارات الأحدث عند استخدام
playsinline
.
6 يتطلّب تحديد عدد مرات الظهور ومنع إعلانات المنافسين في قواعد الإعلانات استخدام ملفات تعريف الارتباط أو معرّف PPID.
7 لا تعمل ميزة التحميل المُسبق لمواد العرض المخصّصة للإعلانات المدمجة مع المحتوى مع ما يلي:
- الويب على أجهزة iOS الجوّالة
- الويب على الأجهزة الجوّالة التي تعمل بنظام التشغيل Android قبل الإصدار 4.0
- الإعلانات المستضافة على YouTube، بما في ذلك أشكال إعلانات TrueView
-
ميزة تشغيل الفواصل الإعلانية يدويًا في IMA (أي عملية تنفيذ
تعتمد على الحدث
AD_BREAK_READY)
8 لا تتيح حزمة تطوير البرامج (SDK) عرض الإعلانات القابلة للتخطّي التي تقلّ مدتها عن 8 ثوانٍ. عند تشغيل إعلانات أقصر من الحد الأدنى للمدة، لا يظهر الزر تخطّي.
9 من بين ميزات VAST 4 التي تتيحها "إدارة إعلانات Google"، تتيح حزمة تطوير البرامج للإعلانات التفاعلية (IMA) الميزات التالية:
- VAST 4.2
- دعم تعريف واجهة الوسائط التفاعلية الآمنة (SIMID)
- السماح بعُقد
UniversalAdIDمتعددة
- الإصدار 4.0 من نموذج عرض إعلانات فيديو (VAST)
- AdID
- ملف Mezzanine
- رموز أخطاء VAST الجديدة
- دعم
AdVerifications
حِزم تطوير برامج (SDK) متوقّفة نهائيًا
| Flash v2 | HTML5 v1 | الإصدار 1 من iOS | الإصدار 1 من Android | الإصدار 2 من Google Cast | |
|---|---|---|---|---|---|
| ميزات الفيديو في "مدير إعلانات Google" | |||||
| الإعلانات الخطية | |
|
|
|
|
| الإعلانات غير الخطية | |
|
|
|
|
| الإعلانات التفاعلية (الإصدار 1.0 من معيار دقّة واجهة عرض الإعلانات على مشغّل الفيديو (VPAID)) | |
|
|
|
|
| عمليات إعادة التوجيه (الإصدار 2.0 من VAST) | |
|
|
|
|
| الاحتياطي الإعلاني المصاحب ("AdSense للفيديو" و"مدير إعلانات Google" وAd Exchange) | |
|
|
|
|
| إعلانات صوتية | |
|
|
|
|
| توافق علامة "ناشر Google" (GPT) | |
|
|
|
|
| تحديد عدد مرّات الظهور | |
|
|
|
|
| منع إعلانات المنافسين (البث) | |
|
|
|
|
| منع إعلانات المنافسين (المجموعة الإعلانية) | |
|
|
|
|
| منع إعلانات المنافسين (الصفحة بأكملها) | |
|
|
|
|
| الوعي بالمحتوى | |
|
|
|
|
| قواعد الإعلانات والفواصل الإعلانية اليدوية في قواعد الإعلانات | |
|
|
|
|
| بودكاست | |
|
|
|
|
| ملصقات صغيرة | |
|
|
|
|
| تتبُّع الأحداث المتعدّدة (MET) لإعداد التقارير | |
|
|
|
|
| التخصيص الديناميكي | |
|
|
|
|
| قابل للتخطي | |
|
|
|
|
| InStream Select | |
|
|
|
|
| ميزات "AdSense للفيديو" | |||||
| إعلانات نصية | |
|
|
|
|
| إعلانات VAST أثناء عرض الفيديو في AdSense | |
|
|
|
|
| إعلان تراكبي في AdSense | |
|
|
|
|
| قابل للتخطي | |
|
|
|
|
| InStream Select | |
|
|
|
|
| خيار المستخدم (YouTube) | |
|
|
|
|
| إعلانات F2F في "مدير الإعلانات" | |
|
|
|
|
| ميزات Ad Exchange في "مدير إعلانات Google" | |||||
| الإعلانات الخطية | |
|
|
|
|