درج آگهی هدایت‌شده توسط سرور (SGAI) یک مانیفست غلاف تبلیغاتی آماده برای دوخت در دستگاه‌های مشتری فراهم می‌کند. اگر Pod Serving DAI را در شبکه Google Ad Manager خود فعال کرده باشید، به استفاده از SGAI دسترسی دارید. اگر Pod Serving DAI را فعال ندارید، با مدیر حساب خود تماس بگیرید.
با SGAI، از نقاط پایانی API سرویس Pod برای ایجاد جریانی برای بازیابی فراداده آگهی و مانیفست غلاف آگهی استفاده می‌کنید.
اگر سرور دستکاری مانیفست دارید، می‌توانید نشانی‌های اینترنتی مانیفست غلاف آگهی را ایجاد کنید و نشانگرهای تبلیغاتی را که اطلاعات مانیفست غلاف آگهی را در جریان محتوای خود حمل می‌کنند، با توجه به مشخصات دلخواه خود درج کنید.
از طرف دیگر، می‌توانید با استفاده از مکانیزم متفاوتی غیر از نشانگرهای تبلیغاتی در مانیفست جریان، یک وقفه تبلیغاتی را برنامه‌ریزی کنید. در این موارد، برنامه شما می‌تواند به رویدادهای دیگر، به عنوان مثال، تعامل کاربر با جریان، خود برنامه یا یک اعلان فشاری گوش دهد. پس از این رویدادها، برنامه می‌تواند نشانی‌های وب مانیفست پاد تبلیغات را ایجاد کند و به پخش کننده بگوید که بارگیری مانیفست پاد آگهی را شروع کند.
پیش نیازها
قبل از ادامه، مطمئن شوید که موارد زیر را دارید:
- سرویس DAI Pod در شبکه Google Ad Manager شما فعال شد.
- یک رویداد پخش زنده با نوع مانیفست سرویس Pod . برای ایجاد رویداد، به تنظیم جریان زنده برای DAI مراجعه کنید.
توصیه ها را دنبال کنید
قبل از ایجاد URL مانیفست غلاف تبلیغات ، توصیه می‌کنیم با API Early Break Notification (EABN) تماس بگیرید تا مدت زمان مورد انتظار، اطلاعات هدف‌گیری و سایر پارامترهای هر وقفه تبلیغاتی را مشخص کنید.
برای تولید و جریان های آزمایشی، با EABN API تماس بگیرید، به خصوص اگر شبکه تبلیغاتی شما دارای کمپین های برنامه ای باشد. برای اطلاعات بیشتر، به ویژگی‌ها و دستورالعمل‌های برنامه مستقیم مستقیم مراجعه کنید.
درخواست ثبت استریم کنید
هنگامی که کاربر یک جریان محتوا را در برنامه پخش کننده ویدیوی شما شروع می کند، شما یک درخواست ثبت جریان با پارامترهای هدف را برای ایجاد یک جلسه پخش جریانی در Ad Manager ارائه می دهید. برای جزئیات در مورد درخواست ثبت جریان، به روش: جریان مراجعه کنید. پس از آن، داده های پاسخ را از درخواست دریافت می کنید.
نمونه های زیر درخواست ثبت جریان را ارائه می دهند:
HTTP متن ساده
- درخواست:
authority: dai.google.com
method: POST
path: /ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream
scheme: https
content-type: application/x-www-form-urlencoded
cust_params=customID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2
- پاسخ:
{
"manifest_format": "hls",
"media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
"metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
"polling_frequency": 10,
"session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
"stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}
پوسته
- خط فرمان:
curl \
-H "Host: dai.google.com" \
-H "content-type: application/x-www-form-urlencoded" \
--data-binary "cust_params=channelID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2" \
--compressed "https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream"
- خروجی:
{
"manifest_format": "hls",
"media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
"metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
"pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
"polling_frequency": 10,
"session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
"stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}
جاوا اسکریپت
- استفاده از Fetch API:
const response = await fetch("https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream", {
"headers": {
"content-type": "application/x-www-form-urlencoded",
},
"body": "cust_params=channelID%3D1543216789%26anotherKey%3Dvalue1%2Cvalue2",
"method": "POST",
});
const stream = await response.json();
console.log(stream);
- گزارش کنسول:
{
"stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL",
"media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
"metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
"session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
"polling_frequency": 10,
"pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
"manifest_format": "hls"
}
نظرسنجی برای فراداده های استراحت آگهی
پس از درخواست ثبت جریان، برای فراداده آگهی نظرسنجی کنید. برای نظرسنجی، یک تایمر با استفاده از polling_frequence در پاسخ جریان در مرحله ثبت نام برای فراخوانی فراداده آگهی تنظیم می‌کنید. برای هر نظرسنجی، ممکن است فهرستی جزئی از تبلیغات با فراداده به محض در دسترس قرار گرفتن آنها دریافت کنید.
URL مانیفست غلاف آگهی را ایجاد کنید
یک URL برای منبع غلاف Pod Serving API بسازید. پس از آن، URL را به یک پخش کننده ویدیو ارسال کنید تا بارگیری آگهی شروع شود.
مثال زیر ساختار URL مانیفست پاد تبلیغات را نشان می دهد:
https://dai.google.com/linear/pods/v1/hls/network/51636543/custom_asset/pod_serving_hls_manifest_mp4/pod/101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000
می‌توانید پارامترهای URL مانیفست غلاف آگهی را بر اساس اطلاعات شکست آگهی بازیابی شده از پخش‌کننده ویدیو یا اعلان سرور محاسبه کنید. برای الزامات این پارامترها، روش: pod manifest را ببینید.
مانیفست غلاف آگهی را پخش کنید
در برنامه پخش‌کننده ویدیوی مشتری، پخش جریانی محتوا را با پخش‌کننده ویدیوی اصلی شروع کنید و در صورت لزوم، مستندات پخش‌کننده ویدیوی خود را در مورد مشاهده پخش و زمان‌بندی تبلیغات دنبال کنید.
اگر نشانی‌های وب مانیفست غلاف تبلیغات را ایجاد می‌کنید و آنها را در مانیفست در سمت سرور درج می‌کنید، رویدادهای آتی پخش‌کننده ویدیو را در وقفه‌های تبلیغاتی مشاهده کنید و اطمینان حاصل کنید که در طول پخش هر وقفه تبلیغاتی در رویدادهای id3 مشترک می‌شوید. اگر رویدادهای استراحت آگهی را از سمت مشتری برنامه‌ریزی می‌کنید، در رویدادهای id3 در هنگام ایجاد مشترک شوید.
برداشت ها و رویدادهای تبلیغاتی را گزارش دهید
هنگامی که یک پخش کننده ویدیو پاد تبلیغات را پخش می کند و با فراداده های زمان بندی شده id3 مواجه می شود، به رویدادهای تبلیغاتی که پخش کننده ویدیو راه اندازی می کند گوش دهید و آنها را برای ارسال پینگ تأیید رسانه پردازش کنید.