VOD ストリームのスキップ可能な広告

このガイドでは、DAI API を使ってスキップ可能な広告の VOD ストリームをリクエストする方法、Google 広告の要件に沿ってスキップボタンを表示する方法、関連するトラッキング イベントを送信する方法を説明します。

前提条件

スキップ可能な広告をリクエストする

スキップ可能な広告の 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 ID。
{VIDEO_ID} ストリームの動画 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

URL 内の 'dash' は、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 構造体または AdBreak 構造体内の情報を使用します。start 値を取得して duration 値を追加し、ストリーム内のその時点までシークします。SkipMetadata サブメッセージには offset 値も含まれます。この値は、広告をスキップできるようになるまでの時間（秒）です。SkipMetadata サブメッセージは、スキップ可能な広告にのみ含まれます。

ad_breaks ミッドロール挿入点のリスト。
start (number) ブレークを開始するストリームの位置（秒単位）。
duration (number) 広告ブレークの長さ（秒）。
ads (object(Ad)) ストリーム内の広告のリスト。
start （数値） 広告が開始するストリーム内の位置（秒単位）。
duration (number) 広告の再生時間（秒単位）。
skip_metadata (object(SkipMetadata)) スキップ可能広告のオプションのメタデータ。設定すると広告がスキップ可能であることを示し、スキップ UI とトラッキング イベントの処理方法に関する手順を含みます。
offset (number) オフセットは、広告の開始から広告がスキップボタンを表示するまでプレーヤーが待機する時間（秒単位）を示します。VAST で提供されていない場合は省略。
tracking_url （文字列）スキップ イベントで ping される URL。

レスポンスの例

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

広告がスキップされたら、ストリーム レスポンスに含まれるスキップ イベント URL に ping します。 これは、SkipMetadata サブメッセージに含まれています。

スキップ ボタンの要件

スキップ可能な広告の場合は、次の設計要件でスキップボタンを表示します。これらの要件を満たしていない場合、サイトやアプリに配信される Google 広告に制限が課される場合があります。

カウントダウンタイマー

VAST で指定された skipoffset の時間までスキップできるようにしてはいけません。このスキップ不可の期間中に、X 秒後に広告をスキップできることを知らせる通知を表示する必要があります。通知はユーザーの言語に翻訳する必要があります。

スキップボタンの位置

左から右に表記する言語の場合、スキップボタンは動画プレーヤーの右下に配置します。右から左に表記する言語の場合、スキップボタンは動画プレーヤーの左下に配置します。

スキップ ボタンのサイズ

ボタンとテキストは、くつろいでいるときにはっきりと読み取れる大きさにする必要があります。

テキストとアイコン

スキップボタンにはテキストとアイコンの両方が必要です。アイコン画像として「次のマテリアルにスキップ」アイコンを使用できます。

ユーザー補助

ユーザーがキーボードやリモコンを使用してスキップボタンに移動できるようにする必要があります。カウントダウンが完了すると、アプリはスキップボタンをフォーカスします。

多言語対応

スキップのテキストは、ユーザーの言語に翻訳することをおすすめします。

連続配信広告

スキップボタンを使用すると、連続配信広告内の現在の広告をスキップするか、連続配信広告全体をスキップできます。

「広告をスキップ」の翻訳

skipAdTranslations.json ファイルを使用して、ユーザーの言語 / 地域に基づいて「広告をスキップ」のテキストを翻訳します。