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

تقدّم هذه الصفحة معلومات عامة حول توافق أداة تطوير برامج 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 بعد إنشاء مثيل له.

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

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

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

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

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

	HTML5 الإصدار 3	الإصدار 3 من نظام التشغيل iOS	‫Android v3	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
Full-slot
الإعلانات المُصاحبة
إضافة بيانات الإعلانات المصاحبة السابقة
تراكبات	5
التحميل المُسبَق لمواد العرض	7
ميزات Ad Exchange في "مدير إعلانات Google"
TrueView InStream	5
InStream Select
Standard InStream
Full-slot
الإعلانات المُصاحبة
إضافة بيانات الإعلانات المصاحبة السابقة
تراكبات	5
إمكانية العرض في "العرض النشط"
التحميل المُسبَق لمواد العرض	7
لماذا هذا الإعلان؟

¹ لا تتوفّر ميزات VAST 3.0 التالية في حِزم تطوير البرامج (SDK) غير المتوافقة مع HTML5:

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

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

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

^‫3 يتطلّب استخدام قائمة تشغيل إعلانات الفيديو المتعددة (VMAP) وقواعد الإعلانات على أجهزة iPhone تشغيل الإعلانات بشكل مخصّص.

⁴ تصاميم الإعلانات المستضافة على YouTube متاحة على أجهزة الكمبيوتر المكتبي ولكن ليس على الويب على الأجهزة الجوّالة.

^‫5 تتوافق الإعلانات غير الخطية (الإعلانات المتراكبة) والإعلانات القابلة للتخطّي (غير TrueView) وإعلانات TrueView أثناء عرض الفيديو مع الويب على الأجهزة الجوّالة بتنسيق HTML5 على نظام التشغيل iOS 10 والإصدارات الأحدث عند استخدام playsinline .

^‫6 تتطلّب ميزة تحديد عدد مرّات الظهور في قواعد الإعلانات وميزة الاستبعاد التنافسي ملفات تعريف الارتباط أو المعرّف المقدَّم من الناشر (PPID).

^‫7 لا يمكن استخدام ميزة التحميل المُسبَق لمواد العرض الأصلية مع ما يلي:

• المواقع الإلكترونية على الأجهزة الجوّالة التي تعمل بنظام التشغيل iOS
• المواقع الإلكترونية المتوافقة مع الأجهزة الجوّالة التي تعمل بإصدار Android الأقدم من 4.0
• الإعلانات المستضافة على YouTube، بما في ذلك أشكال إعلانات TrueView
• ميزة تشغيل الفواصل الإعلانية يدويًا في IMA (أي عملية تنفيذ تعتمد على الحدث AD_BREAK_READY)

⁸ لا تتوافق حزمة تطوير البرامج (SDK) مع الإعلانات القابلة للتخطّي التي تقلّ مدتها عن 8 ثوانٍ. عند تشغيل إعلانات أقصر من الحدّ الأدنى للمدة، لا يظهر الزر تخطّي.

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

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

حِزم تطوير البرامج (SDK) المتوقّفة نهائيًا

	Flash v2	HTML5 الإصدار 1	الإصدار 1 من نظام التشغيل iOS	‫Android v1	‫Google Cast الإصدار 2
ميزات "فيديو مدير إعلانات 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 في "مدير إعلانات Google"
ميزات Ad Exchange في "مدير إعلانات Google"
الإعلانات الخطية