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

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

تقدّم هذه الصفحة معلومات عامة حول توافق تكنولوجيا "إدراج الإعلان الديناميكي" من "إعلانات الوسائط التفاعلية" مع المتصفّحات وتنسيقات الفيديو والمنصات.

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

لا يزال 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 جميع أجهزة Cast
tvOS ‫tvOS 15 أو إصدار أحدث
Roku جميع الأجهزة التي لا تزال تتلقّى تحديثات البرامج من Roku

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

تتوافق "إعلانات الوسائط التفاعلية" مع كلّ من HLS وDASH في جميع حِزم تطوير البرامج (SDK). راجِع هذا الجدول لمعرفة الأنظمة الأساسية المتوافقة مع حِزم SDK معيّنة. لتشغيل البث بشكل سليم، يجب أن يتوافق مشغّل الفيديو مع نوع البث المستخدَم.

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

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

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

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

1 من بين ميزات VAST 4 المتوافقة مع "مدير إعلانات Google"، تتوافق "إعلانات الوسائط التفاعلية" مع الميزات التالية:

  • ‫VAST 4.2
  • ‫VAST 4.0
    • AdID
    • ملف وسيط
    • رموز أخطاء جديدة في نموذج عرض إعلانات فيديو (VAST)
    • وحدات ماكرو جديدة لنموذج عرض إعلانات الفيديو (VAST)
    • دعم AdVerifications

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

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

3 لا تتوفّر ميزات VMAP التالية بعد:

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

4 يُسمح فقط باستخدام الإعلانات المصاحبة للصور. تتطلّب الإعلانات المصاحبة المصوّرة تنفيذًا مخصّصًا لملء الإعلانات. لا تتوافق الإعلانات المصاحبة مع نظام التشغيل tvOS.

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

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

7 لا تتوافق ميزات AdSense مع حزمة تطوير البرامج Cast SDK.

8 تتطلّب ميزة لماذا يظهر هذا الإعلان؟ تمرير المَعلمة adUiElement عند إنشاء StreamManager. لا تتوافق ميزة لماذا هذا الإعلان؟ مع حزمة تطوير البرامج (SDK) الخاصة بـ Cast.

ملاحظات حول أُطر عمل JavaScript

هناك بعض الاعتبارات عند استخدام إطار عمل JavaScript، مثل React أو AngularJS، مع حزمة تطوير البرامج للإعلانات التفاعلية من Google في HTML5. وغالبًا ما تنقل هذه الأُطر عناصر من نموذج المستند (DOM)، ما قد يؤدي إلى تعطيل حزمة تطوير البرامج (SDK) الخاصة بـ IMA، لأنّ الحزمة تتوقّع أن يكون نموذج المستند ثابتًا عند بدء تشغيلها. تتوافق حزمة تطوير البرامج للإعلانات التفاعلية مع أُطر عمل JavaScript طالما تم بدء الحزمة بعد انتهاء إطار العمل من نقل عناصر DOM. على وجه التحديد، يجب عدم نقل عنصر HTML5 الذي تم تمريره كمعلَمة adUiElement عند إنشاء StreamManager بعد إنشاء مثيل له.

التوافق مع Apple AirPlay

لا تتوافق حزمة تطوير البرامج لإعلانات الوسائط التفاعلية مع Apple AirPlay. إمّا إيقاف AirPlay أو إيقاف طلبات الإعلانات عند رصد AirPlay