Annunci video

Questa guida illustra i requisiti di integrazione, la configurazione e i campi del protocollo OpenRTB pertinenti che puoi utilizzare per fare offerte sull'inventario video. Il protocollo RTB di Google è deprecato e non sarà oggetto di attenzione in questa guida. Per informazioni sugli annunci video nel protocollo RTB di Google, consulta la guida Annunci video nel protocollo RTB di Google.

Google supporta gli annunci video in-stream, nativi e interstitial. Per ulteriori dettagli su questi formati, consulta le guide per gli annunci nativi e interstitial.

Requisiti dell'acquirente

Protocollo RTB

In genere, questa guida fa riferimento al formato Protobuf, ma i nomi dei campi e i percorsi sono equivalenti tra questo formato e il formato JSON, se non diversamente specificato.

Puoi trovare il protocollo OpenRTB e le estensioni OpenRTB specifiche di Google nella pagina Proto e dati di riferimento. Per maggiori informazioni sullo sviluppo di un offerente, consulta Elaborare la richiesta e Creare la risposta.

Revisione delle creatività

Google consiglia di inviare le creatività per l'approvazione prima di fare offerte con queste. Puoi utilizzare la risorsa Creatives dell'API Real-time Bidding per avviare la procedura di revisione.

Configurazione del pretargeting

Per ricevere l'inventario video, il tuo account Authorized Buyers deve creare una configurazione di pretargeting che includa l'inventario video.

Macro

Puoi specificare le macro nel link all'URL del video o nel file XML VAST specificato in BidResponse.seatbid.bid.adm. Inoltre, se specifichi un URL video, puoi anche inserire macro all'interno del documento XML VAST collegato. Per le creatività video sono supportate le seguenti macro:

  • %%CACHEBUSTER%%
  • %%WINNING_PRICE%%
  • %%SITE%%

Le macro clic come CLICK_URL_ESC non sono supportate perché Authorized Buyers include i propri tracker dei clic in un wrapper VAST. Per ulteriori informazioni sulle macro supportate, consulta la sezione Specificare le macro.

Dettagli callout

Puoi utilizzare il campo BidRequest.imp.video di OpenRTB per identificare se una richiesta di offerta in arrivo riguarda l'inventario video in-stream o interstitial e trovare ulteriori informazioni specifiche sul video relative alla richiesta. Inoltre, per l'inventario di annunci nativi, puoi utilizzare BidRequest.imp.native.{request/request_native}.assets.video per informazioni simili specifiche per i video.

BidRequest.{app/site}.content.producer.domain

L'URL, con i parametri rimossi, della pagina che descrive i contenuti del video. L'editore invia questo URL a Google. Ad esempio:

http://www.publisher.com/watchpagelink
banner.vcm
Se impostato su true, l'annuncio companion può essere scelto per essere visualizzato come elemento finale (scheda informativa) nell'area video al termine della riproduzione dell'annuncio video. In caso contrario, l'annuncio companion non viene visualizzato come immagine statica finale.
BidRequest.imp.rwdd
Se impostato su true, indica che l'utente riceve un premio per aver guardato l'annuncio video. I premi tipici possono essere la lettura di un articolo extra senza costi, la ricezione di una vita extra in un gioco o la fruizione di una sessione di musica senza annunci sponsorizzata.
BidRequest.imp.video.maxduration

La durata massima consentita in secondi dell'annuncio da restituire. Se non viene impostato, non è prevista una durata massima. Quando BidRequest.imp.video.skip è true, il comportamento può essere diverso. Per ulteriori dettagli, consulta la sezione Durata massima video ignorabili.

BidRequest.imp.video.maxseq

Il numero massimo di annunci nel pod video. Se non impostato, l'area annunci non fa parte di un pod video.

Il numero effettivo di annunci video mostrati può essere inferiore o uguale a questo valore, ma non può superarlo.

