DAI API はベータ版であり、ネットワークによっては利用できない場合があります。詳しくは、アカウントマネージャーにお問い合わせください。IMA SDK が利用可能なプラットフォームには、IMA SDK の使用をおすすめします。

このページは Cloud Translation API によって翻訳されました。

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

このガイドでは、DAI API を使用して VOD ストリームをリクエストする方法をスキップボタンを表示する場合は Google 広告の要件関連するトラッキングイベントを送信します

前提条件

VOD ストリームの DAI API 呼び出しを実装するアプリ。詳しくは、 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 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

リクエストに複数のストリームパラメータを含めるには、次の形式を使用します。 body:

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

広告のスキップを処理する

広告のスキップを処理するには、 Ad 構造体または AdBreak 現在の広告をスキップするか、ミッドロール挿入点全体をスキップするかに応じて、構造体を指定します。 start 値を取得して duration 値を追加し、その時点までシークするクリックします。「 SkipMetadata サブメッセージには offset 値も含まれます。これは、広告をスキップできるようになるまでの秒数。SkipMetadata サブメッセージスキップ可能な広告にのみ含まれるようになります。

ad_breaks

ミッドロール挿入点のリスト。

start （数値）ブレークを開始するストリーム内の位置（秒単位）。

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 秒後にスキップできることを知らせますこの通知は、表示されます。

スキップボタンの位置

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

スキップボタンのサイズ

ボタンとテキストは、寄り添いでもはっきりと読み取れる大きさにする必要があります体験できます

テキストとアイコン

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

ユーザー補助

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

国際化

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

連続配信広告

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

'広告をスキップ'翻訳

使用 skipAdTranslations.json ファイル [広告をスキップ]を翻訳してテキストを自動的に作成します。