Inviare notifiche di interruzione pubblicitaria anticipata

L'inserimento di annunci dinamici (DAI) di Google supporta i live streaming con un livello di concorrenza elevato. Le notifiche di interruzione pubblicitaria anticipata (EABN) sono richieste a Google DAI per pianificare un'imminente interruzione pubblicitaria o iniziare immediatamente le decisioni relative agli annunci, ottimizzando sia il tasso di riempimento degli annunci sia il tempo di caricamento.

Per iniziare a utilizzare le notifiche di interruzione pubblicitaria anticipata per il servizio completo, la pubblicazione di pod o l'inserimento di annunci guidati dal server, utilizza la risorsa AdBreaks. Questa risorsa può creare e gestire le interruzioni pubblicitarie per tutti i live streaming che crei tramite l'interfaccia utente di Google Ad Manager o l'API SOAP di Google Ad Manager LiveStreamEventService.

Questa pagina spiega come pianificare un'interruzione pubblicitaria come notifica di interruzione pubblicitaria anticipata.

Nota: se utilizzi la versione precedente dell'API Early Ad Break Notification, esegui l'upgrade alla risorsa AdBreaks per la parità e le funzionalità avanzate, come la programmazione di un'interruzione pubblicitaria e la query degli stati delle interruzioni pubblicitarie.

Prerequisiti

Per creare o gestire le interruzioni pubblicitarie, devi disporre di una chiave asset o di una chiave asset personalizzata generata dal sistema per il live streaming. Puoi trovare queste chiavi anche nella pagina dei dettagli del live streaming. Consulta Configurare un live streaming per DAI utilizzando la UI di Google Ad Manager.

Pianificare un'interruzione pubblicitaria

Puoi pianificare un'interruzione pubblicitaria quando le visualizzazioni del tuo stream aumentano. Per ogni evento in live streaming, pianifica singolarmente un'interruzione pubblicitaria con un massimo di sei ore di anticipo utilizzando il metodo di servizio Create. Includi l'ora di inizio prevista e l'ID interruzione pubblicitaria. La DAI inizia a prendere decisioni relative agli annunci poco prima dell'ora pianificata. Per le decisioni immediate relative alle interruzioni pubblicitarie, ometti l'ora di inizio prevista dell'interruzione pubblicitaria.

Per fare in modo che Google DAI inizi immediatamente a prendere decisioni sugli annunci, puoi omettere l'ora di inizio prevista dell'interruzione pubblicitaria quando chiami Create.

Nell'esempio seguente viene pianificata un'interruzione pubblicitaria per un evento in live streaming di tipo Linear che inizierà il 6 marzo 2025 alle 16:00 (ora universale coordinata). (UTC):

cURL

curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN' \
  -H 'content-type: application/json' \
  --data-raw '{"adBreakId":"mid-roll-1","assetKey":"ASSET_KEY","duration":"30s","expectedStartTime":"2025-03-06T16:00:00Z"}'

Node.js

fetch("https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks", {
    "headers": {
      "authorization":
        "Bearer ACCESS_TOKEN",
        "Content-Type": "application/json",
    },
  "body": JSON.stringify({
    "adBreakId": "mid-roll-1",
    "duration": "30s",
    "expectedStartTime": "2025-03-06T16:00:00Z"
  }),
  "method": "POST"
});

In caso di esito positivo, viene visualizzata la seguente risposta JSON:

{
  "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
  "adBreakId": "mid-roll-1",
  "assetKey": "...",
  "expectedStartTime": "2025-03-06T16:00:00Z",
  "duration": "30s",
  "breakState": "SCHEDULED"
}

Suggerimento: controlla la proprietà DynamicAdInsertionType dell'evento in live streaming. Se è POD_SERVING_REDIRECT o POD_SERVING_MANIFEST, consigliamo di passare un ID interruzione pubblicitaria personalizzato fornito dal manipolatore del manifest dello stream. In caso contrario, l'API genererà una stringa UUID per l'ID interruzione dell'annuncio.

Per eseguire query sulle interruzioni pubblicitarie, utilizza il metodo List. Per ispezionare i dettagli di un'interruzione pubblicitaria, utilizza il metodo Get.

L'esempio seguente elenca tutte le interruzioni pubblicitarie per un evento in live streaming:

cURL

curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN'

Node.js

fetch(
  "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks",
  {
    "headers": {
      "authorization": "Bearer ACCESS_TOKEN",
    },
    "method": "GET"
  }
);

In caso di esito positivo, viene visualizzata la seguente risposta JSON:

{
  "adBreaks": [
    {
      "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
      "adBreakId": "mid-roll-1",
      "assetKey": "...",
      "expectedStartTime": "2025-03-06T16:00:00Z",
      "duration": "30s",
      "breakState": "DECISIONED",
      "breakSequence": "1"
    }
  ]
}

Se vuoi riprogrammare l'attuale interruzione pubblicitaria in modo che inizi prima, utilizza il metodo Patch per modificare l'ora di inizio prevista. Se vuoi annullare l'interruzione pubblicitaria corrente, utilizza il metodo Delete prima che lo stato sia COMPLETED.

Per creare un'altra interruzione pubblicitaria, attendi che lo stato dell'interruzione pubblicitaria corrente sia COMPLETED.