BidRequest.imp.video.minduration
La durata minima in secondi dell'annuncio da restituire. Se non è impostato, non è prevista una durata minima.
BidRequest.imp.video.plcmt
Descrive dove verrà riprodotto il video.
PLCMT_UNKNOWN Il posizionamento è sconosciuto o non determinabile.
PLCMT_INSTREAM Annunci pre-roll, mid-roll e post-roll riprodotti prima, durante o dopo i contenuti video in streaming richiesti dal consumatore. Il video in-stream deve essere impostato su "Audio attivo" per impostazione predefinita all'avvio del player o avere l'intenzione esplicita dell'utente di guardare i contenuti video. Anche se possono essere presenti altri contenuti intorno al player, i contenuti video devono essere l'oggetto della visita dell'utente. Deve rimanere il contenuto principale della pagina e l'unico video player in-view in grado di riprodurre l'audio durante la riproduzione. Se il visualizzatore viene convertito in popup/fisso, le chiamate agli annunci successive devono indicare con precisione le dimensioni aggiornate del visualizzatore.
PLCMT_ACCOMPANYING_CONTENT Annunci pre-roll, mid-roll e post-roll riprodotti prima, durante o dopo lo streaming di contenuti video. Il video player viene caricato e riprodotto prima, tra o dopo paragrafi di testo o contenuti illustrati e inizia a essere riprodotto solo quando entra nell'area visibile. La riproduzione dei contenuti aggiuntivi deve iniziare solo quando entrano nell'area visibile. Potrebbe essere convertito in un player fisso/floating quando scompare dalla pagina.
PLCMT_INTERSTITIAL Annunci video riprodotti senza contenuti video. Durante la riproduzione, deve essere l'elemento principale della pagina, occupare la maggior parte dell'area visibile e non essere nascosto dallo scorrimento. ad esempio in posizionamenti come video in-app o presentazioni.
PLCMT_NO_CONTENT_STANDALONE Annunci video riprodotti senza contenuti video in streaming. Questi annunci possono essere pubblicati in posizionamenti come presentazioni, feed nativi, in-content o in primo piano/galleggianti.
BidRequest.imp.video.playbackmethod
Descrive come riprodurre l'annuncio video. Il metodo di riproduzione viene stabilito come riproduzione automatica o click-to-play in base alla misurazione migliore disponibile.
AUTO_PLAY_SOUND_ON Si avvia al caricamento della pagina con l'audio attivo.
AUTO_PLAY_SOUND_OFF Si avvia al caricamento della pagina con l'audio disattivato.
CLICK_TO_PLAY Si avvia al clic con l'audio attivo.
MOUSE_OVER Si avvia al passaggio del mouse con l'audio attivo.
ENTER_SOUND_ON Si avvia quando il video viene visualizzato con l'audio attivo.
ENTER_SOUND_OFF Si avvia all'ingresso nell'area visibile con l'audio disattivato per impostazione predefinita.
BidRequest.imp.video.skip
Se true, indica che il player consente di saltare il video o che sono consentiti gli annunci ignorabili. In caso contrario, indica che gli annunci ignorabili non sono consentiti.
BidRequest.imp.video.startdelay

Un valore pari a 0 indica pre-roll, -1 indica mid-roll e -2 indica post-roll.

Qualsiasi altro valore positivo indica il tempo in secondi dall'inizio del video al punto in cui viene visualizzato l'annuncio.

Questi indicatori non sono specifici per le creatività video, ma sono particolarmente utili per gli offerenti:

BidRequest.device.ifa
Questo campo è un UUID di 36 caratteri che viene impostato solo quando si utilizza SSL e non viene sottoposto ad hashing. È la versione non criptata di BidRequest.device.dpidm5. Per i dispositivi iOS, contiene l'IDFA (Identifier for Advertisers) in lettere maiuscole. Per i dispositivi Android, contiene l'identificatore Android (ADID) in lettere minuscole. Per i dispositivi TV connessi a internet, contiene i relativi identificatori univoci (ad esempio il RIDA di Roku).
BidRequest.device.devicetype
Specifica il tipo di dispositivo.
MOBILE Un alias obsoleto per HIGHEND_PHONE o TABLET.
PERSONAL_COMPUTER Sono inclusi i computer desktop e i laptop.
CONNECTED_TV include sia le TV connesse a internet (ovvero le smart TV) sia i dispositivi connessi (come Roku, Apple TV e così via).
HIGHEND_PHONE Sono inclusi i telefoni di fascia alta.
TABLET Sono inclusi i tablet.
CONNECTED_DEVICE Sono inclusi i dispositivi di gioco dedicati.
SET_TOP_BOX Sono inclusi i dispositivi set-top box.
OOH_DEVICE Sono inclusi i dispositivi pubblicitari out of home, ad esempio i cartelloni digitali.
BidRequest.device.make
Specifica il brand (ad esempio Nokia o Samsung) del dispositivo.
BidRequest.device.model
Specifica il modello esatto (ad esempio N70 o Galaxy) del dispositivo, se disponibile, altrimenti contiene un modello generico come "iphone" o "ipad".
BidRequest.imp.metric
Quando Metric.type è impostato su completion_rate, Metric.value sarà una frazione nell'intervallo [0,0, 1,0] che rappresenta il tasso di completamento storico degli annunci video pubblicati nell'area annuncio. Il valore predefinito -1.0 indica che i dati storici sul tasso di completamento non sono disponibili.
BidRequest.imp.video.poddur
La durata in secondi dell'intera interruzione pubblicitaria, inclusi tutti gli spazi di cui è composto il pod. Viene impostato sul valore specificato nei metadati del video forniti dal publisher del video.

La richiesta di offerta video contiene anche informazioni sull'inventario, come la verticale, i fornitori consentiti e le informazioni sul canale. Tutti gli altri campi esistenti nella richiesta di offerta si applicano anche ai video.

