واجهة برمجة التطبيقات لعرض "مجموعات إعلانات" في "إدراج الإعلان الديناميكي" من Google
تتيح واجهة برمجة التطبيقات Pod Serving API الوصول إلى حِزم إعلانات الفيديو المتوافقة مع معدل نقل البيانات التكيّفي، والتي تم إعدادها بطريقة تتيح دمجها مباشرةً في قائمة تشغيل وسائط HLS أو MPEG DASH المخصّصة للمستخدمين.
هذه الواجهة مخصّصة للناشرين المتقدّمين وشركاء تكنولوجيا الفيديو. يتطلّب استخدام واجهة برمجة التطبيقات هذه على نطاق واسع تصميم وتنفيذ سير عمل متطوّر لعرض الوسائط، وهو أمر خارج نطاق هذه المستندات.
المتطلبات الأساسية
قبل معالجة بث مباشر من خلال DAI Podserving API، عليك إنشاء حدث بث مباشر باستخدام واجهة مستخدم Google Ad Manager أو واجهة برمجة التطبيقات الخاصة بالأحداث المباشرة.
المكونات
تتألف أي عملية تنفيذ لواجهة برمجة التطبيقات Pod Serving من ثلاثة مكوّنات: "مدير إعلانات Google"، ومشغّل فيديو للعميل، وخادم لمعالجة ملف البيان.
مدير الإعلانات
يتحمّل "مدير إعلانات Google" مسؤولية عرض الإعلانات للمستخدم، ويمكن إدارته من خلال حزمة SDK الخاصة بـ "مدير الإعلانات" أو واجهة الويب الخاصة به. تتضمّن الخدمة المسؤوليات التالية:
- تلقّي طلبات البث من مشغّل الفيديو الخاص بالعميل، واتّخاذ قرارات بشأن الإعلانات، وتوفير عروض تقديمية تتطابق مع ملفات ترميز المحتوى
- الردّ على طلبات شرائح الإعلانات من مشغّل الفيديو الخاص بالعميل وتقديم الجزء المناسب من حزمة الإعلانات للمستخدم المحدّد
- تلقّي إشارات التتبُّع ومعالجتها من مشغّل الفيديو الخاص بالعميل
مشغّل الفيديو الخاص بالعميل
مشغّل الفيديو الخاص بالعميل هو التطبيق أو الموقع الإلكتروني الذي يستخدمه العملاء لتشغيل بث الفيديو الناتج. يتحمّل اللاعب المسؤوليات التالية:
- تهيئة مصدر بث من "مدير إعلانات Google" وتلقّي عنصر بث يمثّل جلسة تشغيل واحدة لحدث بث مباشر محدّد
- طلب بيان بث من خادم معالجة البيانات، ما يؤدي إلى بدء التشغيل
- إجراء استطلاع بشكل دوري لبيانات وصفية خاصة بحزمة الإعلانات من "إدارة إعلانات Google"، وتصف هذه البيانات أحداث الإعلانات المضمّنة في شرائح الإعلانات الخاصة بالبث
- الاستماع إلى أحداث البيانات الوصفية المحدّدة بوقت التي يعرضها المشغّل والتي تحتوي على معرّفات وسائط الإعلان عند مواجهة هذه الأحداث، يرسلها مشغّل الفيديو إلى "مدير إعلانات Google" للتأكّد من وقوع أحداث الإعلانات بنجاح.
لمزيد من المعلومات حول التنفيذ السليم لمشغّل الفيديو على العميل، يُرجى الاطّلاع على دليل عرض الإعلانات المتسلسلة على نظامك الأساسي:
بالنسبة إلى عمليات التنفيذ المخصّصة، يُرجى الاطّلاع على دليل عملاء عرض الإعلانات ضمن البودات لواجهة برمجة التطبيقات DAI.
خادم تعديل ملف البيان
خادم تعديل ملف البيان هو الخادم المسؤول عن استضافة ملف بيان البث المقدَّم إلى مشغّل الفيديو على جهاز العميل. يتحمّل الخادم المسؤوليات التالية:
- التعامل مع عملية إرسال البيان إلى مشغّل الفيديو لدى العميل
- طلب نموذج فترة من "مدير إعلانات Google" (لبرامج MPEG DASH فقط)، لتتم تعبئته بمقاطع إعلانية
- إدراج عناوين URL لشرائح الإعلانات المستضافة على "مدير إعلانات Google" في بيان بث الفيديو (بتنسيق HLS) أو فترة الإعلان (بتنسيق MPEG DASH) خلال الفواصل الإعلانية
- عرض ملف البيان المعدَّل على مشغّل الفيديو لدى العميل
لمزيد من المعلومات عن تنفيذ خادم مخصّص لمعالجة ملف البيان، يُرجى الاطّلاع على دليل معالجة ملف البيان.
مسرد المصطلحات
- حدث البث المباشر: هو حدث يخزّن بيانات الإعداد المهمة للبث المباشر، مثل ملفات تعريف الترميز. يتم إنشاء أحداث البث المباشر باستخدام "مدير إعلانات Google".
- كائن البث: كائن يمثّل جلسة تشغيل واحدة لمادة عرض فيديو معيّنة. تشمل السمات البارزة معرّف البث وعنوان URL الخاص بالتحقّق من الوسائط.
- مجموعة الإعلانات المتسلسلة: تجميع فيديوهات الإعلانات التي يتم عرضها في فاصل إعلاني
- شرائح الإعلانات: ملفات شرائح الوسائط للفاصل الإعلاني
- البيانات الوصفية لحزمة الإعلانات: البيانات الوصفية لفاصل الإعلانات المستخدَم لعرض واجهة مستخدم الإعلان على العميل، مثل إخفاء أزرار التقديم السريع والترجيع أثناء عرض الإعلان
- معرّف وسائط الإعلان: بيانات وصفية مشفّرة كعلامات ID3 ضمن ملفات مقاطع الإعلان تُستخدَم هذه البيانات الوصفية لتحديد وقت وقوع أحداث معيّنة ذات صلة بالإعلانات أثناء التشغيل، مثل بدء الإعلان أو نقطة المنتصف.