مراجعة توافق حزمة تطوير البرامج (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 IMA SDK مع المنصات التالية:

النظام الأساسي الإصدار
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
ميزات "إعلانات الفيديو" في "إدارة إعلانات Google" الدعم
الإعلانات الخطية علامة صح
الإعلانات غير الخطية (الإعلانات التي تظهر على سطح الفيديو) Red-X
الإعلانات المُصاحبة تحذير 4
مراجع الإعلانات المصاحبة البديلة في VAST 3 Red-X
إمكانية العرض في "العرض النشط" علامة صح
عمليات إعادة توجيه VAST علامة صح
استبدال الإعلانات المصاحبة بطلب عرض إعلان Red-X
التوافق مع علامة "ناشر Google" ‏ (GPT) Red-X
الوعي بالمحتوى Red-X
قواعد الإعلانات علامة صح
Podding علامة صح
ملصقات صغيرة علامة صح
إعداد التقارير بشأن ميزة "تتبُّع الأحداث المتعدّدة" (MET) علامة صح
إعلان قابل للتخطّي (حملة قائمة على الحجز / غير TrueView) تحذير 5
ميزات "AdSense للفيديو" 7 الدعم
TrueView InStream تحذير 6
InStream Select علامة صح
Standard InStream علامة صح
Full-slot Red-X
الإعلانات المُصاحبة تحذير 4
إضافة بيانات الإعلانات المصاحبة السابقة Red-X
تراكبات Red-X
ميزات Ad Exchange في "إدارة إعلانات Google" الدعم
TrueView InStream تحذير 6
InStream Select علامة صح
Standard InStream علامة صح
Full-slot Red-X
الإعلانات المُصاحبة تحذير 4
إضافة بيانات الإعلانات المصاحبة السابقة Red-X
تراكبات Red-X
إمكانية العرض في "العرض النشط" علامة صح
لماذا هذا الإعلان؟ تحذير 8

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

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

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

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

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

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

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

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

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

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