مراجعة توافق حزمة تطوير البرامج (SDK) ومدى توفّرها

اختيار النظام الأساسي: HTML5 Android iOS tvOS Cast Roku

تقدّم هذه الصفحة معلومات عامة حول دعم وتوافق تكنولوجيا IMA DAI مع المتصفّحات وتنسيقات الفيديو والأنظمة الأساسية.

تنسيقات الفيديو والمتصفحات المتوافقة

لا يزال HTML5 معيارًا جديدًا ومتطوّرًا. نتيجةً لذلك، يختلف توفّر الميزات المختلفة بين المتصفّحات، ولا يتوفّر تنسيق فيديو تلقائي واحد متوافق مع جميع المتصفّحات الرئيسية. تنسيقات الفيديو الرئيسية الثلاثة المستخدَمة في معظم المتصفحات هي H.264 وHLS وDash.

التوافق مع أحداث VAST

يسرد هذا القسم أحداث VAST التي يتم إرسال تقارير عنها تلقائيًا إلى الخادم استنادًا إلى المعلومات التي يتم عرضها في ردّ VAST.

متوافقة بالكامل

‫complete وcreativeView وfirstQuartile وimpression وmidpoint وpause وresume وrewind (يتم تنشيطها عند إجراء أي بحث كبير في الاتجاه الخلفي) وstart وthirdQuartile

جهاز متوافق جزئيًا

• click

  لا يتم إرسال الحدث Click إلا لإعلانات الفيديو. لا يمكن تسجيل النقرات على مشغّلات ملء الشاشة الأصلية على أجهزة Android أو iOS أو أجهزة الكمبيوتر، ولكن يمكن تسجيل النقرات من خلال عنصر تتبُّع النقرات داخل الصفحة عند إغلاق الفيديو. ومع ذلك، إذا كان عنصر الفيديو يستخدم عناصر تحكّم أصلية على جهاز iPad، لا يمكن تسجيل النقرات.

• fullscreen
  

  تتوافق حزمة تطوير البرامج لإعلانات الوسائط التفاعلية مع وضع ملء الشاشة المُحاكَى، حيث يشغل الفيديو نافذة المتصفّح بأكملها. تعتبر حزمة تطوير البرامج IMA أنّ الفيديو في وضع ملء الشاشة عندما يكون offsetWidth وoffsetHeight بحجم نص المستند على الأقل. يتوفّر هذا الوضع على جميع المتصفّحات.

  على أجهزة iPhone ومنصات Android التي تعمل بالإصدارات الأقدم من 3.0، يتم تشغيل الفيديو دائمًا في وضع ملء الشاشة.

• ‫mute، unmute

  يتوفّر على أجهزة iOS وAndroid فقط إمكانية التحكّم في مستوى الصوت بشكلٍ تلقائي. وبالتالي، لا يمكن لحزمة IMA تحديد مستوى الصوت أو حالة كتم الصوت، كما لا يتم إعلام حزمة SDK بالتغييرات. في ما يلي قائمة بإصدارات المتصفّحات المتوافقة وغير المتوافقة مع mute وunmute:

  • متوافق مع: Firefox 3.5+ وChrome 8+ وSafari 4+
  • غير متوافق مع: iOS وAndroid

يُرجى الرجوع إلى إرشادات IAB للحصول على مزيد من التفاصيل حول عرض إعلانات VAST.

أحداث الإعلانات عند إعادة مشاهدة الفواصل الإعلانية

لا تُطلق حزمة تطوير البرامج IMA أحداث الإعلانات عند إعادة مشاهدة الإعلانات للأسباب التالية:

• يجب ألا يتم تشغيل عناوين URL الخاصة بالأحداث إلا مرة واحدة، وإلا قد يتم اعتبارها سلوكًا غير مرغوب فيه.
• يتيح ذلك للمستخدمين البحث في فواصل الإعلانات التي شاهدوها من قبل وحولها، ما يؤدي إلى تحسين تجربة البحث.

في ما يلي الأحداث الوحيدة التي يتم تنشيطها عند إعادة مشاهدة فواصل إعلانية:

• AD_PERIOD_STARTED
• AD_PERIOD_ENDED

منصات مشغّلات الفيديو المتوافقة

تتوافق حِزم تطوير البرامج للإعلانات التفاعلية من Google مع المنصات التالية:

النظام الأساسي	الإصدار
HTML5	أجهزة الكمبيوتر: Chrome وFirefox وSafari وEdge وOpera الأجهزة الجوّالة: Chrome/متصفّح Android (على هواتف Android وأجهزة Android اللوحية) وSafari وChrome (على أجهزة iOS)
iOS	‫iOS 10.0 أو إصدار أحدث
Android	‫Android 4.4 والإصدارات الأحدث
Google Cast	جميع أجهزة البث
tvOS	‫tvOS 15 أو إصدار أحدث
Roku	جميع الأجهزة التي لا تزال تتلقّى تحديثات البرامج من Roku

تنسيقات بث الفيديو المتوافقة

تتوافق حزمة IMA مع كلّ من HLS وDASH على مستوى حِزم SDK. راجِع هذا الجدول لمعرفة مدى توفّر الدعم على منصات حِزم SDK معيّنة. لتشغيل البث بشكل سليم، يجب أن يتوافق مشغّل الفيديو مع نوع البث المستخدَم.

