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

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

يوفر هذا الدليل نظرة عامة على دورة حياة حزمة تطوير البرامج (SDK) والتفاعلات بين مشغّل الفيديو وحزمة IMA SDK وخادم الإعلانات.

التفاعلات الأساسية

يوضّح المخطّط التالي التفاعلات بين مشغّل الفيديو وحزمة IMA SDK وخادم الإعلانات، مع إضافة تعليقات توضيحية. يمكن أن يستخدم خادم الإعلانات "مدير إعلانات Google" أو AdSense للفيديو أو Ad Exchange ‫(AdX).

1. تحمّل صفحة الويب أو التطبيق حزمة IMA SDK باستخدام:

   • علامة نص برمجي مضمّنة لـ HTML5
   • تطبيق لنظام التشغيل Android أو Google Cast أو iOS أو tvOS

2. تطلب حزمة IMA SDK استجابة VAST للوحدة الإعلانية المحدّدة على خادم الإعلانات. يتم تحديد خادم الإعلانات الذي تم طلبه، والذي يمكن أن يكون "مدير إعلانات Google" أو AdSense للفيديو أو AdX، من خلال عنوان URL لعلامة الإعلان.

3. يختار خادم الإعلانات أفضل إعلان ويرسل استجابة VAST إلى حزمة IMA SDK. يتم اختيار الإعلانات باستخدام إحدى الطرق التالية:

   • تصفّي فلاتر الوحدة الإعلانية في "مدير إعلانات Google" المرشّحين من البنود الإعلانية.
   • يُجري AdSense أو Ad Exchange مزادًا.

4. تحلّل حزمة IMA SDK استجابة VAST، وتحدّد نوع الوسائط الصحيح استنادًا إلى البيئة، وتُرسل تصميم إعلان الفيديو المضمّن (والإعلانات المصاحبة إذا لزم الأمر) إلى صفحة الويب أو التطبيق.

5. يتفاوض مشغّل الفيديو على تفاصيل التشغيل مع حزمة IMA SDK ويعرض الإعلانات.

6. تُرسل حزمة IMA SDK طلب ping لمرّة الظهور وأحداث التتبُّع في VAST، حسب الحاجة.

مراحل النشاط

يوضّح هذا المخطّط دورة الحياة الكاملة لحزمة IMA SDK. يتم تمييز استدعاءات الدالة الإنشائية وطلبات الإجراءات باللون الأزرق، ويتم تمييز الأحداث باللون الأحمر، ويتم عرض شروط الخطأ باستخدام روابط باللون الأحمر ونص باللون الأحمر.