التعرّف على واجهة برمجة التطبيقات DAI Pod Serving API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتيح لك عرض مجموعة الإعلانات إمكانية تنفيذ ميزة إدراج الإعلانات من جهة الخادم مع "إعلانات Google" بدون إرسال المحتوى الخاص بك إلى خوادم إدراج الإعلانات الديناميكية (DAI) في Google. يمكنك التعاون مع الشريك التقني للفيديو حاليًا
لمعالجة البيان أو تنفيذ خادم معالجة البيان الخاص بك
باستخدام واجهة برمجة تطبيقات DAI Pod Serving API
(بث مباشر أو
فيديو عند الطلب).
يمكنك استخدام حزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية (IMA) من أجل تطوير تطبيقات العميل للويب والأنظمة الأساسية للأجهزة الجوّالة التي تتفاعل بسلاسة مع واجهة برمجة تطبيقات عرض DAI Pod. لضبط حزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية مع واجهة برمجة تطبيقات عرض DAI Pod، يمكنك الرجوع إلى الدليل
الخاص بالأنظمة الأساسية لتطبيق العميل (Android وChromecast وHTML5 وiOS
وRoku وtvOS) لتنسيق البث المباشر أو البث عند الطلب.
إذا كانت لديك متطلبات خاصة لا تدعمها حزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية،
يمكنك اتّباع دليل مشغّل الفيديو الخاص بالعميل
(مباشر أو
فيديو عند الطلب) لتطوير
تطبيقات العميل الخاصة.
مكوّنات عرض لوحة DAI المتسلسلة
يتألف تطبيق واجهة برمجة التطبيقات DAI Pod Serving API من ثلاثة مكوّنات رئيسية:
مدير إعلانات Google
"مدير إعلانات Google" هو خدمة مستضافة تنشئ جلسات بث المستخدمين
وتديرها وتختار الإعلانات لعرضها وترميزها كشرائح بث وعرضها
لمشغّل فيديو العميل عند الطلب.
في أحداث البث المباشر، يتم إدراج الإعلانات في الوقت الفعلي عندما يطلب مشغّل فيديو العميل مقاطع معيّنة ويتم عرضها على المشغّل كعمليات إعادة توجيه لعناوين URL لشرائح الوسائط هذه.
في أحداث البث المباشر المتوفرة عند الطلب، يتم اختيار الإعلانات قبل بدء التشغيل وإرسالها إلى
أداة معالجة البيانات كمجموعة من بيانات البث المقابلة لكل مجموعة
إعلانات متسلسلة.
أداة معالجة البيان
أداة معالجة البيان هو خادم يتلقى معرّف جلسة البث من
مشغّل فيديو العميل، ويستخدمه لربط الإعلانات بمجموعة البث هذه
وتضمين تلك الإعلانات في بيان البث.
بالنسبة إلى أحداث البث المباشر وفق بروتوكول HTTP (HLS)، لا يتواصل معالج البيانات مباشرةً
مع "مدير إعلانات Google". بدلاً من ذلك، يتم وضع شرائح وسائط الإعلانات في بيان البث
مع عناوين URL في "مدير إعلانات Google" لكي يتمكّن مشغّل فيديو العميل من طلب ملفات شرائح الوسائط الإعلانية.
بالنسبة إلى أحداث بث الفيديوهات عند الطلب، يتواصل معالج البيانات مباشرةً مع "مدير الإعلانات"
لطلب الإعلانات، ويتلقى مجموعة من بيانات البث لدمجها مع
بث المحتوى. يتم بعد ذلك إرسال البيان المجمّع إلى مشغّل فيديو العميل
لتشغيله.
مشغّل فيديو العميل
مشغّل فيديو العميل هو التطبيق أو الموقع الإلكتروني الذي يشغّل في النهاية بث الفيديو الذي يحتوي على إعلانات. وقبل إجراء ذلك، تطلب الأداة معرّف مصدر بيانات من "مدير إعلانات Google" ثم تُمرِّر هذا المعرّف إلى أداة معالجة البيان لتلقّي
بيان البث لتشغيله. كما أنها مسؤولة أيضًا عن مشاهدة البيانات الوصفية
أثناء عرض الفيديو وبدء أحداث تتبع الإعلانات.
عرض البث المباشر مقابل عرض إعلانات الفيديو المتسلسلة
في حال إلقاء نظرة سريعة، قد يبدو عرض البث المباشر ولوحات الفيديوهات عند الطلب متشابهَين إلى حدّ كبير.
ومع ذلك، هناك العديد من الاختلافات المهمة بين عمليتَي سير العمل.
| عرض لوحات البث المباشر |
عرض لوحات الفيديوهات عند الطلب |
|
يطلب مشغّل الفيديو الخاص بالعميل إعلانات من "مدير الإعلانات" حسب الحاجة طوال
عملية التشغيل. يمكن اختيار هذه الإعلانات مسبقًا باستخدام إشعارات الفواصل الإعلانية المبكرة.
|
يطلب معالج البيان جميع الإعلانات من "مدير الإعلانات" قبل بدء
التشغيل.
|
|
في أحداث البث المباشر وفق بروتوكول HTTP (HLS)، لا يتفاعل معالج البيانات
مباشرةً مع "مدير إعلانات Google"، بل ينشئ عناوين URL لشرائح الإعلان
حتى يطلبها مشغّل الفيديو الخاص بالعميل حسب الحاجة.
|
يطلب معالج البيان الإعلانات مباشرةً من "مدير الإعلانات" قبل إنشاء بيان البث لمشغِّل الفيديو الخاص بالعميل.
|
|
قد يدرج "مدير إعلانات Google" عنصرًا حاجبًا إذا كانت مجموعة الإعلانات المتسلسلة أقصر من فاصل إعلاني محدّد.
|
العنصر الحاجب ليس مطلوبًا أو متوافقًا.
|
|
يجب تسجيل حدث البث المباشر وملفات الترميز في "مدير إعلانات Google" قبل طلب عرض الإعلانات.
|
ولست بحاجة إلى إجراء أي إعداد في "مدير إعلانات Google" قبل طلب
عرض الإعلانات، ولكن يجب أن يوفّر معالج البيان الملفات الشخصية للترميز
ذات الصلة وعلامة الإعلان للبث الخاص بك في كل طلب إعلان.
|
من المهم مراعاة هذه الاختلافات أثناء عرض الإعلانات المتسلسلة المباشرة أو الفيديوهات عند الطلب.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eDAI pod serving enables server-side ad insertion with Google Ads without sending content to Google's servers, allowing flexibility with existing video partners or custom manifest manipulation.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can utilize the IMA DAI SDK for seamless integration across various platforms or follow client video player guides for custom app development.\u003c/p\u003e\n"],["\u003cp\u003eThe DAI pod serving architecture involves three core components: Google Ad Manager, a manifest manipulator (handling ad insertion in stream manifests), and the client video player (for playback and ad tracking).\u003c/p\u003e\n"],["\u003cp\u003eLivestream and VOD pod serving differ in how ads are requested and inserted: livestream requests ads during playback (potentially using early ad break notifications), while VOD requests all ads upfront.\u003c/p\u003e\n"],["\u003cp\u003eLivestream pod serving may utilize slate for short ad pods and requires pre-registration of events and encoding profiles, while VOD pod serving has no slate and requires ad tag and encoding profile information with each request.\u003c/p\u003e\n"]]],[],null,["# Learn DAI Pod Serving API\n\n[Pod serving](//support.google.com/admanager/answer/10492367) lets you perform\nserver-side ad insertion with Google ads, without sending your content to\nGoogle's DAI servers. You can work with your existing Video Technical\nPartner to manipulate your manifest or implement your own manifest manipulation\nserver using the DAI Pod Serving API\n([Live](/ad-manager/dynamic-ad-insertion/api/pod-serving/live) or\n[VOD](/ad-manager/dynamic-ad-insertion/api/pod-serving/vod)).\n\nYou can use the Interactive Media Ads (IMA) DAI SDK to develop client apps for\nthe web and mobile platforms that seamlessly interact with the DAI Pod Serving\nAPI. To configure the IMA DAI SDK with DAI Pod Serving API, refer to the guide\nthat's specific to your client app's platforms (Android, Chromecast, HTML5, iOS,\nRoku, tvOS) for Live or VOD stream format.\n\nIf you have special requirements that are not supported by the IMA DAI SDK, you\ncan follow the client video player guide\n([Live](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/client) or\n[VOD](/ad-manager/dynamic-ad-insertion/api/pod-serving/vod/client)) to develop\nyour own client apps.\n\nDAI pod serving components\n--------------------------\n\nAn implementation of the DAI Pod Serving API consists of three main components:\n\n### Google Ad Manager\n\nGoogle Ad Manager is a hosted service that creates and manages user stream\nsessions, selects ads to serve, encodes them as streaming segments, and delivers\nthem to the client video player when requested.\n\nIn live streams, ads are inserted in real time when specific segments are\nrequested by the client video player and are delivered to the player as URL\nredirects for those media segments.\n\nIn VOD streams, ads are selected before playback begins and are delivered to\nthe manifest manipulator as a set of stream manifests corresponding to each\nad pod.\n\n### Manifest manipulator\n\nA manifest manipulator is a server that receives a stream session ID from\nthe client video player, uses it to associate ads with that stream, and\nembed those ads into the stream manifest.\n\nFor HLS live streams, the manifest manipulator doesn't communicate directly\nwith Ad Manager. Instead, it places ad media segments in the stream manifest\nwith Ad Manager URLs so that the client video player can request the ad media\nsegment files.\n\nFor VOD streams, the manifest manipulator communicates directly with Ad Manager\nto request ads, and receives a set of streaming manifests to merge with the\ncontent stream. The combined manifest is then sent to the client video player\nfor playback.\n\n### Client video player\n\nThe client video player is the app or website that eventually plays back the\nvideo stream containing ads. Before doing so, it requests a stream ID from\nAd Manager and then passes that ID to the manifest manipulator to receive a\nstreaming manifest to play. It's also in charge of watching for in-stream\nmetadata and triggering ad tracking events.\n\nLivestream versus VOD pod serving\n---------------------------------\n\nAt a glance, livestream and VOD pod serving might appear very similar.\nHowever, there are several significant differences between the two workflows.\n\n| Livestream pod serving | VOD pod serving |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| The client video player requests ads from Ad Manager as needed throughout playback. These ads can be preselected using *early ad break notifications*. | The manifest manipulator requests all ads from Ad Manager before playback begins. |\n| With HLS streams, the manifest manipulator doesn't directly interact with Ad Manager, but instead generates ad segment URLs for the client video player to request as needed. | The manifest manipulator directly requests ads from Ad Manager before generating the stream manifest for the client video player. |\n| Ad Manager might insert slate if an ad pod is shorter than a specified ad break. | Slate is not needed or supported. |\n| You must register the livestream event and encoding profiles with Ad Manager before ads can be requested. | You don't need to perform any setup in Ad Manager before ads can be requested, but the manifest manipulator must provide the relevant encoding profiles and ad tag for your stream on each ad request. |\n\nIt's important to keep these differences in mind as you proceed with\n[Live](/ad-manager/dynamic-ad-insertion/api/pod-serving/live) or\n[VOD](/ad-manager/dynamic-ad-insertion/api/pod-serving/vod) pod serving."]]
