DAI Pod Serving API را یاد بگیرید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
سرویس Pod به شما امکان می دهد بدون ارسال محتوای خود به سرورهای DAI Google، درج آگهی سمت سرور را با تبلیغات Google انجام دهید. میتوانید با شریک فنی ویدیوی موجود خود برای دستکاری مانیفست خود یا پیادهسازی سرور دستکاری مانیفست خود با استفاده از DAI Pod Serving API ( Live یا VOD ) کار کنید.
میتوانید از DAI SDK تبلیغات رسانهای تعاملی (IMA) برای توسعه برنامههای مشتری برای پلتفرمهای وب و تلفن همراه استفاده کنید که بهطور یکپارچه با DAI Pod Serving API تعامل دارند. برای پیکربندی IMA DAI SDK با DAI Pod Serving API، به راهنمای مربوط به پلتفرم های برنامه مشتری شما (Android، Chromecast، HTML5، iOS، Roku، tvOS) برای قالب پخش زنده یا VOD مراجعه کنید.
اگر نیازمندیهای خاصی دارید که توسط IMA DAI SDK پشتیبانی نمیشوند، میتوانید راهنمای پخشکننده ویدیوی مشتری ( Live یا VOD ) را برای توسعه برنامههای مشتری خود دنبال کنید.
اجزای سرویس دهی غلاف DAI
پیاده سازی DAI Pod Serving API از سه جزء اصلی تشکیل شده است:
Google Ad Manager
Google Ad Manager یک سرویس میزبانی شده است که جلسات پخش جریانی کاربر را ایجاد و مدیریت میکند، تبلیغات را برای ارائه انتخاب میکند، آنها را به عنوان بخشهای جریان رمزگذاری میکند و در صورت درخواست به پخشکننده ویدیوی مشتری تحویل میدهد.
در جریانهای زنده، زمانی که بخشهای خاصی توسط پخشکننده ویدیوی مشتری درخواست میشود، تبلیغات در زمان واقعی درج میشوند و به عنوان تغییر مسیرهای URL برای آن بخشهای رسانه به پخشکننده تحویل داده میشوند.
در جریانهای VOD، تبلیغات قبل از شروع بازپخش انتخاب میشوند و بهعنوان مجموعهای از مانیفستهای جریان مربوط به هر غلاف آگهی به دستکاریکننده مانیفست تحویل داده میشوند.
دستکاری کننده آشکار
دستکاری کننده مانیفست سروری است که شناسه جلسه پخش جریانی را از پخش کننده ویدیوی مشتری دریافت می کند، از آن برای مرتبط کردن تبلیغات با آن جریان استفاده می کند و آن تبلیغات را در مانیفست جریان جاسازی می کند.
برای پخشهای زنده HLS، دستکاریکننده مانیفست مستقیماً با Ad Manager ارتباط برقرار نمیکند. درعوض، بخشهای رسانه تبلیغات را در مانیفست جریان با نشانیهای اینترنتی Ad Manager قرار میدهد تا پخشکننده ویدیوی مشتری بتواند فایلهای بخش رسانه آگهی را درخواست کند.
برای جریانهای VOD، مانیفستکننده مستقیماً با Ad Manager برای درخواست تبلیغات ارتباط برقرار میکند و مجموعهای از مانیفستهای جریان را برای ادغام با جریان محتوا دریافت میکند. سپس مانیفست ترکیبی برای پخش به پخش کننده ویدیوی مشتری ارسال می شود.
پخش کننده ویدیوی مشتری
پخش کننده ویدیوی مشتری برنامه یا وب سایتی است که در نهایت جریان ویدیویی حاوی تبلیغات را پخش می کند. قبل از انجام این کار، یک شناسه جریان از Ad Manager درخواست می کند و سپس آن شناسه را به دستکاری کننده مانیفست ارسال می کند تا یک مانیفست پخش جریانی را برای پخش دریافت کند. همچنین مسئول تماشای فراداده های درون جریانی و راه اندازی رویدادهای ردیابی تبلیغات است.
پخش زنده در مقابل سرویس غلاف VOD
در یک نگاه، پخش جریانی زنده و سرویس غلاف VOD ممکن است بسیار شبیه به هم به نظر برسند. با این حال، چندین تفاوت مهم بین این دو جریان کار وجود دارد.
پخش پخش مستقیم غلاف | سرو غلاف VOD |
---|
پخشکننده ویدیوی سرویس گیرنده در طول پخش، در صورت نیاز، از Ad Manager آگهی درخواست میکند. این تبلیغات را میتوان با استفاده از اعلانهای اولیه وقفه تبلیغاتی از پیش انتخاب کرد. | دستکاریکننده مانیفست همه تبلیغات را قبل از شروع پخش از Ad Manager درخواست میکند. |
با جریانهای HLS، دستکاریکننده مانیفست مستقیماً با Ad Manager ارتباط برقرار نمیکند، اما در عوض URLهای بخش آگهی را برای پخشکننده ویدیوی مشتری ایجاد میکند تا در صورت نیاز درخواست کند. | دستکاری کننده مانیفست قبل از ایجاد مانیفست جریان برای پخش کننده ویدیوی مشتری، مستقیماً از Ad Manager آگهی درخواست می کند. |
اگر یک غلاف تبلیغاتی کوتاهتر از یک وقفه تبلیغاتی مشخص شده باشد، ممکن است Ad Manager درج کند. | تخته سنگ مورد نیاز یا پشتیبانی نیست. |
قبل از درخواست تبلیغات، باید رویداد پخش زنده و نمایههای رمزگذاری را با Ad Manager ثبت کنید. | قبل از درخواست تبلیغات، نیازی به انجام هیچ راهاندازی در Ad Manager ندارید، اما دستکاریکننده مانیفست باید نمایههای رمزگذاری مربوطه و برچسب آگهی را برای جریان شما در هر درخواست آگهی ارائه دهد. |
مهم است که این تفاوت ها را در حین انجام سرویس Live یا VOD pod در نظر داشته باشید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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."]]