Annunci video

Questa guida descrive i requisiti di integrazione, la configurazione e i campi pertinenti che puoi utilizzare quando fai offerte per l'inventario video.

Google supporta annunci video in-stream, nativi e interstitial rappresentati come singole opportunità pubblicitarie o pod di annunci video dinamici. I pod dinamici descrivono un raggruppamento di annunci video mostrati in sequenza, in cui una durata massima per il pod è suddivisa in uno o più video di lunghezza variabile. Consulta le guide per i formati degli annunci nativi e interstitial per maggiori dettagli su questi formati.

Requisiti per gli acquirenti

Protocollo RTB

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

Puoi trovare il proto OpenRTB e le estensioni OpenRTB specifiche di Google nella pagina Proto e dati di riferimento. Per ulteriori 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. Per avviare la procedura di revisione, puoi utilizzare la risorsa Creatives dell'API Real-time Bidding.

Configurazione del pretargeting

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

Macro

Puoi specificare le macro nel link dell'URL video o nell'XML VAST specificato in BidResponse.seatbid.bid.adm. Inoltre, se specifichi un URL video, puoi anche inserire macro nel 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 entrata riguarda l'inventario video in-stream o interstitial e trovare ulteriori informazioni specifiche per i video sulla 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 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 end cap (scheda informativa) nello spazio video dopo la 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 la visualizzazione dell'annuncio video. I premi tipici potrebbero essere la lettura di un articolo aggiuntivo senza costi, una vita extra in un gioco o una sessione di musica senza annunci sponsorizzata.
BidRequest.imp.video.maxduration

La durata massima consentita in secondi per ogni singolo annuncio incluso nella risposta all'offerta. Se non impostata, non è prevista una durata massima. Quando BidRequest.imp.video.skip è true, il comportamento può essere diverso. Per maggiori dettagli, consulta Durata massima dei video ignorabili.

BidRequest.imp.video.maxseq

Il numero massimo di annunci che potrebbero essere pubblicati in un pod di annuncio video dinamico. Se poddur è impostato, ma maxseq non è impostato o 0, non hai una limitazione al numero di annunci che possono essere pubblicati in un pod video. Google supporta solo i pod dinamici.

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 per ogni singolo annuncio incluso nella risposta all'offerta. 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 deve essere presente un'intenzione esplicita dell'utente di guardare i contenuti video. Sebbene possano 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 visibile in grado di riprodurre l'audio. Se il player viene convertito in mobile/sticky, le successive chiamate di annunci devono comunicare 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 di contenuti video. Il video player viene caricato e riprodotto prima, tra o dopo i paragrafi di testo o i contenuti grafici e inizia la riproduzione solo quando entra nel riquadro visibile. La riproduzione dei contenuti aggiuntivi deve iniziare solo quando entrano nell'area visibile. Può essere convertito in un player floating/sticky mentre scorre fuori dalla pagina.
PLCMT_INTERSTITIAL Annunci video riprodotti senza contenuti video. Durante la riproduzione, deve essere l'elemento principale della pagina e occupare la maggior parte dell'area visibile e non può essere spostato fuori dalla visualizzazione. Può essere in posizionamenti come video in-app o presentazioni.
PLCMT_NO_CONTENT_STANDALONE Annunci video riprodotti senza contenuti video in streaming. Questi possono essere posizionati in sezioni come presentazioni, feed nativi, contenuti in-content o sticky/fluttuanti.
BidRequest.imp.video.playbackmethod
Descrive come riprodurre l'annuncio video. Il metodo di riproduzione è determinato come riproduzione automatica o click-to-play in base alla migliore misurazione disponibile.
AUTO_PLAY_SOUND_ON Viene avviato 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 Viene avviato con un clic con l'audio attivo.
MOUSE_OVER Si attiva al passaggio del mouse con l'audio attivo.
ENTER_SOUND_ON Viene avviata quando si entra nella visualizzazione con l'audio attivato.
ENTER_SOUND_OFF Viene avviato quando si entra nell'area visibile con l'audio disattivato per impostazione predefinita.
BidRequest.imp.video.skip
Se true, indica che il player consentirà di saltare il video o che sono consentiti annunci ignorabili. In caso contrario, indica che gli annunci ignorabili non sono consentiti.
BidRequest.imp.video.startdelay

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

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