I campi larghezza e altezza nel messaggio AdSlot di una richiesta video corrispondono alle dimensioni del video player dell'annuncio.

BidRequest.imp.ext.allowed_vendor_type
I fornitori consentiti. Per un elenco degli ID, consulta il file vendors.txt nella documentazione tecnica. Ad esempio, 309 = unità video DFA.
BidRequest.imp.video.mimes
Una lista consentita che descrive i tipi MIME dei contenuti supportati per gli annunci pubblicati in risposta alla richiesta di offerta, ad esempio "video/mp4". La risposta all'offerta deve indicare il supporto per almeno uno di questi.
BidRequest.imp.video.protocols
Descrive le versioni VAST supportate da un publisher per le richieste di annunci video. Contiene un array di valori enumerati Protocol, tra cui: VAST_2_0, VAST_3_0, VAST_2_0_WRAPPER, VAST_3_0_WRAPPER, VAST_4_0, VAST_4_0_WRAPPER e altri.
BidRequest.imp.video.companionad
Questo campo include un array di oggetti Banner che rappresentano gli annunci companion, se disponibili.
BidRequest.site.page

L'URL della pagina di visualizzazione del video o l'URL della pagina in cui è stato incorporato il video. Ad esempio:

http://www.publisher.com/watchpagelink

Quando risponde a una richiesta di video, l'offerente deve restituire un URL di reindirizzamento VAST o un XML VAST nel campo BidResponse.seatbid.bid.adm. La risposta all'offerta deve contenere anche la dichiarazione corretta per l'annuncio video. Di seguito è riportato un estratto di una risposta all'offerta video corretta: 

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

I campi importanti di una risposta all'offerta video sono i seguenti:

BidResponse.seatbid.bid.ext.attribute
Gli attributi per gli annunci che possono essere visualizzati da questo snippet. Consulta il file buyer-declarable-creative-attributes.txt per l'elenco degli ID. Controlliamo che nessuno di questi attributi corrisponda a quelli non consentiti dal publisher nella richiesta di offerta. Ad esempio, se uno dei campi include 30, indicarà che l'annuncio richiede il supporto di VPAID per il rendering.
BidResponse.seatbid.bid.adm

Per gli annunci video, si tratta dell'URL di reindirizzamento VAST dell'annuncio video. Ad esempio:

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

In alternativa, potrebbe trattarsi di XML VAST non elaborato.

Esempi di richieste di offerta e risposte

Formati video

In che modo gli acquirenti possono includere il video

Le tabelle seguenti illustrano i modi in cui i buyer possono includere video nelle creatività e i posizionamenti in cui possono essere pubblicati rispettivamente per il web e le app mobile.

Web

Creatività video In-stream (tutti) In-feed/in-article In-feed/articolo nativo Interstitial In-banner

VPAID + VAST

 

VAST

 

MRAID + JS

 

 

 

 

 

JS personalizzato

 

Nativo + VAST

 

App mobile

Creatività video In-stream (tutti) In-feed/in-article In-feed/articolo nativo Interstitial In-banner

VPAID + VAST

 

 

 

 

 

VAST

MRAID + JS

JS personalizzato

Nativo + VAST

Chiave: Formato/tecnologia non disponibile

Creatività video accettata in questo posizionamento, soggetta a blocchi del publisher

Creatività video non disponibile in questo posizionamento

Indicatori OpenRTB consigliati

Le seguenti tabelle illustrano gli indicatori OpenRTB consigliati per tutti i formati video per web desktop e mobile e app mobile.

Desktop e Web mobile

Formato del video Indicatori consigliati (solo indicatori pertinenti per i video) Indicatori correlati (solo indicatori pertinenti al video)

In-stream (VPAID)

Oggetto VIDEO presente   &
video.placement = INSTREAM   &

In-stream (senza VPAID)

Oggetto VIDEO presente   &
video.placement = INSTREAM    &
video.api = 1 VPAID 1.0 or 2:VPAID 2.0

Non in-stream

Oggetto VIDEO presente

video.linearity: linear
Il posizionamento dipende dal posizionamento
effettivo, i valori sono riportati di seguito
Video.startdelay = 0

Annuncio in-feed

Oggetto VIDEO presente   &
video.placement = IN-FEED

In-article

Oggetto VIDEO presente   &
video.placement = IN-ARTICLE

Nativo

Oggetto NATIVE presente e

In-banner