منصّة "حزمة تطوير البرامج للإعلانات التفاعلية"	HLS	DASH
HTML5
iOS
Android
Google Cast
tvOS
Roku

ميزات الفيديو وإصدارات حزمة تطوير البرامج (SDK)

لمزيد من المعلومات حول الميزات التالية، يُرجى قراءة نظرة عامة على الإعلانات على الفيديو.

IAB Video Suite	الدعم
VAST 4	1
VAST 3	2
VAST 2
VPAID 2
VMAP 1.0.1	3
ميزات الفيديو في "مدير إعلانات Google"	الدعم
الإعلانات الخطية
الإعلانات غير الخطية (الإعلانات التي تظهر على سطح الفيديو)
الإعلانات المُصاحبة	4
مراجع إعلانات مصاحبة بديلة بتنسيق VAST 3
إمكانية العرض في "العرض النشط"
عمليات إعادة توجيه VAST
استبدال الإعلانات المصاحبة بطلب عرض إعلان
التوافق مع علامة "ناشر Google"‏ (GPT)
التعرّف على المحتوى
قواعد الإعلانات
التقاط الصور من مسافة قريبة
ملصقات صغيرة
إعداد التقارير بشأن تتبُّع الأحداث المتعدّدة (MET)
إعلان قابل للتخطّي (حملة قائمة على الحجز / غير TrueView)	5
ميزات "AdSense للفيديو" 7	الدعم
TrueView InStream	6
InStream Select
إعلان عادي أثناء عرض الفيديو
Full-slot
الإعلانات المُصاحبة	4
إضافة بيانات سابقة للإعلان المصاحب
تراكبات
ميزات Ad Exchange في "إدارة إعلانات Google"	الدعم
TrueView InStream	6
InStream Select
إعلان عادي أثناء عرض الفيديو
Full-slot
الإعلانات المُصاحبة	4
إضافة بيانات سابقة للإعلان المصاحب
تراكبات
إمكانية العرض في "العرض النشط"
لماذا هذا الإعلان؟	8

¹ من بين ميزات نموذج عرض إعلانات فيديو (VAST) 4 المتوافقة مع إدارة إعلانات Google، تتوافق وكالة تسويق عبر المؤثرين (IMA) مع الميزات التالية:

• ‫VAST 4.2
  • إتاحة تعريف واجهة الوسائط التفاعلية الآمنة (SIMID)
  • السماح بعُقد UniversalAdID متعددة
• الإصدار 4.0 من VAST
  • AdID
  • ملف وسيط
  • رموز أخطاء جديدة في نموذج عرض إعلانات الفيديو (VAST)
  • وحدات ماكرو VAST الجديدة
  • دعم AdVerifications

² لا تتوفّر ميزات الإصدار 3.0 من VAST التالية بعد:

• الجهاز المصاحب adSlotId
• خيارات عرض الإعلانات المساعِدة
• الرموز

³ الميزات التالية في VMAP غير متاحة بعد:

• أحداث التتبُّع الخاصة بـ VMAP
• رموز الخطأ الخاصة بـ VMAP
• الإعلانات التي تظهر على سطح الفيديو
• معادلات الوقت غير hh:mm:ss أو "البداية" و "النهاية"
• سمة "عرض breakType"
• سمة واحدة (repeatAfter)

⁴ يُسمح فقط بمواد العرض المصاحبة للصور. تتطلّب الإعلانات المصوّرة المصاحبة تنفيذًا مخصّصًا لملء الإعلانات. لا تتوفّر الإعلانات المصاحبة على tvOS.

⁵ لا تتوفّر الإعلانات التقليدية القابلة للتخطّي إلا في حِزم تطوير البرامج لإدراج الإعلانات الديناميكي في IMA DAI بتنسيق HTML5 وiOS وtvOS وRoku وAndroid (بما في ذلك Android TV). باستخدام Cast SDK، يجب الإفصاح عن إمكانية التخطّي باستخدام StreamRequest.senderCanSkip، لإتاحة الإعلانات التقليدية القابلة للتخطّي.

⁶ تتوافق "الإعلانات القابلة للتخطّي" من TrueView مع حِزم تطوير البرامج (SDK) لخدمة IMA DAI من "إعلانات الوسائط التفاعلية" في HTML5 وiOS وtvOS وRoku وAndroid (بما في ذلك Android TV).

⁷ ميزات AdSense غير متاحة في حزمة تطوير البرامج (SDK) الخاصة بـ Cast.

⁸ تتطلّب ميزة لماذا هذا الإعلان؟ تمرير المَعلمة adUiElement عند إنشاء StreamManager. لا تتوافق ميزة لماذا هذا الإعلان؟ مع Cast SDK.

ملاحظة مهمة: يتطلّب استخدام حزمة تطوير البرامج (SDK) الخاصة بـ "الفحص الديناميكي لحِزم ARP" في "إعلانات الوسائط التفاعلية" بتنسيق HTML5 مع الإعلانات القابلة للتخطّي أو ميزة لماذا يظهر هذا الإعلان؟ تمرير المَعلمة adUiElement عند إنشاء StreamManager.