広告ブレークパラメータを使用する

広告ブレーク API を使用すると、広告ブレークパラメータを使用して広告タグパラメータを設定できます。これにより、広告ターゲティングの精度と広告サーバーとの統合が向上します。

広告タグのパラメータをオーバーライドする

Google DAI ストリームの広告タグパラメータをオーバーライドするには、広告ブレークの breakParams.adTagParams フィールドを設定します。詳しくは、ストリームにターゲティングパラメータを指定すると VAST 広告タグのすべてのパラメータをご覧ください。

次の例は、mridx（ミッドロール番号）クエリパラメータを含む DAI ストリームの広告タグを示しています。

https://pubads.g.doubleclick.net/gampad/live/ads?mridx=3&…

次のリクエスト例では、mridx ターゲティング値をオーバーライドする広告ブレークを作成します。

curl -X POST "https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -d '{
    "expectedDuration": "30s",
    "expectedStartTime": "2025-06-03T15:00:00Z",
    "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
    "customParams": "param1=value1&param2=value2",
    "podTemplateName": "podtemplate",
    "breakParams": {
      "adTagParams": [{"key": "mridx", "value": "7"}]
    }
  }'

次のように置き換えます。

NETWORK_CODE: Google アドマネージャーのネットワークコード。詳しくは、アドマネージャーのネットワークコードをご覧ください。
ASSET_KEY: ライブ配信イベントのアセットキー。詳細については、ライブリニアストリームの URL とアセットキーを確認するをご覧ください。
OAUTH_TOKEN：自分のアクセストークン。詳細については、OAuth2 で認証するをご覧ください。

DAI マクロを使用して広告タグを拡張する

Google DAI は、%%DAI_PATTERN:MACRO_NAME%% 形式の広告タグマクロをサポートしています。マクロ名は UPPER_CASE 形式にする必要があります。大文字の英字、数字、アンダースコアのみを使用できます。

これらのマクロを Google DAI ストリームの広告タグまたは DAI ストリームリクエストに挿入して、breakParams.macros フィールドの値でマクロを設定できます。

次の例は、BREAK_TYPE マクロを含む Google DAI ストリームの広告タグを示しています。

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%DAI_PATTERN:BREAK_TYPE%%&…

次のリクエストは、広告ブレークを更新し、BREAK_TYPE マクロ値を設定します。

curl -X PATCH 'https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks/AD_BREAK_ID' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer OAUTH_TOKEN' \
  -d '{
  "name": "networks/…/assets/…/adBreaks/bcc402a6-9880-4b8b-8e4a-a8cd3688f854",
  "expectedDuration": "30s",
  "expectedStartTime": "2025-06-03T15:10:00Z",
  "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
  "customParams": "param1=value1&param2=value2",
  "podTemplateName": "podtemplate"
  "breakState": "BREAK_STATE_SCHEDULED",
  "breakParams": {
    "macros": [{"key": "BREAK_TYPE", "value": "national"}]
  }
}'

AD_BREAK_ID は、実際の広告ブレーク ID に置き換えてください。

Google DAI は、マクロを含む広告タグを次のように解決します。

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&…

SCTE-35 マクロで広告タグを拡張する

Google DAI ライブストリームイベントを設定する際に、マスター広告タグに SCTE-35 マクロを配置できます。

ライブ配信イベントが開始されたら、コンテンツマニフェストに SCTE-35 データを挿入するか、scte35CueOut パラメータに SCTE-35 データを含めて DAI 広告ブレーク API を呼び出すことができます。Google DAI は、デコードされたデータを使用して広告タグの SCTE-35 マクロを設定します。

次の例では、%%TIME_SIGNAL_UPID_RAW%% マクロを使用しています。

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%TIME_SIGNAL_UPID_RAW%%&…

次の例では、JSON を使用して SCTE-35 のタイミングシグナルデータを説明します。

{
  "splice_info_section": {
    …
    "splice_command": {
      "command_name": "time_signal",
      "splice_time": {
        "time_specified_flag": 1,
        "pts_time": "123456789"
      }
    },
    "splice_descriptors": [
      {
        …
        "segmentation_upid": {
          "raw_hex": "0x6E6174696F6E616C", // UTF8 value: national
          …
        }
      }
    ]
  }
}

Google DAI は、SCTE-35 マクロを含む広告タグを次のように解決します。

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&…