Usa parámetros de pausas publicitarias

La API de Ad Break te permite establecer los parámetros de la etiqueta del anuncio con los parámetros de la pausa publicitaria, lo que mejora la precisión de la segmentación de anuncios y la integración con los servidores de anuncios.

Anula los parámetros de la etiqueta de anuncio

Para anular los parámetros de la etiqueta de anuncio de la transmisión de DAI de Google, configura el campo breakParams.adTagParams de la pausa publicitaria. Para obtener más información, consulta Cómo proporcionar parámetros de segmentación a tus novedades y Todos los parámetros de las etiquetas de anuncios de VAST.

En el siguiente ejemplo, se muestra la etiqueta del anuncio de una transmisión de DAI que contiene el parámetro de consulta mridx (número de la pausa publicitaria):

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

En el siguiente ejemplo de solicitud, se crea una pausa publicitaria que anula el valor de segmentación 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"}]
    }
  }'

Reemplaza lo siguiente:

Expande la etiqueta de anuncio con macros de DAI

La DAI de Google admite macros de etiquetas de anuncios en formato %%DAI_PATTERN:MACRO_NAME%%. El nombre de la macro debe tener el formato UPPER_CASE y contener solo letras mayúsculas, números y guiones bajos.

Puedes insertar estas macros en la etiqueta de anuncio de la transmisión de DAI de Google o en la solicitud de transmisión de DAI para establecer las macros con los valores de tu campo breakParams.macros.

En el siguiente ejemplo, se muestra la etiqueta del anuncio de una transmisión de DAI de Google que contiene una macro de BREAK_TYPE:

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

La siguiente solicitud actualiza una pausa publicitaria y establece el valor de la 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"}]
  }
}'

Reemplaza AD_BREAK_ID por el ID de tu corte publicitario.

La DAI de Google resuelve la etiqueta de anuncio con la macro de la siguiente manera:

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

Expande la etiqueta de anuncio con macros SCTE-35

Cuando configures tu evento de transmisión en vivo de la DAI de Google, puedes colocar macros de SCTE-35 en la etiqueta del anuncio principal.

Cuando comience el evento de transmisión en vivo, puedes insertar datos de SCTE-35 en el manifiesto de contenido o llamar a la API de DAI Ad Break con los datos de SCTE-35 incluidos en el parámetro scte35CueOut. La DAI de Google usa los datos decodificados para completar las macros SCTE-35 en la etiqueta del anuncio.

En el siguiente ejemplo, se usa la macro %%TIME_SIGNAL_UPID_RAW%%:

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

En el siguiente ejemplo, se usa JSON para ilustrar los datos de un evento cronometrado 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
          …
        }
      }
    ]
  }
}

La DAI de Google resuelve la etiqueta de anuncio con la macro SCTE-35 de la siguiente manera:

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