Usar parâmetros de intervalo de anúncio

A API Ad Break permite definir os parâmetros da tag de anúncio usando parâmetros de intervalo de anúncio, o que aumenta a precisão da segmentação de anúncios e a integração com servidores de anúncios.

Modificar parâmetros da tag de anúncio

Para substituir os parâmetros da tag de anúncio do stream da DAI do Google, defina o campo breakParams.adTagParams do intervalo de anúncio. Para mais informações, consulte Fornecer parâmetros de segmentação ao stream e Todos os parâmetros da tag de anúncio VAST.

O exemplo a seguir mostra uma tag de anúncio de stream da DAI que contém o parâmetro de consulta mridx (número do anúncio intermediário):

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

A solicitação de exemplo a seguir cria um intervalo de anúncio que substitui o valor de segmentação 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"}]
    }
  }'

Substitua:

NETWORK_CODE: seu código de rede do Google Ad Manager. Para mais informações, consulte Código da rede do Ad Manager.
ASSET_KEY: a chave do recurso do evento de transmissão ao vivo. Para mais informações, consulte Encontrar um URL de transmissão linear ao vivo e uma chave de recurso.
OAUTH_TOKEN: seu token de acesso. Para mais informações, consulte Autenticar com OAuth2.

Expandir a tag de anúncio com macros da DAI

A DAI do Google é compatível com macros de tag de anúncio no formato %%DAI_PATTERN:MACRO_NAME%%. O nome da macro precisa estar no formato UPPER_CASE e conter apenas letras maiúsculas, números e sublinhados.

Você pode inserir essas macros na tag de anúncio do fluxo de DAI do Google ou na solicitação de fluxo de DAI para definir as macros com os valores no campo breakParams.macros.

O exemplo a seguir mostra uma tag de anúncio de stream da DAI do Google que contém uma macro BREAK_TYPE:

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

A solicitação a seguir atualiza um intervalo de anúncio e define o valor da macro 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"}]
  }
}'

Substitua AD_BREAK_ID pelo ID do seu intervalo de anúncio.

A DAI do Google resolve a tag de anúncio com a macro da seguinte forma:

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

Expandir a tag de anúncio com macros SCTE-35

Ao configurar seu evento de transmissão ao vivo da DAI do Google, você pode inserir macros SCTE-35 na tag de anúncio principal.

Quando o evento de transmissão ao vivo começar, insira os dados SCTE-35 no manifesto de conteúdo ou chame a API de intervalo de anúncios da DAI com os dados SCTE-35 incluídos no parâmetro scte35CueOut. A DAI do Google usa os dados decodificados para preencher as macros SCTE-35 na tag de anúncio.

O exemplo a seguir usa a macro %%TIME_SIGNAL_UPID_RAW%%:

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

O exemplo a seguir usa JSON para ilustrar dados de um indicador de tempo 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
          …
        }
      }
    ]
  }
}

A DAI do Google resolve a tag de anúncio com a macro SCTE-35 da seguinte forma:

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