BidRequest.imp.video.durfloors e BidRequest.imp.audio.durfloors

Un array di oggetti DurFloors che indicano i prezzi iniziali rispettivi per le creatività video o audio di varie durate con cui l'acquirente può fare offerte.

Di seguito è riportato un esempio di come apparirebbe un durfloors specificato da Google:

  1. {"maxdur": 16, "bidfloor": 5} che rappresentano (0, 16) secondi a $5.
  2. {"mindur": 16, "maxdur": 31, "bidfloor": 10} che rappresentano [16, 31) secondi a $10.
  3. {"mindur": 31, "bidfloor": 20} che rappresentano [31, inf) secondi a $20.

Questi indicatori non sono esclusivi delle creatività video, ma sono particolarmente utili per i partecipanti all'asta:

BidRequest.device.ifa
Questo campo è un UUID di 36 caratteri impostato solo quando si utilizza SSL e non è sottoposto ad hashing. È la versione non criptata di BidRequest.device.dpidm5. Per i dispositivi iOS, contiene l'IDFA (Identifier for Advertisers) in caratteri maiuscoli. Per i dispositivi Android, contiene l'identificatore Android (ADID) in caratteri minuscoli. Per i dispositivi TV connesse, contiene i loro identificatori unici (ad esempio, RIDA di Roku).
BidRequest.device.devicetype
Specifica il tipo di dispositivo.
MOBILE Un alias obsoleto per HIGHEND_PHONE o TABLET.
PERSONAL_COMPUTER Include computer desktop e laptop.
CONNECTED_TV include sia le TV connesse (ovvero le smart TV) sia i dispositivi connessi (come Roku, Apple TV e così via).
HIGHEND_PHONE Sono inclusi gli smartphone di fascia alta.
TABLET Sono inclusi i tablet.
CONNECTED_DEVICE Sono inclusi i dispositivi di gioco dedicati.
SET_TOP_BOX Include i decoder.
OOH_DEVICE Include dispositivi pubblicitari out of home, ad esempio 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 compresa nell'intervallo [0.0, 1.0] che rappresenta il tasso di completamento storico degli annunci video pubblicati nell'area annuncio. Il valore predefinito di -1.0 indica che i dati storici sul tasso di completamento non sono disponibili.
BidRequest.imp.video.poddur
La durata in secondi che puoi riempire per un pod di annunci video dinamico. Questo campo si riferisce alla durata dell'intera interruzione pubblicitaria. Se non è impostato, l'area annuncio non fa parte di un pod.

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 video.

BidRequest.imp.ext.allowed_vendor_type
I fornitori consentiti. Per un elenco di ID, consulta il file vendors.txt nella documentazione tecnica. Ad esempio, 309 = DFA Video Unit.
BidRequest.imp.video.mimes
Un elenco consentito che descrive i tipi MIME di 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 formati.
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: "n40G42d551UX18627ao8lt"
seatbid {
  bid {
    id: "17u6BnD62h88r5q7066"
    impid: "1"
    price: 0.797848
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    crid: "test_creative_id_987914"
    w: 320
    h: 480
    cattax: GOOGLE_CATEGORIES
    [com.google.doubleclick.bid] {
      attribute: 47
      attribute: 50
      billing_id: 55383762512
      skadn {
        version: "4.0"
        network: "306el65O"
        itunesitem: "832461214"
        sourceapp: "977150768"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "oE3Ek8347oZV1Yl1J42G2c88BSKr2dqEbiOK2S4ni7NVDh3v128NN0hlzWK5aX96ecV1504E9k288i0t0wGX73P317812WE7"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "0054e0b9-0b53-4426-99dd-a1eefeb45565"
          timestamp: "1757329316673"
          signature: "b1GqXA4v889p842512GQ1p3249q5VmPt1335f1H1zdK92fq24j7a7ml419W7u8B7rhhH97s507f2251923oWi89XF1voZv4b"
        }
        sourceidentifier: "8396"
      }
      app_promotion_type: INSTALLS
      clickurl: "google.com"
    }
  }
}
[com.google.doubleclick.bid_response] {
  processing_time_ms: 20
}

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

