L'API DAI (inserimento di annunci dinamici) per le interruzioni pubblicitarie ti consente di creare e gestire i dati relativi alla tempistica e al targeting degli annunci delle interruzioni pubblicitarie imminenti nei tuoi live streaming.
Con l'API DAI Ad Break, puoi:
- Migliora il tasso di riempimento degli annunci durante i picchi di traffico: concedi ai servizi DAI più tempo per selezionare gli annunci con il rendimento più elevato per i tuoi eventi live. Ti consigliamo di utilizzare l'API DAI Ad Break quando i tuoi eventi in live streaming hanno un'elevata concorrenza, tag annuncio dinamici o annunci con latenza elevata.
- Assumi il pieno controllo delle interruzioni pubblicitarie: crea, aggiorna ed elimina le interruzioni pubblicitarie in anticipo, offrendo una maggiore flessibilità rispetto alla segnalazione degli annunci nel manifest e un tasso di riempimento più elevato per la pubblicazione di pod rispetto alle decisioni just-in-time.
- Offri un'esperienza di visione senza interruzioni: riduci al minimo gli errori di riproduzione correlati agli annunci, come i pod di annunci con un numero insufficiente o eccessivo di annunci, fornendo informazioni precise sulle interruzioni.
Questa guida descrive i metodi dell'API DAI Ad Break e illustra il ciclo di vita delle interruzioni pubblicitarie per i flussi DAI Full Service e Pod Serving.
Scopri i metodi dell'API DAI per le interruzioni pubblicitarie
L'API espone i seguenti metodi standard per la gestione delle risorse AdBreak:
Create: definisce una nuova entitàAdBreakper un'entitàLiveStreamEvent. Facoltativamente, imposta la proprietàexpectedStartTimeper pianificare una decisione relativa all'annuncio che inizi entro 60 secondi prima dell'inizio dell'interruzione pubblicitaria.Get: recupera i dettagli di un'entitàAdBreakspecifica, inclusi lo stato dell'interruzione pubblicitaria e i metadati relativi alla tempistica.List: restituisce un elenco di entitàAdBreakcreate in precedenza con l'API per una determinata entitàLiveStreamEvent, ordinate in ordine cronologico inverso. Tieni presente che l'API non restituisce le interruzioni pubblicitarie definite solo nel manifest dello stream di contenuti.Update: modifica un'entitàAdBreakesistente prima dell'inizio della decisione sull'annuncio.Delete: annulla la decisione relativa all'annuncio per un'entitàAdBreakcreata in precedenza.
Comprendi il ciclo di vita delle interruzioni pubblicitarie
Un'entità AdBreak ha i seguenti stati:
BREAK_STATE_UNSPECIFIED: lo stato predefinito.BREAK_STATE_SCHEDULED: l'interruzione pubblicitaria è stata creata e pianificata correttamente per la decisione sull'annuncio.BREAK_STATE_DECISIONED: i servizi DAI hanno avviato il processo di selezione degli annunci per l'interruzione pubblicitaria. Non puoi modificare l'interruzione pubblicitaria, ma puoi comunque annullarla con potenziali effetti negativi sugli ad server.
BREAK_STATE_COMPLETE: l'interruzione pubblicitaria è stata pubblicata per gli utenti.BREAK_STATE_EXPIRED: l'interruzione pubblicitaria è scaduta prima della pubblicazione. Applicabile solo quando attivi la pianificazione di più interruzioni nell'evento di live streaming. Per maggiori dettagli, consulta Impostazioni interruzione annuncio mid-roll. Per impostazione predefinita, le interruzioni pubblicitarie scadono 30 minuti dopo il valore del campoexpectedStartTimeo 30 minuti dopo l'inizio della decisione se non imposti il campoexpectedStartTime. Puoi personalizzare questa durata utilizzando il campoexpireDuration.
Il seguente diagramma mostra la cronologia di un'entità AdBreak, dalla creazione al completamento.

Puoi creare un'entità AdBreak da 1 a 300 minuti prima dell'inizio previsto dell'interruzione pubblicitaria.
- Evita di creare un'interruzione pubblicitaria meno di un minuto prima dell'ora di inizio prevista, poiché Google DAI potrebbe non avere tempo sufficiente per le decisioni sugli annunci, causando un tasso di riempimento degli annunci inferiore.
- Evita di creare un'interruzione pubblicitaria più di 6 ore prima dell'ora di inizio prevista, poiché gli ad server potrebbero invalidare gli annunci richiesti.
Le sezioni seguenti illustrano le transizioni di stato delle interruzioni pubblicitarie nei flussi DAI Full Service e Pod Serving.
Informazioni sul flusso DAI con servizio completo
La funzionalità DAI di Google con servizio completo gestisce sia il manifest dei contenuti sia i pod di annunci.
Per il targeting degli annunci personalizzati, utilizza l'API DAI Ad Break per creare un'entità AdBreak prima del corrispondente indicatore di interruzione pubblicitaria nel manifest del live streaming dei contenuti.
- Questo tempo di risposta consente ai servizi Google DAI di utilizzare i dati
AdBreakper la decisione relativa agli annunci. - Quando Google DAI rileva l'indicatore dell'annuncio nel manifest, il sistema utilizza le decisioni sugli annunci con i dati dell'entità
AdBreake cambia lo stato dell'entità inBREAK_STATE_COMPLETE.
Quando attivi la pianificazione di più interruzioni nell'evento in live streaming, puoi impostare il campo matchParams su un'entità AdBreak. Questo processo consente a Google DAI di abbinare i marker degli annunci del manifest rilevati alle interruzioni pubblicitarie nello stato BREAK_STATE_SCHEDULED o BREAK_STATE_DECISIONED.

Informazioni sul flusso di pubblicazione dei pod
In questo flusso, gestisci il manifest del live streaming dei contenuti o utilizzi un servizio di manipolazione del manifest di terze parti per rilevare i marker degli annunci nel manifest.
Chiama l'API DAI Ad Break prima dell'ora di inizio prevista dell'interruzione pubblicitaria per creare un'entità AdBreak prima di dover richiedere i segmenti del pod di annunci o il manifest dell'annuncio.
Quando Video Stitcher rileva l'indicatore di annuncio del manifest ed effettua richieste di segmenti di annunci con un ID interruzione pubblicitaria, Google DAI utilizza i dati AdBreak con lo stesso ID per le decisioni relative agli annunci.
Dopo che il client richiede i contenuti multimediali dell'annuncio, l'entità AdBreak creata tramite l'API passa allo stato BREAK_STATE_COMPLETE.

Effettua la tua prima richiesta
Per configurare l'accesso all'API ed effettuare la prima richiesta, consulta Utilizza l'API DAI per le interruzioni pubblicitarie.