このガイドでは、DAI API を使用してスキップ可能な広告を含む VOD ストリームをリクエストし、Google 広告の要件に従ってスキップボタンをレンダリングし、関連するトラッキング イベントを送信する方法について説明します。
前提条件
- VOD ストリームの DAI API 呼び出しを実装したアプリ。詳しくは、DAI 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 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
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 構造または AdBreak 構造の情報を使用します。start 値を取得して duration 値を追加し、ストリーム内のそのポイントにシークします。SkipMetadata サブメッセージには、広告をスキップできるまでの時間（秒単位）の値である offset 値も含まれます。SkipMetadata サブメッセージは、スキップ可能な広告にのみ含まれます。
ad_breaks |
ミッドロール挿入点のリスト。
|
レスポンスの例
{
...
"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 ファイルを使用して、ユーザーの言語 / 地域に基づいて「広告をスキップ」テキストを翻訳します。