Scopri di più sull'API DAI Ad Break

L'API Dynamic Ad Insertion (DAI) Ad Break ti consente di creare e gestire i dati di targeting 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 i picchi di traffico: dai più tempo ai servizi DAI per selezionare gli annunci con il rendimento più elevato per i tuoi eventi live. Ti consigliamo l'API interruzione pubblicitaria DAI quando i tuoi eventi live streaming hanno un'elevata 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.
  • Offri un'esperienza di visione senza interruzioni: riduci al minimo gli errori di riproduzione correlati agli annunci, ad esempio i pod di annunci sottoriempiti o sovraempiti, 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à 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 dell'interruzione 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 pubblicitaria 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 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.

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 dell'interruzione pubblicitaria.

  • Evita di creare un'interruzione pubblicitaria meno di un minuto prima dell'ora di inizio prevista dell'interruzione, in quanto 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, in quanto gli ad server potrebbero invalidare gli annunci richiesti.

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

Informazioni sul flusso DAI full-service

La tecnologia 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 tempo di risposta 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 pubblicitarie con i dati dell'entità AdBreak e la transizione dello stato dell'entità a BREAK_STATE_COMPLETE.

Entità interruzione pubblicitaria dalla creazione al completamento nel flusso DAI full-service.

Comprendere il 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 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 dell'annuncio.

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

Dopo che il cliente ha richiesto 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.

Effettua la tua prima richiesta

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