Utilizzare i parametri delle interruzioni pubblicitarie

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

Sostituire i parametri dei tag annuncio

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

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

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

La seguente richiesta di esempio crea un'interruzione pubblicitaria che esegue l'override del 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:

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.

L'esempio seguente mostra il tag annuncio di un flusso 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 di 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 temporizzati dell'indicatore 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&...