نظرة عامة على أحداث بث "الفيديوهات عند الطلب"
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توفّر واجهة برمجة التطبيقات DAI Pod Serving API عروض إعلانات فيديو متسلسلة بمعدل نقل بيانات تكيُّفي معدّة بطريقة يمكن تجميعها مباشرةً في قائمة تشغيل وسائط HLS أو MPEG-DASH الموجّهة للمستخدم.
تتألف عملية الدمج النموذجية مع واجهة برمجة التطبيقات DAI Pod Serving API من ثلاثة مكوّنات رئيسية:
مدير إعلانات Google، وهو تطبيق مشغّل فيديو للعملاء، يتم إنشاؤه عادةً باستخدام حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية (IMA)، وأداة التلاعب.
مدير الإعلانات
ويتحمّل "مدير إعلانات Google" مسؤولية عرض مجموعات الإعلانات المتسلسلة في أداة معالجة البيانات.
يتفاعل معالج البيان مع واجهة برمجة تطبيقات عرض
Pod في "مدير الإعلانات" لطلب مجموعات الإعلانات المتسلسلة. تقع على عاتق الخدمة المسؤوليات التالية:
- إنشاء جلسة بث لكل طلب من تطبيق مشغّل الفيديو الخاص بالعملاء
واختيار الإعلانات وإنشاء مجموعات الإعلانات المتسلسلة وتوفير عمليات العرض لمطابقة
الملفات الشخصية لترميز المحتوى، ويُعرف ذلك أيضًا باسم "تعديل تصميم إعلان الفيديو".
(الخطوتان 1 و2 في الرسم البياني أعلاه)
- الاستجابة لطلبات مجموعة الإعلانات المتسلسلة من أداة معالجة البيان
وتقديم بيانات مجموعة الإعلانات المتسلسلة التي تم ترميزها بشكل صحيح لدمجها في أحداث البث.
(الخطوتان 4 و5)
- الردّ على طلبات البيانات الوصفية لمجموعة الإعلانات المتسلسلة من تطبيق مشغّل الفيديو الخاص بالعميل
وتوفير جدول بحث لأحداث الإعلانات (الخطوتان 7 و8)
- تلقي ومعالجة إشعارات التتبع التي تم تلقيها بواسطة تطبيق مشغّل فيديو العميل. (الخطوة 10)
تطبيق مشغّل الفيديو للعميل
يمكن أن يكون تطبيق مشغّل الفيديو للعميل تطبيق تلفزيون أو تطبيق جوّال أو تطبيق ويب حيث
يشاهد المستخدمون بث الفيديو. يتحمل اللاعب المسؤوليات التالية:
- طلب مورد بث من "مدير إعلانات Google" وتلقّي عنصر بث
يمثّل جلسة تشغيل واحدة لمادة عرض فيديو محدّدة (الخطوتان
1 و2)
- طلب بيان البث من أداة معالجة البيان وبدء
التشغيل. (الخطوتان 3 و6)
- طلب البيانات الوصفية لمجموعة الإعلانات المتسلسلة من "مدير إعلانات Google" لوصف أحداث الإعلانات المضمّنة في أحداث البيانات الوصفية المحدّدة زمنيًا للبث المباشر (الخطوتان 7 و8)
- الاستماع إلى مشغّل الفيديو لمعاودة الاتصال مع أحداث البيانات الوصفية المحدّدة زمنيًا
المضمَّنة في الصوت أو الفيديو المضمّن الذي يحتوي على معرّفات وسائط الإعلانات (الخطوة التاسعة)
- يمكنك البحث عن عناوين URL لإثبات الملكية عن طريق مطابقة أرقام التعريف المضمّنة هذه بأحداث الإعلانات
وإبلاغ "مدير إعلانات Google" بأنّ أحداث الإعلانات هذه قد تمت بنجاح.
(الخطوة 10)
لمعرفة المزيد من المعلومات عن تنفيذ تطبيق مشغّل الفيديو للعميل، اطّلِع على
دليل حزمة تطوير البرامج لإعلانات الوسائط التفاعلية للنظام الأساسي الذي تستخدمه:
Android
أو HTML5
أو
iOS أو
tvOS.
للاطّلاع على عمليات التنفيذ المخصّصة، يُرجى الاطّلاع على دليل تطبيق مشغّل الفيديو الخاص بالعميل حول واجهة برمجة التطبيقات DAI
الفيديوهات عند الطلب.
أداة معالجة البيان
معالج البيان هو الخادم المسؤول عن استضافة بيان البث
المقدم لتطبيق مشغّل الفيديو الخاص بالعميل. وتقع على الخادم المسؤوليات التالية:
- جارٍ طلب بيانات مجموعة الإعلانات المتسلسلة من "مدير إعلانات Google". (الخطوتان 4 و5)
- يتجلى دمج هذه الإعلانات في البث الحالي لمحتوى الفيديو عند الطلب
وتقديم البيان النهائي لتطبيق مشغّل الفيديو الخاص بالعميل. (الخطوتان 3
و6)
لمزيد من المعلومات حول تنفيذ أداة مخصّصة لمعالجة البيانات، يُرجى مراجعة
دليل
أداة معالجة البيانات الخاص
بواجهة برمجة تطبيقات عرض DAI VOD Pod.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe DAI Pod Serving API delivers adaptive bitrate video ad pods for seamless integration into HLS or MPEG-DASH playlists.\u003c/p\u003e\n"],["\u003cp\u003eA typical integration involves Google Ad Manager, a client video player app (often using the IMA SDK), and a manifest manipulator.\u003c/p\u003e\n"],["\u003cp\u003eAd Manager handles ad pod delivery, stream session creation, ad selection, encoding, and tracking.\u003c/p\u003e\n"],["\u003cp\u003eThe client video player app requests streams, manifests, and ad metadata, and handles ad event verification.\u003c/p\u003e\n"],["\u003cp\u003eThe manifest manipulator stitches ad manifests into the content stream, creating the final manifest for the client video player.\u003c/p\u003e\n"]]],["The DAI Pod Serving API involves three components: Ad Manager, a client video player app, and a manifest manipulator. Ad Manager delivers ad pods, manages stream sessions, provides ad pod manifests and metadata, and processes tracking pings. The client app requests streams, requests and plays manifests, retrieves ad metadata, and sends ad event notifications. The manifest manipulator requests ad pod manifests from Ad Manager and then stitches them into the content stream, providing the final manifest to the client app.\n"],null,["# Overview for VOD streams\n\nThe DAI Pod Serving API provides adaptive-bitrate video ad pod manifests,\nprepared in such a way that they can be stitched directly into a user-facing HLS\nor MPEG-DASH media playlist.\n\nA typical integration with the DAI Pod Serving API has three main components:\nGoogle Ad Manager, a client video player app---commonly built using\nthe [Interactive Media Ads (IMA) SDK](/interactive-media-ads)---and a\nmanifest manipulator.\n\nAd Manager\n----------\n\nAd Manager is responsible for delivering ad pods to the manifest manipulator.\nThe manifest manipulator interacts with Ad Manager's [Pod Serving\nAPI](//support.google.com/admanager/answer/10492367#dai-pod-serving)\nto request the ad pods. The service has these responsibilities:\n\n- Creating a stream session for each request from the client video player app, selecting ads, building ad pods and providing renditions to match your content encoding profiles, also called \"video creative conditioning\". (Steps 1 and 2 in the diagram above)\n- Responding to ad pod requests from the manifest manipulator and providing properly encoded ad pod manifests for stitching into streams. (Steps 4 and 5)\n- Responding to ad pod metadata requests from the client video player app and providing a lookup table for ad events. (Steps 7 and 8)\n- Receiving and processing tracking pings received by the client video player app. (Step 10)\n\nClient video player app\n-----------------------\n\nThe client video player app can be a TV app, mobile app, or web app where\nusers watch the video stream. The player has these responsibilities:\n\n- Requesting a stream resource from Ad Manager and receiving a stream object that represents a single playback session of a specific video asset. (Steps 1 and 2)\n- Requesting a stream manifest from the manifest manipulator and beginning playback. (Steps 3 and 6)\n- Requesting ad pod metadata from Ad Manager, which describes the ad events embedded in the stream's timed metadata events. (Steps 7 and 8)\n- Listening to the video player for callbacks with timed metadata events embedded in the audio or video stream that contain ad media IDs. (Step 9)\n- Looking up the verification URLs by matching these embedded IDs to ad events and notifying Ad Manager that these ad events have successfully occurred. (Step 10)\n\nTo learn more about implementing the client video player app, see the\nIMA SDK guide for your platform:\n[Android](/ad-manager/dynamic-ad-insertion/sdk/android?service=pod),\n[HTML5](/ad-manager/dynamic-ad-insertion/sdk/html5?service=pod),\n[iOS](/ad-manager/dynamic-ad-insertion/sdk/ios?service=pod), or\n[tvOS](/ad-manager/dynamic-ad-insertion/sdk/tvos?service=pod).\nFor custom implementations, see our [client video player app\nguide](/ad-manager/dynamic-ad-insertion/api/pod-serving/vod/client) for the DAI\nVOD Pod Serving API.\n\nManifest manipulator\n--------------------\n\nThe manifest manipulator is the server in charge of hosting the stream manifest\nprovided to the client video player app. The server has these responsibilities:\n\n- Requesting ad pod manifests from Ad Manager. (Steps 4 and 5)\n- Stitching these ad manifests into the existing VOD content stream and providing the final manifest to the client video player app. (Steps 3 and 6)\n\nTo learn more about implementing a custom manifest manipulator, see the\n[manifest manipulator\nguide](/ad-manager/dynamic-ad-insertion/api/pod-serving/vod/manipulator) for the\nDAI VOD Pod Serving API."]]
