Как использовать параметры рекламной паузы

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"}]
    }
  }'

Замените следующее:

Как развернуть тег объявления с помощью макросов DAI

Динамическая вставка объявлений в Google поддерживает макросы тегов объявлений в формате %%DAI_PATTERN:MACRO_NAME%%. Название макроса должно быть в формате UPPER_CASE и содержать только прописные буквы, цифры и символы подчеркивания.

Вы можете вставить эти макросы в тег объявления или запрос трансляции с динамической вставкой объявлений, чтобы задать для них значения из поля 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 идентификатором рекламной паузы.

Google DAI обрабатывает тег объявления с макросом следующим образом:

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

Как развернуть тег объявления с помощью макросов SCTE-35

При настройке события прямой трансляции с динамической вставкой объявлений от Google вы можете разместить макросы SCTE-35 в основном теге объявления.

Когда начнется трансляция, вы сможете вставить данные SCTE-35 в манифест контента или вызвать API рекламной паузы DAI, включив данные SCTE-35 в параметр scte35CueOut. 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 тег объявления с макросом SCTE-35 обрабатывается следующим образом:

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