این راهنما پیکربندی کنترلکننده مانیفست شما را برای درخواست بخشهای تبلیغاتی یا صفحات با استفاده از روش بخش غلاف تبلیغاتی پوشش میدهد.
یک پروتکل پخش جریانی انتخاب کنید:
پیشنیازها
قبل از ادامه، باید یک رویداد پخش زنده برای نوع و پروفایلهای کدگذاریِ درج آگهی پویا (DAI) در Pod Serving redirect تنظیم کنید. برای تنظیم یک رویداد پخش زنده، یکی از روشهای زیر را انتخاب کنید:
- رابط کاربری مدیر تبلیغات: یک پخش زنده برای DAI تنظیم کنید .
- رابط برنامهنویسی کاربردی مدیریت تبلیغات: از یک کتابخانه کلاینت برای فراخوانی متد
LiveStreamEventService.createLiveStreamEventsاستفاده کنید. پارامترLiveStreamEvent.dynamicAdInsertionTypeرا رویPOD_SERVING_REDIRECTتنظیم کنید. - درخواستهای احراز هویت: هر درخواست سگمنت که با استفاده از سرویسدهی پاد تغییر مسیر سگمنت انجام میشود، باید شامل یک توکن امضا شده توسط HMAC برای احراز هویت باشد. این توکن را یک بار در هر پخش تبلیغ محاسبه کنید و توکن را در تمام جلسات پخش به اشتراک بگذارید. برای محاسبه توکن HMAC، به درخواستهای پاد تبلیغ احراز هویت مراجعه کنید.
پس از تنظیم رویداد پخش زنده، با فراخوانی متد DaiEncodingProfileService.getDaiEncodingProfilesByStatement ، پروفایلهای کدگذاری رویداد را از رابط کاربری یا API مدیریت تبلیغات (Ad Manager UI یا API) بازیابی کنید.
بازیابی جریان محتوا
وقتی کاربر یک رویداد پخش زنده را انتخاب میکند، برنامهی کلاینت یک درخواست پخش زنده به Google Ad Manager ارسال میکند. در پاسخ پخش زنده، برنامه شناسهی جلسهی Google DAI و فراداده را برای گنجاندن در درخواست مانیفست پخش زنده استخراج میکند.
مثال زیر یک شناسه نشست Google DAI را به یک کنترلکننده مانیفست ارسال میکند:
https://MANIFEST_MANIPULATOR_URL/manifest.m3u8?DAI_stream_ID=SESSION_ID&network_code=NETWORK_CODE&DAI_custom_asset_key=CUSTOM_ASSET_KEY
هنگام پردازش درخواست پخش محتوای ویدیویی، شناسه جلسه Google DAI و CUSTOM_ASSET_KEY را از درخواست ذخیره کنید تا برای ادغام تبلیغات آماده شود.
بخشهای مربوط به تبلیغات را شناسایی کرده و ناپیوستگیها را وارد کنید
همانطور که هر مانیفست متغیر را پردازش میکنید، برچسبهای EXT-X-CUE-IN و EXT-X-CUE-OUT را در جریان خود شناسایی کنید که نشان دهنده شروع و پایان یک وقفه تبلیغاتی است.
تگهای EXT-X-CUE-IN و EXT-X-CUE-OUT را با عناصر EXT-X-DISCONTINUITY جایگزین کنید تا پخشکننده ویدیوی کلاینت بتواند بین محتوا و تبلیغات جابجا شود.
مانیفست مثال زیر جایگزین تگهای EXT-X-CUE-IN و EXT-X-CUE-OUT میشود:
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:0
#EXTINF:5.000,
contentorigin.com/1.ts
#EXTINF:5.000,
contentorigin.com/2.ts
#EXT-X-CUE-OUT:15.000
#EXTINF:5.000,
contentorigin.com/3.ts
#EXTINF:5.000,
contentorigin.com/4.ts
#EXTINF:5.000,
contentorigin.com/5.ts
#EXT-X-CUE-IN
#EXTINF:5.000,
contentorigin.com/6.ts
#EXTINF:5.000,
contentorigin.com/7.mp4
#EXTINF:5.000,
contentorigin.com/8.mp4
مثال زیر یک مانیفست جایگزین شده را نشان میدهد:
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:0
#EXTINF:5.000,
contentorigin.com/1.ts
#EXTINF:5.000,
contentorigin.com/2.ts
#EXTINF:5.000,
#EXT-X-DISCONTINUITY
{... Insert ad segments here ...}
#EXT-X-DISCONTINUITY
#EXTINF:5.000,
contentorigin.com/6.mp4
#EXTINF:5.000,
contentorigin.com/7.mp4
#EXTINF:5.000,
contentorigin.com/8.mp4
بخشهای تبلیغاتی Google DAI رمزگذاری نشدهاند. اگر محتوای شما رمزگذاری شده است، با وارد کردن عنصر EXT-X-KEY:METHOD=NONE قبل از اولین بخش تبلیغاتی هر تبلیغ، رمزگذاری را حذف کنید. در پایان تبلیغ، با وارد کردن EXT-X-KEY مناسب، رمزگذاری را دوباره اضافه کنید.
زمان شروع، مدت زمان و فهرست آگهیهای تبلیغاتی آینده را پیگیری کنید.
ساخت URL های بخش تبلیغات
هر بخش محتوا را بین تگهای EXT-X-DISCONTINUITY با یک URL که به روش بخشبندی ad pod اشاره میکند، جایگزین کنید.
مثال زیر یک بخش از ad pod را مونتاژ میکند. توجه داشته باشید که بخشهای تبلیغاتی از یک شاخص مبتنی بر صفر استفاده میکنند:
https://dai.google.com/linear/pods/v1/seg/network/NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/0.ts?sd=AD_SEGMENT_DURATION&pd=AD_BREAK_DURATION&stream_id=SESSION_ID&auth-token=HMAC
مثال زیر بخشهای مربوط به غلاف تبلیغات را در مانیفست وارد میکند:
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:0
#EXTINF:5.00,
contentorigin.com/1.ts
#EXTINF:5.00,
contentorigin.com/2.ts
#EXT-X-DISCONTINUITY
#EXTINF:5.00,
https://dai.google.com/linear/pods/v1/seg/network/
NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/0.ts?sd=5000&so=0&pd=15000&stream_id=SESSION_ID
#EXTINF:5.00,
https://dai.google.com/linear/pods/v1/seg/network/
NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/1.ts?sd=5000&so=5000&pd=15000&stream_id=SESSION_ID
#EXTINF:5.00,
https://dai.google.com/linear/pods/v1/seg/network/
NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/2.ts?sd=5000&so=10000&pd=15000&stream_id=SESSION_ID
#EXT-X-DISCONTINUITY
#EXTINF:5.00,
contentorigin.com/6.mp4
#EXTINF:5.00,
contentorigin.com/7.mp4
#EXTINF:5.00,
contentorigin.com/8.mp4
اختیاری: زمان پخش تبلیغات را تنظیم کنید
برای افزایش نرخ پر شدن، یک اعلان اولیه تبلیغات (EABN) با مدت زمان پخش تبلیغات، پارامترهای هدفگیری سفارشی و دادههای سیگنال SCTE-35 ارسال کنید. برای جزئیات بیشتر، به ارسال اعلانهای اولیه تبلیغات مراجعه کنید.