تقدّم هذه الصفحة معلومات عامة حول توافق أداة تطوير برامج HTML5 لإعلانات الوسائط التفاعلية مع المتصفحات وتنسيقات الفيديو والمنصات، بالإضافة إلى إمكانية استخدامها من جهة العميل.
تنسيقات الفيديو والمتصفّحات المتوافقة
يختلف توفّر الميزات المختلفة بين المتصفحات، ولا يتوفّر تنسيق فيديو تلقائي واحد متوافق مع جميع المتصفحات الرئيسية. تنسيقات الفيديو الثلاثة الرئيسية المستخدَمة في معظم المتصفحات هي H.264 وWebM وOgg Theora.
مشغّلات الفيديو المتوافقة
تتوافق معظم ميزات "إعلانات الوسائط التفاعلية" مع مشغّلات الفيديو العادية بتنسيق HTML5، بما في ذلك العلامة <video> في HTML. يمكنك الاطّلاع على برنامج شركاء تكنولوجيا الفيديو للحصول على قائمة بمشغّلات الفيديو المعروفة التي تتوافق مع حزمة تطوير البرامج لإعلانات الوسائط التفاعلية.
التوافق مع أحداث 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 تحديد مستوى الصوت أو حالة كتم الصوت، كما لا يتم إعلامنا بالتغييرات. في ما يلي قائمة بإصدارات المتصفّحات المتوافقة وغير المتوافقة مع
muteوunmute:- متوافق: Firefox 3.5+ وChrome 8+ وSafari 4+
- غير متوافق مع: iOS وAndroid
للحصول على مزيد من التفاصيل حول عرض إعلانات VAST، يُرجى الرجوع إلى إرشادات IAB.
ملاحظات حول أُطر عمل JavaScript
هناك بعض الاعتبارات عند استخدام إطار عمل JavaScript، مثل React أو AngularJS، مع حزمة تطوير البرامج للإعلانات التفاعلية من Google بتنسيق HTML5. وغالبًا ما تنقل هذه الأُطر عناصر DOM، ما قد يؤدي إلى تعطيل وظائف IMA لأنّ IMA تتوقّع أن تكون DOM ثابتة عند بدء حزمة SDK. تتوافق حزمة IMA مع أُطر عمل JavaScript طالما تم بدء IMA بعد أن ينتهي إطار العمل من نقل عناصر DOM. على وجه التحديد، يجب عدم نقل عنصر HTML5 الذي تم تمريره كمعلَمة containerElement عند إنشاء AdDisplayContainer بعد إنشاء مثيل له.
التوافق مع Apple AirPlay
لا تتوافق حزمة تطوير البرامج لإعلانات الوسائط التفاعلية حاليًا مع Apple AirPlay. يمكنك إيقاف AirPlay أو إيقاف طلبات الإعلانات عند رصد AirPlay.
منصّات مشغّلات الفيديو المتوافقة
تتوافق حِزم تطوير البرامج لإعلانات الوسائط التفاعلية من Google مع المنصات التالية:
| النظام الأساسي | الإصدار | نوع الإعلان |
|---|---|---|
| HTML5 | أجهزة الكمبيوتر: Chrome وFirefox وSafari وEdge وOpera الأجهزة الجوّالة: Chrome/متصفّح Android (على هواتف Android وأجهزة Android اللوحية) وSafari وChrome (على أجهزة iOS) |
الإعلانات الخطية وغير الخطية والإعلانات المصاحبة و"حلول الفيديو" في "مدير إعلانات Google" وإعلانات الفيديو على Ad Exchange وإعلانات الفيديو على AdSense |
| iOS | iOS 10.0 أو الإصدارات الأحدث | الإعلانات الخطية والإعلانات المصاحبة وإعلانات الفيديو على "مدير إعلانات Google" وإعلانات الفيديو على Ad Exchange وإعلانات الفيديو على "AdSense لمنصة YouTube" |
| Android | Android 4.4 والإصدارات الأحدث | الإعلانات الخطية والإعلانات المصاحبة وإعلانات الفيديو على "مدير إعلانات Google" وإعلانات الفيديو على Ad Exchange وإعلانات الفيديو على "AdSense لمنصة YouTube" |
| tvOS | الإصدار 14 من نظام التشغيل tvOS أو إصدار أحدث | الإعلانات الخطية والفيديو على "مدير إعلانات Google" والفيديو على Ad Exchange |
ميزات الفيديو وإصدارات حزمة تطوير البرامج (SDK)
لمزيد من المعلومات حول الميزات التالية، يُرجى قراءة نظرة عامة حول الإعلان على الفيديو.
| HTML5 الإصدار 3 | الإصدار 3 من نظام التشغيل iOS | الإصدار 3 من Android | tvOS | |
|---|---|---|---|---|
| IAB Video Suite | ||||
| VAST 4 |  9 |
9 |
9 |
9 |
| VAST 3 |  |
1 |
1 |
1 |
| VAST 2 | |
|
|
|
| SIMID 1.0 | |
|
|
 |
