Annunci video

Questa guida illustra i requisiti di integrazione, la configurazione campi pertinenti del protocollo OpenRTB che puoi utilizzare quando fai offerte per i video inventario. Il protocollo RTB di Google è stato ritirato e non sarà preso in considerazione 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. Visualizza le guide per Nativi e Formati degli annunci interstitial per ulteriori dettagli su questi formati.

Requisiti dell'acquirente

Protocollo RTB

In generale, 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 di pretargeting

Per ricevere l'inventario video, il tuo account Authorized Buyers deve crea un configurazione di pretargeting che include 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 video puoi inserire le macro anche all'interno del documento XML VAST collegato. La 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 scoprire di più 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 entrata è per in-stream o video interstitial inventario e trovare informazioni aggiuntive specifiche per i 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 gratuitamente, 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 che devi restituire. Se non viene impostato, non è prevista una durata massima. Quando BidRequest.imp.video.skip è true, questo può si comportano in modo 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 ma non può superarlo.

BidRequest.imp.video.minduration
La durata minima in secondi dell'annuncio da restituire. Se non viene 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. it dovrebbe rimanere il contenuto principale della pagina e l'unico video player in-view in grado di riprodurre audio durante la riproduzione. Se il player viene convertito in popup/fisso, le chiamate agli annunci successive devono indicare con precisione le dimensioni aggiornate del player.
PLCMT_ACCOMPANYING_CONTENT Annunci pre-roll, mid-roll e post-roll riprodotti prima, durante o dopo lo streaming dei 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. Può convertirsi in un player fluttuante/persistente mentre scorre fuori 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. Questo può essere in posizionamenti come presentazioni, feed nativi, contenuti all'interno o appiccicose/fluttuanti.
BidRequest.imp.video.playbackmethod
Descrive come riprodurre l'annuncio video. Il metodo di riproduzione viene definito come riproduzione automatica o click-to-play in base alla misurazione migliore disponibile.
AUTO_PLAY_SOUND_ON 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 attivato.
MOUSE_OVER Si avvia al passaggio del mouse con l'audio attivo.
ENTER_SOUND_ON Si avvia quando entri nell'area visibile 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 corrisponde al tempo in secondi dall'inizio del video fino al punto in cui l'annuncio viene visualizzato.

Questi indicatori non sono univoci per le creatività video, ma che 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 le TV connesse a internet (ad esempio Roku, Apple TV e così via).
HIGHEND_PHONE Sono inclusi telefoni di fascia alta.
TABLET Sono inclusi i tablet.
CONNECTED_DEVICE Sono inclusi dispositivi di gioco dedicati.
SET_TOP_BOX Sono inclusi i dispositivi set-top box.
OOH_DEVICE Include dispositivi per la pubblicità out-of-home; ad esempio le tecnologie cartelloni pubblicitari.
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 non sono disponibili dati sulla percentuale di completamento.
BidRequest.imp.video.poddur
La durata in secondi dell'intera interruzione pubblicitaria, incluse tutte le aree del 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 relativi a larghezza e altezza all'interno del messaggio dell'area annuncio di una richiesta video corrispondano alle dimensioni del player dell'annuncio video.

BidRequest.imp.ext.allowed_vendor_type
I fornitori consentiti. Consulta le vendors.txt nella documentazione tecnica per ottenere un elenco di ID. Ad esempio, 309 = Unità video Campaign Manager.
BidRequest.imp.video.mimes
Una lista consentita che descrive i tipi MIME di contenuti supportati per gli annunci pubblicati in la risposta alla richiesta di offerta; ad esempio "video/mp4". La risposta all'offerta dovrebbe 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 enum 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 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 due campi includesse 30, indica che l'annuncio richiede il supporto 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 essere un file 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/articolo 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/articolo 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 ai blocchi del publisher

Creatività video non disponibile in questo posizionamento

Indicatori consigliati di OpenRTB

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) e
Video in-banner banner.battr ≠ 7 (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

L'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

(no 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/negare i video

La tabella seguente illustra i modi in cui i publisher possono consentire/non consentire i video nei propri posizionamenti.

Opzione Pub Formati applicabili Descritto nella richiesta di offerta come

Specificare un'unità per video in-stream

In-stream (tutti)

Oggetto video presente e
video.placement = INSTREAM

Attivare VPAID

In-stream web

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

Attiva 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

Attiva gli annunci non in-stream (istruzioni)

Nativo

Oggetto nativo presente

Blocca interstitial video

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 interstitial, la chiusura dell'annuncio può inviare una notifica all'acquirente utilizzando MRAID. anche se non ha utilizzato una 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: bool estensione OpenRTB
linearity

Indica se l'impressione deve essere lineare, non lineare e così via. Se non viene specificato nulla, 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 valore richiesta di offerta

Oggetto
OpenRTB		 Campi Authorized Buyers
/Piattaforma
Offerta
Non in-stream		 Valori di esempio Chi li determina?
Da dove deriva questo valore?
Oggetto
Video mimi sì ["application/javascript",
"video/mp4"]",		 Google
minduration no Configurato dal publisher
maxduration sì Configurato dal publisher
ha raggiunto
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 Publisher/Google
- per interstitial =>
su Google - per in-stream => Editore
decide se consentire o meno
ignorabile, non ignorabile 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
su Google il valore predefinito è true
perché il tag annuncio è sempre
sicuro