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

تحمّل صفحة الويب أو التطبيق حزمة تطوير البرامج لإعلانات الوسائط التفاعلية باستخدام:
- علامة نص برمجي مضمّنة لـ HTML5
- تطبيق متوافق مع Android أو Google Cast أو iOS أو tvOS
تطلب حزمة تطوير البرامج للإعلانات التفاعلية استجابة نموذج عرض إعلانات فيديو (VAST) للوحدة الإعلانية المحدّدة على خادم الإعلانات. يتم تحديد خادم الإعلانات الذي تمّ طلبه، والذي يمكن أن يكون "مدير إعلانات Google" مقابل "AdSense للفيديو" أو AdX، من خلال عنوان URL لعلامة الإعلان.
يختار خادم الإعلانات أفضل إعلان ويرسل استجابة VAST إلى حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية (IMA). يتم اختيار الإعلانات باستخدام إحدى الطرق التالية:
- فلاتر الوحدة الإعلانية في "مدير إعلانات Google" التي تستبعد "بنود الحملات"
- إجراء مزاد من خلال AdSense أو Ad Exchange
تحلّل "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" استجابة نموذج عرض إعلانات فيديو (VAST)، وتحدّد نوع الوسائط الصحيح استنادًا إلى البيئة، وتقدّم تصميم إعلان الفيديو المضمّن (والإعلانات المصاحبة إذا لزم الأمر) إلى صفحة الويب أو التطبيق.
يتفاوض مشغّل الفيديو على تفاصيل التشغيل مع حزمة تطوير البرامج للإعلانات التفاعلية ويشغّل الإعلانات.
تُرسِل حزمة تطوير البرامج للإعلانات التفاعلية إشارة ping لمرّة الظهور وأحداث تتبُّع نموذج عرض إعلانات فيديو (VAST)، حسب الحاجة.
مراحل النشاط
يوضّح هذا المخطّط البياني دورة الحياة الكاملة لحزمة تطوير البرامج للإعلانات التفاعلية. يتم تمييز عمليات استدعاء الدوال الإنشائية والدوال باللون الأزرق، ويتم تمييز الأحداث باللون الأحمر، ويتم عرض شروط الخطأ باستخدام موصلات حمراء ونص أحمر.