Informazioni sull'API DAI Ad Break

L'API Dynamic Ads Insertion (DAI) Ad Break ti consente di creare e gestire i dati di targeting degli annunci e la tempistica delle interruzioni pubblicitarie imminenti nei tuoi live streaming.

Con l'API DAI Ad Break puoi:

  • Migliora il tasso di riempimento degli annunci durante il picco di traffico: dai ai servizi di inserimento di annunci dinamici (DAI) più tempo per selezionare gli annunci con il rendimento più elevato per i tuoi eventi live. Ti consigliamo l'API DAI Ad Break quando gli eventi del live streaming hanno un'alta concorrenza, tag annuncio dinamici o annunci a latenza elevata.
  • Assumi il pieno controllo delle interruzioni pubblicitarie: crea, aggiorna ed elimina le interruzioni pubblicitarie in anticipo, offrendo maggiore flessibilità rispetto alla segnalazione degli annunci nel manifest e un tasso di riempimento più elevato per la pubblicazione di pod rispetto al processo decisionale just-in-time.
  • Offrire un'esperienza di visione senza interruzioni: riduci al minimo gli errori di riproduzione correlati agli annunci, come pod pubblicitari non riempiti o riempiti in eccesso, 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 Ad Break

L'API espone i seguenti metodi standard per la gestione delle risorse AdBreak:

  • Create: definisce una nuova entità AdBreak per un'entità LiveStreamEvent. (Facoltativo) Imposta la proprietà expectedStartTime per pianificare una decisione dell'annuncio in modo che inizi entro 60 secondi prima dell'inizio della pausa pubblicitaria.
  • Get: recupera i dettagli di una specifica entità AdBreak, inclusi i metadati relativi allo stato e alla tempistica dell'interruzione pubblicitaria.
  • List: restituisce un elenco di entità AdBreak create in precedenza con l'API per una determinata entità LiveStreamEvent, ordinate in ordine cronologico inverso. Tieni presente che l'API non restituisce interruzioni pubblicitarie definite solo nel manifest del flusso di contenuti.
  • Update: modifica un'entità AdBreak esistente prima dell'inizio della decisione dell'annuncio.
  • Delete: annulla la decisione relativa all'annuncio per un'entità AdBreak creata in precedenza.

Comprendere 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 pubblicitaria.
  • BREAK_STATE_DECISIONED: I servizi DAI hanno avviato la procedura di selezione dell'annuncio per l'interruzione pubblicitaria. Non puoi modificare la pausa pubblicitaria, ma puoi comunque annullarla con potenziali effetti negativi sugli ad server.
  • BREAK_STATE_COMPLETE: l'interruzione pubblicitaria è stata mostrata agli utenti.

Il seguente diagramma mostra la cronologia di un'entità AdBreak, dalla creazione al completamento.

Entità interruzione pubblicitaria dalla creazione al completamento

Puoi creare un'entità AdBreak da 1 a 300 minuti prima dell'inizio previsto della pausa pubblicitaria.

  • Evita di creare un'interruzione pubblicitaria meno di un minuto prima dell'orario di inizio previsto dell'interruzione, in quanto Google DAI potrebbe non avere tempo sufficiente per prendere decisioni sugli annunci, causando un tasso di riempimento degli annunci inferiore.
  • Evita di creare un'interruzione pubblicitaria più di 6 ore prima dell'orario di inizio previsto, in quanto gli ad server potrebbero invalidare gli annunci richiesti.

Le sezioni seguenti descrivono le transizioni di stato delle interruzioni pubblicitarie nei flussi di DAI Full Service e Pod Serving.

Informazioni sul flusso DAI full-service

Il DAI full service di Google gestisce sia il manifest dei contenuti sia i pod di annunci.

Per il targeting degli annunci personalizzato, utilizza l'API DAI Ad Break per creare un'entità AdBreak prima del corrispondente marcatore pubblicitario nel manifest del live streaming dei contenuti.

  • Questo lead time consente ai servizi Google DAI di utilizzare i tuoi dati AdBreak per la decisione pubblicitaria.
  • Quando Google DAI rileva il marcatore pubblicità del manifest, il sistema utilizza le decisioni pubblicità con i dati dell'entità AdBreak e la transizione dello stato dell'entità a BREAK_STATE_COMPLETE.

Entità interruzione pubblicitaria dall'inizio alla fine nel flusso di pubblicazione di pod.

Informazioni sul flusso di pubblicazione dei pod

In questo flusso, gestisci il manifest del livestream dei contenuti o utilizza un servizio di manipolazione del manifest di terze parti per rilevare i marcatori pubblicitari 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 degli annunci.

Quando lo stitcher video rileva il marcatore pubblicità del manifest e crea richieste di segmenti pubblicitari con un ID interruzione pubblicitaria, Google DAI utilizza i dati AdBreak con lo stesso ID per le decisioni pubblicitarie.

Dopo che il client richiede i contenuti multimediali dell'annuncio, l'entità AdBreak che hai creato tramite l'API passa allo stato BREAK_STATE_COMPLETE.

Stato di completamento dell'entità interruzione pubblicitaria

Effettuare la prima richiesta

Per configurare l'accesso all'API ed effettuare la prima richiesta, consulta Utilizzare l'API DAI Ad Break.