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