BidResponse.seatbid.bid.ext.attribute
Attributi per gli annunci che possono essere visualizzati da questo snippet. Per l'elenco degli ID, consulta il file buyer-declarable-creative-attributes.txt. Verifichiamo che nessuno di questi attributi corrisponda a quelli non consentiti dal publisher nella richiesta di offerta. Ad esempio, se uno dei due campi include 30, ciò 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 trattarsi di XML VAST non elaborato.

Esempi di richieste di offerta e risposte

Formati video

Come gli acquirenti possono includere video

Le tabelle seguenti illustrano i modi in cui gli acquirenti possono includere video nelle loro 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 Nativo in-feed/in-article Interstitial In-banner

VPAID + VAST

 

VAST

 

MRAID + JS

 

 

 

 

 

JS personalizzato

 

Nativo + VAST

 

App mobile

Creatività video In-stream (tutti) In-feed/in-article Nativo in-feed/in-article 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 tabelle seguenti illustrano i segnali OpenRTB consigliati per tutti i formati video per web mobile e desktop e app mobile.

Desktop e Web mobile

Formato del video Indicatori consigliati (solo indicatori pertinenti per i video) Indicatori correlati (solo indicatori pertinenti per i 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, valori come di seguito
Video.startdelay = 0

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 e
banner.battr ≠ 6 Video in-banner (riproduzione automatica) e
banner.battr ≠ 7 Video in-banner (avviato dall'utente)

App mobile

Formato del video Dettagli della richiesta di offerta (solo i dettagli pertinenti del 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, valori come di seguito
Video.startdelay = 0

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 e
banner.battr ≠ 6 Video in-banner (riproduzione automatica) e
banner.battr ≠ 7 Video in-banner (avviato dall'utente)

In-banner

(nessun MRAID)

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

Come i publisher possono consentire/non consentire i video

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

Opzione Pub Formati applicabili Descritto nella richiesta di offerta come

Specificare un'unità 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)

Attivare la verifica dell'identità

In-banner

Interstitial

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

Attivare (istruzioni)

In-feed

In-article

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

Attivare gli annunci non in-stream (istruzioni)

Nativo

Oggetto nativo presente

Blocca annuncio video interstitial

Interstitial per app

Oggetto VIDEO non presente

Casi limite

# Descrizione della richiesta Commenti Richiesta di offerta

1

Chiusura personalizzata ritardata tramite MRAID

Per gli annunci interstitial, la chiusura dell'annuncio può inviare una notifica all'acquirente utilizzando 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 dei video di Authorized Buyers.

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

Consulta OpenRTB 2.5 (a partire da 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

rwdd: bool
linearity

Indica se l'impressione deve essere lineare, non lineare e così via. Se non viene specificato nulla, si presume che siano consentite tutte le opzioni.

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
/Exchange
Bidding
Non-instream		 Valori di esempio Chi lo determina?
/Where this value derives
from?
Oggetto
Video mimes sì ["application/javascript",
"video/mp4"]",		 Google
minduration no Configurato dal publisher
maxduration sì Configurato dal publisher
playbackmet
hod		 sì [6] Di solito 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 giocatore sì 225.300.153 Google
ritardo avvio sì 0 Google, 5 sec. predefiniti
ignora sì 1 Publisher/Google
- per l'interstiziale => Google
- per l'in-stream => Publisher
decide se consentire
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
default to true
because adtag is always
secure