Эта страница переведена с помощью Cloud Translation API.

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

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 : ключ ресурса вашего события прямой трансляции. Для получения дополнительной информации см. раздел «Как найти URL-адрес и ключ ресурса прямой линейной трансляции» .
OAUTH_TOKEN : ваш токен доступа. Для получения дополнительной информации см. раздел «Аутентификация с помощью OAuth2» .

Разверните рекламный тег с помощью макросов DAI.

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

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

Когда начнётся прямая трансляция, вы можете вставить данные SCTE-35 в манифест контента или вызвать API DAI Ad Break, указав данные 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%%&…

В следующем примере для иллюстрации данных временного сигнала SCTE-35 используется формат JSON:

{
  "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&…