| VPAID 2 (HTML5) | |
|
|
|
| VMAP 1.0.1 | 2 3 |
2 |
2 |
2 |
| OM SDK 1.3 | |
|
|
|
| ميزات "فيديو" في "مدير إعلانات Google" | ||||
| الإعلانات الخطية | |
|
|
|
| مواد العرض المستضافة على YouTube | 4 |
|
|
|
| الإعلانات غير الخطية (الإعلانات التي تظهر على سطح الفيديو) | 5 |
|
|
|
| الإعلانات المُصاحبة | |
|
|
|
| مراجع الإعلانات المصاحبة البديلة في VAST 3 | |
|
|
|
| إمكانية العرض في "العرض النشط" | |
|
|
|
| إعلانات صوتية | |
|
|
|
| عمليات إعادة توجيه VAST | |
|
|
|
| استبدال الإعلانات المصاحبة بطلب إعلان صوري | |
|
|
|
| التوافق مع "علامة ناشر Google" (GPT) | |
|
|
|
| التعرّف على المحتوى | |
|
|
|
| قواعد الإعلانات | 3 |
|
|
|
| فواصل إعلانية يدوية في قواعد الإعلانات |
|
|
|
|
| تحديد عدد مرات الظهور 6 | |
|
|
|
| الاستبعادات التنافسية (البث) | |
|
|
|
| الاستبعادات التنافسية (في البودكاست) | |
|
|
|
| استثناءات المنافسين (الصفحة بأكملها) | |
|
|
|
| Podding | 3 |
|
|
|
| ملصقات صغيرة | |
|
|
|
| إعداد التقارير عن ميزة "تتبُّع الأحداث المتعدّدة" (MET) | |
|
|
|
| التخصيص الديناميكي (AdSense للفيديو وAd Exchange في "مدير إعلانات Google") | |
|
|
|
| قابلة للتخطّي (غير TrueView) 8 | 5 |
|
|
|
| InStream Select | |
|
|
|
| التحميل المُسبَق لمواد العرض | 7 |
|
|
|
| ميزات "AdSense للفيديو" | ||||
| TrueView InStream | 5 |
|
|
|
| InStream Select | |
|
|
|
| Standard InStream | |
|
|
|
| موضع إعلان كامل | |
|
|
|
| الإعلانات المُصاحبة | |
|
|
|
| إضافة بيانات الإعلانات المصاحبة السابقة | |
|
|
|
| تراكبات | 5 |
|
|
|
| التحميل المُسبَق لمواد العرض | 7 |
|
|
|
| ميزات Ad Exchange في "مدير إعلانات Google" | ||||
| TrueView InStream | 5 |
|
|
|
| InStream Select | |
|
|
|
| Standard InStream | |
|
|
|
| موضع إعلان كامل | |
|
|
|
| الإعلانات المُصاحبة | |
|
|
|
| إضافة بيانات الإعلانات المصاحبة السابقة | |
|
|
|
| تراكبات | 5 |
|
|
|
| إمكانية العرض في "العرض النشط" | |
|
|
|
| التحميل المُسبَق لمواد العرض | 7 |
|
|
|
| لماذا هذا الإعلان؟ | |
|
|
|
1 لا تتوافق حِزم تطوير البرامج (SDK) غير المستندة إلى HTML5 مع ميزات VAST 3.0 التالية:
- المساعد
adSlotId - خيارات عرض الإعلانات المساعِدة
- الرموز
2 لا تتوفّر ميزات VMAP التالية بعد:
- أحداث التتبُّع الخاصة بـ VMAP
- رموز الخطأ الخاصة بـ VMAP
- الإعلانات التي تظهر على سطح الفيديو
- إزاحات الوقت غير hh:mm:ss أو "البداية" و "النهاية"
- سمة
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"، تتوافق "إعلانات الوسائط التفاعلية" مع الميزات التالية:
- VAST 4.2
- التوافق مع Secure Interactive Media Interface Definition (SIMID)
- السماح بعُقد
UniversalAdIDمتعدّدة
- VAST 4.0
- AdID
- ملف Mezzanine
- رموز أخطاء جديدة في نموذج عرض إعلانات فيديو (VAST)
- دعم
AdVerifications
حِزم تطوير البرامج (SDK) المتوقّفة نهائيًا
| الإصدار 2 من Flash | HTML5 الإصدار 1 | الإصدار 1 من نظام التشغيل iOS | Android v1 | الإصدار 2 من Google Cast | |
|---|---|---|---|---|---|
| ميزات "فيديو" في "مدير إعلانات Google" | |||||
| الإعلانات الخطية | |
|
|
|
|
| الإعلانات غير الخطية | |
|
|
|
|
| الإعلانات التفاعلية (VPAID 1.0) | |
|
|
|
|
| عمليات إعادة التوجيه (الإصدار 2.0 من VAST) | |
|
|
|
|
| الاحتياطي الإعلاني المصاحب (AdSense للفيديو وAd Exchange في "مدير إعلانات Google") | |
|
|
|
|
| إعلانات صوتية | |
|
|
|
|
| التوافق مع "علامة ناشر Google" (GPT) | |
|
|
|
|
| تحديد عدد مرات الظهور | |
|
|
|
|
| الاستبعادات التنافسية (البث) | |
|
|
|
|
| الاستبعادات التنافسية (في البودكاست) | |
|
|
|
|
| استثناءات المنافسين (الصفحة بأكملها) | |
|
|
|
|
| التعرّف على المحتوى | |
|
|
|
|
| قواعد الإعلانات وفواصل الإعلانات اليدوية في قواعد الإعلانات | |
|
|
|
|
| Podding | |
|
|
|
|
| ملصقات صغيرة | |
|
|
|
|
| تتبُّع أحداث متعدّدة (MET) لإعداد التقارير | |
|
|
|
|
| التخصيص الديناميكي | |
|
|
|
|
| قابل للتخطي | |
|
|
|
|
| InStream Select | |
|
|
|
|
| ميزات "AdSense للفيديو" | |||||
| الإعلانات النصية | |
|
|
|
|
| AdSense VAST InStream | |
|
|
|
|
| تراكب AdSense | |
|
|
|
|
| قابل للتخطي | |
|
|
|
|
| InStream Select | |
|
|
|
|
| خيار المستخدم (YouTube) | |
|
|
|
|
| إعلانات F2F في "مدير الإعلانات" | |
|
|
|
|
| ميزات Ad Exchange في "مدير إعلانات Google" | |||||
| الإعلانات الخطية | |
|
|
|
|