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
- Un'app che implementa le chiamate API DAI per gli stream VOD. Per ulteriori informazioni, consulta la guida allo streaming VOD dell'API DAI.
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.
|
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.