Annunci ignorabili in streaming VOD

Questa guida illustra come utilizzare l'API DAI per richiedere uno stream VOD con annunci ignorabili, eseguire il rendering del pulsante Salta in base ai requisiti di Google Ads e inviare gli eventi di monitoraggio associati.

Prerequisiti

Effettuare una richiesta di annunci ignorabili

Per richiedere uno streaming VOD con annunci ignorabili, devi passare il parametro dai-sas nella richiesta di streaming.

Endpoint API

POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded

Parametri del percorso

{CMS_ID} L'ID CMS dello stream.
{VIDEO_ID} L'ID video dello stream.

Parametri corporei

dai-sas Imposta dai-sas=1 per attivare gli annunci ignorabili.

Richiesta di esempio (cURL)

Per le richieste di flussi HLS:

curl -X POST \
     -d 'dai-sas=1' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream

Sostituisci 'dash' nell'URL per gli stream DASH:

https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream

Utilizza il formato seguente per includere più parametri di streaming nel corpo della richiesta:

-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \

Gestire gli annunci da saltare

Per gestire la possibilità di saltare gli annunci, utilizza le informazioni nello struct Ad o nello struct AdBreak, a seconda che tu stia saltando l'annuncio corrente o l'intera interruzione pubblicitaria. Prendi il valore start e aggiungi il valore duration, quindi cerca fino a quel punto del flusso. Il sottomessaggio SkipMetadata include anche il valore offset, che è un valore espresso in secondi prima che l'annuncio possa essere ignorato. Il messaggio secondario SkipMetadata verrà incluso solo negli annunci ignorabili.

ad_breaks Un elenco di interruzioni pubblicitarie.
start (number) Posizione nello stream in cui inizia l'interruzione, in secondi.
duration (number) Durata dell'interruzione pubblicitaria, in secondi.
ads (object(Ad)) Un elenco di annunci nello stream.
start (numero) Posizione nello stream in cui viene avviato l'annuncio, in secondi.
duration (number) Durata dell'annuncio, in secondi.
skip_metadata (object(SkipMetadata)) Metadati facoltativi per gli annunci ignorabili. Se impostato, indica che l'annuncio è ignorabile e include istruzioni su come gestire l'interfaccia utente per ignorare l'annuncio e l'evento di monitoraggio.
offset (number) L'offset indica per quanto tempo in secondi il player deve attendere prima di visualizzare il pulsante Salta prima dell'inizio dell'annuncio. Omesso se non fornito nel VAST.
tracking_url (string) Un URL di cui deve essere inviato un ping all'evento skip.

Esempio di risposta

{
  ...
  "ad_breaks":[
    {
      ...
      "start":0,
      "duration":10,
      "ads":[
        {
          ...
          "start":0,
          "duration":10,
          "skip_metadata":{
            "offset": 5,
            "tracking_url": "https://example_skip_url.com"
          }
        }
    }
}

Una volta ignorato l'annuncio, invia un ping all'URL dell'evento di salto incluso nella risposta dello stream. È inclusa nel messaggio secondario SkipMetadata.

Requisiti del pulsante Salta

Per gli annunci ignorabili, visualizza il pulsante Salta con i seguenti requisiti di progettazione. Il mancato rispetto di questi requisiti può comportare l'applicazione di limitazioni agli annunci Google pubblicati sul tuo sito o nella tua app.

Timer conto alla rovescia

L'annuncio non deve essere ignorabile fino al giorno skipoffset specificato in VAST. Durante questo periodo in cui non puoi saltare l'annuncio, devi mostrare all'utente un avviso per informarlo che l'annuncio può essere saltato in X secondi. L'avviso deve essere tradotto nella lingua dell'utente.

Ignora posizione pulsante

Per una lingua da sinistra a destra, posiziona il pulsante Salta nell'angolo in basso a destra del video player. Per una lingua con scrittura da destra a sinistra, posiziona il pulsante Salta nella parte inferiore sinistra del video player.

Dimensioni pulsante Ignora

Il pulsante e il testo devono essere abbastanza grandi da essere chiaramente leggibili in un contesto di relax.

Testo e icona

Il pulsante Salta deve contenere sia testo sia icone. Puoi utilizzare l'icona Salta materiale successivo come iconografia.

Accessibilità

L'utente deve essere in grado di raggiungere il pulsante Salta utilizzando una tastiera o un telecomando. L'app dovrebbe impostare lo stato attivo sul pulsante Salta una volta completato il conto alla rovescia.

Internazionalizzazione

È consigliabile tradurre il testo ignorato nella lingua dell'utente.

Pod di annunci

Il pulsante Salta può essere utilizzato per saltare l'annuncio corrente nel pod di annunci o l'intero pod.

Traduzioni "Salta annuncio"

Utilizza il file skipAdTranslations.json per tradurre il testo "Salta annuncio" in base alle impostazioni internazionali dell'utente.