使用廣告插播參數

您可以使用廣告插播參數，透過 Ad Break API 設定廣告代碼參數，提高廣告指定目標的準確度，並與廣告伺服器整合。

覆寫廣告代碼參數

如要覆寫 Google DAI 串流的廣告代碼參數，請設定廣告插播的 breakParams.adTagParams 欄位。詳情請參閱「為串流提供指定目標參數」和「所有 VAST 廣告代碼參數」一文。

以下範例顯示 DAI 串流的廣告代碼，其中包含 mridx (中途插播次數) 查詢參數：

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 Ad Manager 聯播網代碼。詳情請參閱「Ad Manager 聯播網代碼」。
ASSET_KEY：直播活動的資產金鑰。詳情請參閱「找出直播線性串流網址和素材資源金鑰」。
OAUTH_TOKEN：存取權杖。詳情請參閱「使用 OAuth2 進行驗證」。

使用 DAI 巨集展開廣告代碼

Google DAI 支援 %%DAI_PATTERN:MACRO_NAME%% 格式的廣告代碼巨集。巨集名稱必須採用 UPPER_CASE 格式，且只能包含大寫英文字母、數字和底線。

您可以在 Google 動態廣告插播串流的廣告代碼或動態廣告插播串流請求中插入這些巨集，並使用 breakParams.macros 欄位中的值設定巨集。

以下範例顯示 Google DAI 串流的廣告代碼，其中包含 BREAK_TYPE 巨集：

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 資料，或呼叫 DAI 廣告插播 API，並在 scte35CueOut 參數中加入 SCTE-35 資料。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&…