Utilizzare i parametri delle interruzioni pubblicitarie

L'API Ad Break ti consente di impostare i parametri dei tag annuncio utilizzando i parametri delle interruzioni pubblicitarie, il che migliora la precisione del targeting degli annunci e l'integrazione con gli ad server.

Eseguire l'override dei parametri dei tag annuncio

Per ignorare i parametri del tag annuncio dello stream Google DAI, imposta il campo breakParams.adTagParams della pausa pubblicitaria. Per ulteriori informazioni, consulta Fornire parametri di targeting alla riproduzione in streaming e Tutti i parametri dei tag annuncio VAST.

Il seguente esempio mostra il tag annuncio di uno stream DAI contenente il parametro di query mridx (numero mid-roll):

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

La seguente richiesta di esempio crea un'interruzione pubblicitaria che sostituisce il valore di targeting 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"}]
    }
  }'

Sostituisci quanto segue:

NETWORK_CODE: il codice di rete Google Ad Manager. Per saperne di più, consulta Codice di rete Ad Manager.
ASSET_KEY: la chiave asset dell'evento live streaming. Per maggiori informazioni, consulta la sezione Trovare l'URL di un live streaming lineare e la chiave asset.
OAUTH_TOKEN: il tuo token di accesso. Per saperne di più, consulta Eseguire l'autenticazione con OAuth2.

Espandere il tag annuncio con le macro DAI

Google DAI supporta le macro dei tag annuncio nel formato %%DAI_PATTERN:MACRO_NAME%%. Il nome della macro deve essere nel formato UPPER_CASE e contenere solo lettere maiuscole, numeri e trattini bassi.

Puoi inserire queste macro nel tag annuncio dello stream DAI di Google o nella richiesta di stream DAI per impostare le macro con i valori nel campo breakParams.macros.

Il seguente esempio mostra il tag annuncio di uno stream Google DAI contenente una macro BREAK_TYPE:

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

La seguente richiesta aggiorna un'interruzione pubblicitaria e imposta il valore della 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"}]
  }
}'

Sostituisci AD_BREAK_ID con l'ID della pausa pubblicitaria.

Google DAI risolve il tag annuncio con la macro nel seguente modo:

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

Espandere il tag annuncio con le macro SCTE-35

Quando configuri l'evento di live streaming Google DAI, puoi inserire macro SCTE-35 nel tag annuncio principale.

Quando inizia l'evento live streaming, puoi inserire i dati SCTE-35 nel manifest dei contenuti o chiamare l'API DAI Ad Break con i dati SCTE-35 inclusi nel parametro scte35CueOut. Google DAI utilizza i dati decodificati per compilare le macro SCTE-35 nel tag annuncio.

L'esempio seguente utilizza la macro %%TIME_SIGNAL_UPID_RAW%%:

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

L'esempio seguente utilizza JSON per illustrare i dati di un segnale temporizzato 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 risolve il tag annuncio con la macro SCTE-35 nel seguente modo:

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