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

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

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

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

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

1. تحمّل صفحة الويب أو التطبيق حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK) باستخدام:

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

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

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

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

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

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

6. تُطلق حزمة IMA SDK إشعارًا بمرّة الظهور وأحداث تتبُّع VAST، حسب الحاجة.

مراحل النشاط

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