Annunci ignorabili in streaming VOD

Questa guida illustra come utilizzare l'API DAI per richiedere uno streaming VOD con ignorabili, il pulsante Salta annuncio viene visualizzato in base requisiti di Google Ads, e inviare gli eventi di monitoraggio associati.

Prerequisiti

Effettuare una richiesta di annunci ignorabili

Per richiedere uno stream VOD con annunci ignorabili, devi trasmettere dai-sas nel tuo 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 stream nel Corpo:

-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 nella Ad o lo struct o AdBreak struct a seconda che tu stia saltando l'annuncio corrente o l'intera interruzione pubblicitaria. Prendi il valore start e aggiungi il valore duration, poi vai a quel punto durante lo streaming. La SkipMetadata include anche il valore offset, che è un valore in secondi prima che sia possibile saltare l'annuncio. 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 annunci. Se impostato, indica che l'annuncio è ignorabile e include istruzioni su come gestire l'interfaccia utente "Salta" e l'evento di monitoraggio.
offset (numero) L'offset indica la quantità di tempo in secondi dall'annuncio che il player deve attendere prima di Ignora. Omesso se non fornito nel VAST.
tracking_url (string) Un URL di cui deve essere inviato un ping quando si salta .

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 il seguente design i tuoi requisiti. 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 non ignorabile, devi mostrare all'utente un avviso per informare che l'annuncio può essere saltato in X secondi. La notifica deve essere tradotta la lingua dell'utente.

Ignora posizione pulsante

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

Dimensioni pulsante Ignora

Il pulsante e il testo devono essere abbastanza grandi da risultare chiaramente leggibili in posizione sdraiata un'esperienza senza intervento manuale.

Testo e icona

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

Accessibilità

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

Internazionalizzazione

Ti consigliamo di 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 l'intero pod.

"Salta annuncio" traduzioni

Utilizza le funzionalità di il file skipAdTranslations.json per la traduzione di "Salta annuncio" in base alle impostazioni internazionali dell'utente.