Attivare gli annunci ignorabili negli stream VOD

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

Prerequisiti

• Un'app che implementa chiamate all'API DAI per gli stream VOD. Per ulteriori informazioni, consulta la sezione Richiedere stream VOD DAI.

Inviare una richiesta di annunci ignorabili

Per richiedere uno stream 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 del corpo

dai-sas

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

Richiesta di esempio (cURL)

Per le richieste di stream 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 seguente formato per includere più parametri stream nel corpo della richiesta:

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

Gestire il salto degli annunci

Per gestire il salto degli annunci, utilizza le informazioni nella struttura Ad o 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 vai a quel punto dello stream. Il messaggio secondario SkipMetadata include anche il valore offset, ovvero il tempo in secondi prima che l'annuncio possa essere saltato. Il messaggio secondario SkipMetadata verrà incluso solo negli annunci ignorabili.

ad_breaks

Un elenco di interruzioni pubblicitarie. start (number) Posizione in cui inizia l'interruzione nello stream, in secondi. duration (number) Durata dell'interruzione pubblicitaria, in secondi. ads (object(Ad)) Un elenco di annunci nello stream. start (number) Posizione in cui inizia l'annuncio nello stream, 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 di salto e l'evento di monitoraggio. offset (number) L'offset indica il numero di secondi di riproduzione dell'annuncio dopo i quali il player deve attendere per visualizzare il pulsante Salta. Omesso se non specificato in VAST. tracking_url (stringa) Un URL a cui deve essere inviato un ping nell'evento di salto.

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, esegui un ping all'URL evento skip incluso nella risposta dello stream. È incluso nel messaggio secondario SkipMetadata.

Requisiti del pulsante Salta

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

Timer conto alla rovescia

L'annuncio non deve essere ignorabile fino al momento skipoffset specificato nel file VAST. Durante questo periodo non ignorabile, devi mostrare all'utente una notifica che lo informi che l'annuncio può essere ignorato tra X secondi. L'informativa deve essere tradotta nella lingua dell'utente.

Posizione del pulsante Salta

Per una lingua da sinistra a destra, posiziona il pulsante Avanti nella parte in basso a destra del video player. Per una lingua da destra a sinistra, posiziona il pulsante di avanzamento sul lato in basso a sinistra del video player.

Dimensioni del pulsante Salta

Il pulsante e il testo devono essere abbastanza grandi da essere chiaramente leggibili in un'esperienza di visualizzazione rilassata.

Testo e icona

Il pulsante di avanzamento deve avere sia testo che iconografia. Puoi utilizzare l'icona di passaggio al materiale successivo come iconografia.

Accessibilità

L'utente deve essere in grado di accedere al pulsante di avanzamento utilizzando una tastiera o un telecomando. Al termine del conto alla rovescia, l'app dovrebbe mettere in primo piano il pulsante Salta.

Internazionalizzazione

Ti consigliamo di tradurre il testo di scambio nella lingua dell'utente.

Pod di annunci

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

Traduzioni di "Salta annuncio"

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