پخش جریانی VOD تبلیغات قابل رد شدن

این راهنما نحوه استفاده از DAI API برای درخواست یک جریان VOD با تبلیغات قابل رد شدن، رندر کردن دکمه پرش مطابق با الزامات Google Ads و ارسال رویدادهای ردیابی مرتبط را نشان می‌دهد.

پیش نیازها

• برنامه ای که DAI API را پیاده سازی می کند، جریان های VOD را فراخوانی می کند. برای اطلاعات بیشتر به راهنمای جریان DAI API VOD مراجعه کنید.

برای تبلیغات قابل رد شدن درخواست دهید

برای درخواست یک جریان VOD با تبلیغات قابل رد شدن، باید پارامتر dai-sas در درخواست پخش خود ارسال کنید.

نقطه پایانی API

POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded

پارامترهای مسیر

{CMS_ID}	شناسه CMS جریان.
{VIDEO_ID}	شناسه ویدیوی جریان.

پارامترهای بدن

dai-sas

برای فعال کردن تبلیغات قابل پرش dai-sas=1 تنظیم کنید.

درخواست نمونه (cURL)

برای درخواست های جریان HLS:

curl -X POST \
     -d 'dai-sas=1' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream

'dash' در URL برای جریان‌های DASH جایگزین کنید:

https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream

از قالب زیر برای گنجاندن پارامترهای جریانی متعدد در بدنه درخواست خود استفاده کنید:

-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \

تبلیغات پرش را مدیریت کنید

برای رسیدگی به تبلیغات پرش، از اطلاعات موجود در ساختار Ad struct یا AdBreak بسته به اینکه آیا تبلیغ فعلی یا کل وقفه تبلیغاتی را رد می کنید، استفاده کنید. مقدار start را بگیرید و مقدار duration را اضافه کنید، سپس آن نقطه را در جریان جستجو کنید. پیام فرعی SkipMetadata همچنین شامل مقدار offset است که مقداری در چند ثانیه از زمان قبل از رد شدن تبلیغ است. پیام فرعی SkipMetadata فقط در تبلیغاتی که قابل رد شدن هستند شامل می شود.

ad_breaks

لیستی از وقفه های تبلیغاتی start (تعداد) موقعیتی در جریانی که وقفه شروع می شود، در چند ثانیه. duration (تعداد) مدت وقفه آگهی، بر حسب ثانیه. ads (object(Ad)) فهرستی از تبلیغات در جریان. start (تعداد) موقعیت در جریانی که تبلیغ شروع می شود، در چند ثانیه. duration (تعداد) مدت زمان تبلیغ، بر حسب ثانیه. skip_metadata (object(SkipMetadata)) فراداده اختیاری برای تبلیغات قابل پرش. اگر تنظیم شود، این نشان می‌دهد که تبلیغ قابل رد شدن است و شامل دستورالعمل‌هایی برای نحوه مدیریت رابط کاربری پرش و رویداد ردیابی است. offset (تعداد) Offset مدت زمانی را که بازیکن باید برای نمایش دکمه پرش منتظر بماند، در ثانیه نشان می دهد. اگر در VAST ارائه نشده باشد حذف می شود. tracking_url (رشته) آدرس اینترنتی که باید در رویداد پرش پینگ شود.

پاسخ نمونه

{
  ...
  "ad_breaks":[
    {
      ...
      "start":0,
      "duration":10,
      "ads":[
        {
          ...
          "start":0,
          "duration":10,
          "skip_metadata":{
            "offset": 5,
            "tracking_url": "https://example_skip_url.com"
          }
        }
    }
}

پس از رد شدن تبلیغ، URL رویداد رد شدن موجود در پاسخ جریان را پینگ کنید. در زیر پیام SkipMetadata گنجانده شده است.

الزامات دکمه پرش

برای تبلیغات قابل رد شدن، دکمه پرش را با الزامات طراحی زیر رندر کنید. رعایت نکردن این الزامات ممکن است منجر به اعمال محدودیت هایی در تبلیغات Google شود که به سایت یا برنامه شما ارائه می شود.

تایمر شمارش معکوس

تا زمان skipoffset مشخص شده در VAST، آگهی نباید قابل رد شدن باشد. در طول این دوره غیرقابل رد شدن، باید اخطاری را به کاربر نمایش دهید که به او اطلاع می‌دهد می‌توان آگهی را در X ثانیه رد کرد. اعلامیه باید به زبان کاربر ترجمه شود.

رد شدن از موقعیت دکمه

برای زبان چپ به راست، دکمه پرش را در سمت راست پایین پخش کننده ویدیو قرار دهید. برای زبان راست به چپ، دکمه پرش را در سمت چپ پایین پخش کننده ویدیو قرار دهید.

رد شدن از اندازه دکمه

دکمه و متن باید به اندازه کافی بزرگ باشند تا در یک تجربه تکیه به وضوح خوانا باشند.

متن و نماد

دکمه پرش باید هم متن و هم نماد نگاری داشته باشد. می توانید از نماد رد شدن از مواد بعدی به عنوان نماد نگاری خود استفاده کنید.

دسترسی

کاربر باید بتواند با استفاده از صفحه کلید یا کنترل از راه دور به دکمه پرش پیمایش کند. پس از اتمام شمارش معکوس، برنامه باید دکمه پرش را متمرکز کند.

بین المللی شدن

توصیه می شود متن پرش را به زبان کاربر ترجمه کنید.

غلاف های تبلیغاتی

از دکمه رد شدن می‌توان برای رد شدن از آگهی فعلی در قسمت آگهی یا رد شدن از کل پاد استفاده کرد.

ترجمه های «رد شدن از آگهی».

از فایل skipAdTranslations.json برای ترجمه متن «رد شدن از آگهی» بر اساس منطقه کاربر استفاده کنید.