使用广告插播时间点参数

借助广告插播时间点 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"}]
    }
  }'

替换以下内容：

使用 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 数据，也可以调用 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&…