Oggetto video non presente &
banner.battr ≠ 6 Video in-banner (riproduzione automatica) &
banner.battr ≠ 7 Video in-banner (avviato dall'utente)

App mobile

Formato del video Dettagli della richiesta di offerta (solo i dettagli pertinenti al video)

In-stream

Oggetto VIDEO presente   &
video.placement = INSTREAM    &

video.api = 1 VPAID 1.0 o 2: VPAID 2.0

Non in-stream

Oggetto VIDEO presente

video.linearity: linear
Il posizionamento dipende dal posizionamento
effettivo, i valori sono riportati di seguito
Video.startdelay = 0

Annuncio in-feed

Oggetto VIDEO presente   &
video.placement = IN-FEED

In-article

Oggetto VIDEO presente   &
video.placement = IN-ARTICLE

Nativo

Oggetto NATIVE presente e

Interstitial (VAST)

Oggetto VIDEO presente   &
video.placement = INTERSTITIAL

Interstitial (senza VAST)

Oggetto VIDEO presente   &
video.placement = INTERSTITIAL

Filtrato

In-banner (MRAID)

Oggetto video non presente &
banner.battr ≠ 6 Video in-banner (riproduzione automatica) &
banner.battr ≠ 7 Video in-banner (avviato dall'utente)

In-banner

(nessun MRAID)

Oggetto video non presente &
banner.battr ≠ 6 Video in-banner (riproduzione automatica) &
banner.battr ≠ 7 Video in-banner (avviato dall'utente)

In che modo i publisher possono consentire/disattivare i video

La tabella seguente illustra i modi in cui i publisher possono consentire/impedire la pubblicazione di video nei propri posizionamenti.

Opzione Pub Formati applicabili Descritto nella richiesta di offerta come

Specificare un'unità per i video in-stream

In-stream (tutti)

Oggetto video presente &
video.placement = INSTREAM

Attivare VPAID

In-stream web

Oggetto video presente e
video.api = 1 (VPAID 1.0) o 2 (VPAID 2.0)

Attivare l'IBV

In-banner

Interstitial

banner.battr ≠ 6 Video in-banner (riproduzione automatica) e/o 7 Video in-banner (avviato dall'utente)

Attivare (istruzioni)

Annuncio in-feed

In-article

Oggetto video presente &
video.placement = IN-FEED o IN-ARTICLE

Attivare gli annunci non in-stream (istruzioni)

Nativo

Oggetto nativo presente

Bloccare gli annunci video interstitial

Interstitial per app

Oggetto VIDEO non presente

Casi limite

# Descrizione della richiesta Commenti Richiesta di offerta

1

Chiusura personalizzata ritardata con MRAID

Per gli annunci in primo piano, la chiusura dell'annuncio può inviare una notifica all'acquirente che utilizza MRAID, anche se non ha utilizzato la chiusura personalizzata.


La X applicata da Authorized Buyers verrà sempre visualizzata sopra qualsiasi chiusura personalizzata, anche se questa viene visualizzata sotto dopo 5 secondi

Glossario

Consulta il glossario video di Authorized Buyers.

Campi pertinenti per i formati in-stream e non in-stream

Consulta OpenRTB 2.5 (a partire dalla pagina 47)

BidRequest.Video.
Placement
In-stream mWeb

1: in-stream
2: in-banner

mApp

1: in-stream
2: in-banner
Non in-stream mApp Interstitial

5: interstitial

Native

3: In-Article
4: In-Feed

Rewarded

is_rewarded_inventory: booleano dell'estensione OpenRTB
linearity

Indica se l'impressione deve essere lineare, non lineare e così via. Se non ne viene specificato nessuno, si presume che siano consentiti tutti.

In-stream mWeb

1: LINEAR (in-stream)

mApp

1: LINEAR (in-stream)
Non in-stream mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE
videoad_start_delay
In-stream mWeb

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL
Non in-stream Rewarded

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

Origine del valore della richiesta di offerta

Oggetto
OpenRTB		 Campi Authorized Buyers
/piattaforma di scambio
di aste
non in-stream		 Valori di esempio Chi lo determina?
Da dove deriva questo valore?
Oggetto
Video mimes sì ["application/javascript",
"video/mp4"]",		 Google
minduration no Publisher configurato
maxduration sì Publisher configurato
playbackmet
hod		 sì [6] Di solito il publisher
è configurato
API (MRAID) sì [1,2] Google
protocolli sì [2,3,5,6,7,8] Google
linearità sì [1] Google
placement sì [1] Google
larghezza del player sì 400,400,300 Google
altezza del player sì 225.300.153 Google
ritardo avvio sì 0 Google, valore predefinito 5 secondi
ignora sì 1 Editore/Google
- per gli annunci interstitial => Google
- per gli annunci in-stream => Editore
decide se consentire gli annunci
ignorabili, non ignorabili o entrambi.
Annunci con premio, sempre non ignorabili.
velocità in bit minima No Google
velocità in bit massima no Google
pos sì 1 Google
Dispositivo
Rapporto px sì 1 Google
impressione
Sicuro sì 1 Google
imposta il valore predefinito su true
perché l'adtag è sempre
sicuro