Questa pagina è stata tradotta dall'API Cloud Translation.

Annunci video nel protocollo Google RTB

Con il lancio del supporto per gli annunci video, Gli acquirenti possono acquistare l'inventario video tramite Authorized Buyers. Questo documento illustra i requisiti di integrazione per l'acquisto tramite RTB utilizzando il protocollo di Authorized Buyers. Per informazioni sui protocolli disponibili, vedi Seleziona un protocollo della Guida introduttiva.

Gli acquirenti possono acquistare inventario video in vari posizionamenti, attualmente in-stream e interstitial. Vedi Annunci interstitial per maggiori dettagli.

Requisiti dell'acquirente

I nuovi acquirenti RTB dovrebbero sviluppare i loro offerenti utilizzando il buffer di protocollo più recente e le informazioni descritte nelle sezioni seguenti. Per scaricare il protocollo, consulta la pagina dei dati di riferimento per le offerte in tempo reale. Per informazioni sullo sviluppo di un offerente, consulta Elaborare la richiesta e Crea la risposta.

Macro supportate

Le seguenti macro sono supportate nelle creatività video in-stream:

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

Le macro clic (ad esempio CLICK_URL_ESC) non sono necessarie perché Authorized Buyers include i propri tracker dei clic in un wrapper VAST. Pertanto, le macro clic non sono supportate per gli annunci video in-stream. Per ulteriori informazioni sulle macro supportate, consulta la sezione Specificare le macro in Crea la risposta.

Dettagli callout

Il protocollo delle offerte in tempo reale utilizza un videomessaggio, definito nel real-time- bidding-proto.txt per identificare le richieste di video e fornire ulteriori informazioni specifiche per i video in merito alla richiesta.

Il seguente elenco di campi nel videomessaggio nidificato fornisce anche descrizioni ed esempi dettagliati:

description_url

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

EndCapSupport

Quando questa impostazione è attiva, è possibile selezionare l'annuncio companion come un'immagine statica finale (scheda informativa) nello slot video al termine della riproduzione dell'annuncio video.

`END_CAP_NOT_ENABLED`	L'annuncio companion non viene visualizzato come immagine statica finale.
`END_CAP_OPTIONAL`	L'immagine statica finale viene visualizzata se la risposta contiene un'immagine banner companion, ma quest'ultimo non è obbligatorio.
`END_CAP_FORBIDDEN`	Una risposta con un annuncio companion viene filtrata.
`END_CAP_REQUIRED`	Una risposta senza annuncio companion viene filtrata.

is_embedded_offsite

Se il criterio viene impostato su true, Il video sia incorporato in pagine esterne al dominio del publisher.

is_rewarded

Se impostato su true, indica che l'utente riceve un premio per aver guardato l'annuncio video. Normalmente premi potresti ricevere articoli extra senza costi, ricevere vite extra in un gioco o una sessione musicale sponsorizzata senza annunci.

max_ad_duration

La durata massima consentita per l'annuncio restituito in millisecondi. Se impostato su 0, non è prevista una durata massima.

max_ads_in_pod

Il numero massimo di annunci in un pod video di Authorized Buyers. Un valore diverso da zero indica che l'area annuncio corrente è un pod video che può mostrare più annunci video. Il numero effettivo di annunci video mostrati può essere inferiore o uguale a questo valore, ma non può superarlo.

min_ad_duration

La durata minima in millisecondi dell'annuncio che dovrebbe restituire. Se non è impostato o ha un valore minore o uguale a zero, non esiste una durata minima.

Placement

Descrive dove verrà riprodotto il video.

`UNKNOWN_PLACEMENT`	Il posizionamento è sconosciuto o non determinabile.
`INSTREAM`	In-stream significa che l'annuncio viene riprodotto prima, durante o dopo altre contenuti video. È simile a uno spot televisivo tradizionale. I contenuti video che l'utente sta guardando non vengono riprodotti durante durante la riproduzione dell'annuncio.
`INTERSTITIAL`	Interstitial significa che l'annuncio video viene riprodotto davanti a contenuti non video (ad esempio un articolo o un videogioco). L'annuncio copre tutto o quasi tutto lo spazio sullo schermo occupati dai contenuti e l'utente non può procedere ai contenuti fino a quando l'annuncio non è terminato o è stato ignorato.
`IN_FEED`	Il formato video in-feed è una creatività video che viene mostrata quando l'utente scorre un feed di contenuti, in genere un feed di app social, articolo di notizie e così via. Il video viene visualizzato nel feed principale e nella la visione artificiale e il flusso di lettura. Il video non viene visualizzato sul lato un video in-banner.

skippable_max_ad_duration

La durata massima dell'annuncio in millisecondi. che dovresti restituire se questo annuncio è ignorabile. Di solito è diverso dalla durata massima consentito per gli annunci non ignorabili. Se questo campo non è impostato o ha un valore minore o uguale a zero, è consentita qualsiasi durata.

VideoPlaybackMethod

Descrive come riprodurre l'annuncio video. Il metodo di riproduzione è la riproduzione automatica o click-to-play in base alla migliore misurazione disponibile.

`AUTO_PLAY_SOUND_ON`	indica che l'annuncio viene riprodotto automaticamente con l'audio attivo.
`AUTO_PLAY_SOUND_OFF`	indica che l'annuncio viene riprodotto automaticamente con l'audio disattivato.
`CLICK_TO_PLAY`	significa che l'annuncio non viene riprodotto finché non viene fatto clic su di esso.

video_ad_skippable

Questo è un valore di SkippableBidRequestType che contenga uno dei seguenti valori:

`ALLOW_SKIPPABLE`	significa che sono consentiti annunci ignorabili e non ignorabili.
`REQUIRE_SKIPPABLE`	significa che possono essere restituiti solo annunci ignorabili.
`BLOCK_SKIPPABLE`	significa che possono essere restituiti solo annunci non ignorabili.

L'impostazione predefinita se questo campo non viene impostato è di consentire gli annunci ignorabili.

videoad_start_delay

Il tempo in millisecondi dall'inizio del video fino al punto in cui l'annuncio viene visualizzato. 0 significa pre-roll e -1 significa post-roll. Qualsiasi altro valore positivo indica l'area si trova al centro del video.

Il valore è valido solo se questo parametro è impostato. Se il criterio non è impostato, la posizione di visualizzazione è sconosciuta.

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

advertising_id

Questo campo è un UUID a 16 byte che viene impostato solo quando si utilizza SSL. È la versione non criptata di encrypted_advertising_id. Per i dispositivi iOS, contiene l'IDFA (Identifier for Advertisers). Per i dispositivi Android, contiene l'identificatore Android (ADID). Per i dispositivi TV connessi a internet, contiene i relativi identificatori univoci (ad esempio, RIDA di Roku).

device_type

Specifica il tipo di dispositivo.

`UNKNOWN_DEVICE`	è il valore predefinito per questo campo.
`HIGHEND_PHONE`	include i telefoni cellulari con funzionalità video.
`TABLET`	include i tablet.
`PERSONAL_COMPUTER`	include computer e laptop.
`CONNECTED_TV`	sono incluse entrambe le TV connesse a internet (ovvero le smart TV) e dispositivi connessi (come Roku, Apple TV e così via).
`GAME_CONSOLE`	include dispositivi di gioco dedicati.

brand

Specifica il brand (ad esempio Nokia o Samsung) del dispositivo. Questo campo è facoltativo; per impostazione predefinita non è specificato.

model

Specifica il modello esatto (ad esempio N70 o Galaxy) del dispositivo. Questo campo è facoltativo; per impostazione predefinita non è specificato.

screen_orientation

Specifica l'orientamento del dispositivo quando viene inviata la richiesta di annuncio. I valori validi sono LANDSCAPE, PORTRAIT, e UNKNOWN_ORIENTATION.

viewability

Fornisce una stima della probabilità che questo slot saranno visualizzabili dall'utente finale in base alla frequenza con cui vengono visualizzate visibili in passato. Espressa in percentuale in l'intervallo di [0, 100]. Il valore predefinito -1 indica che i dati storici relativi alla visibilità non sono disponibili.

content_attributes.duration_seconds

Il numero di secondi (ad esempio 200) durante la riproduzione del video. Questo è dichiarato nel messaggio ContentAttributes. È impostato sul valore specificato nei metadati del video. forniti dal publisher del video.

La richiesta di offerta video contiene anche informazioni sull'inventario come verticale, fornitori autorizzati e informazioni sul canale. Tutti e 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.

allowed_vendor_type

Il fornitore autorizzato. Consulta le vendors.txt nella documentazione tecnica per ottenere un elenco di ID. Ad esempio, 309 = Unità video Campaign Manager.

allowed_video_formats

Descrive le tecnologie video consentite per gli annunci pubblicati in risposta a questa richiesta. La risposta dovrebbe indicare il supporto per almeno uno di questi. I valori per questo campo ripetuto provengono dall'enumerazione di VideoFormat:

`VIDEO_FLASH`	Consente video utilizzando il formato Flash Video (FLV).
`VIDEO_HTML5`	Consente i video che utilizzano il formato video HTML5.
`VPAID_FLASH`	Consente ai video di utilizzare la pubblicazione di annunci nel video player Formato video Flash VPAID (Interfacce Definition).
`VPAID_JS`	Consente i video che utilizzano Formato video JavaScript VPAID.

companion_slot

Questo campo rappresenta un messaggio CompanionSlot che include i seguenti campi:

`height`	Le altezze disponibili per l'area.
`width`	Le larghezze disponibili per questa area.
`CreativeFormat`	Il formato della creatività rappresenta i formati possibili per la creatività in quest'area companion.

url

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 rispondi a una richiesta di video, l'offerente deve restituire un URL di reindirizzamento VAST nel campo video_url. 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 appropriata:

protocol_version: 1
  ad {
    adslot {
      id: 1
      max_cpm_micros: 50000000
    }
    click_through_url: "http://google.com/"
    video_url: "http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/
    B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml"
  }

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

attribute: Tutti gli attributi degli annunci che possono essere mostrati da questo snippet. Consulta le buyer-declarable-creative-attributes.txt per l'elenco di ID. Verifichiamo che nessuno di questi attributi sia presente Elenco excluded_attribute della richiesta di offerta. Imposta questo campo solo se viene restituito uno snippet HTML o un annuncio video. Ad esempio, se questo campo viene impostato su 30, l'annuncio richiede il supporto VPAID per il rendering.

Creatività video	In-stream (tutti)	In-feed/articolo	In-feed/articolo nativi	Interstitial	In-banner
VPAID + VAST
VAST
MRAID + JS
JS personalizzato
Nativo + VAST

Creatività video	In-stream (tutti)	In-feed/articolo	In-feed/articolo nativi	Interstitial	In-banner
VPAID + VAST
VAST
MRAID + JS
JS personalizzato
Nativo + VAST

Formato del video	Indicatori consigliati (solo indicatori pertinenti per i video)	Indicatori correlati (solo indicatori pertinenti dei 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`
Outstream	Oggetto VIDEO presente `video.linearity: linear` il posizionamento dipende dall'effettivo posizionamento, i valori seguenti `Video.startdelay = 0`
Annuncio in-feed	Oggetto VIDEO presente & `video.placement = IN-FEED`
In-article	Oggetto VIDEO presente & `video.placement = IN-ARTICLE`
Nativo	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)

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
Outstream	Oggetto VIDEO presente `video.linearity: linear` il posizionamento dipende dall'effettivo posizionamento, i valori seguenti `Video.startdelay = 0`
Annuncio in-feed	Oggetto VIDEO presente & `video.placement = IN-FEED`
In-article	Oggetto VIDEO presente & `video.placement = IN-ARTICLE`
Nativo	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) e Video in-banner `banner.battr ≠ 7` (avviato dall'utente)
In-banner (no MRAID)	Oggetto video non presente & `banner.battr ≠ 6` Video in-banner (riproduzione automatica) e Video in-banner `banner.battr ≠ 7` (avviato dall'utente)

Formato del video	Indicatori pertinenti per i video consigliati	Indicatori pertinenti per i video correlati
In-stream (VPAID)	VIDEOmessaggio presente & `placement = INSTREAM & Allowed_video_formats = VPAID_JS`	`Allowed_video_formats = VIDEO_HTML5 Allowed_ad_types = VIDEO`
In-stream (senza VPAID)	VIDEOmessaggio presente & `placement = INSTREAM & Allowed_video_formats ≠ VPAID_JS`	Allowed_video_formats = VIDEO_HTML5 & `excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
Annuncio in-feed	VIDEOmessaggio presente & `placement = IN-FEED`	Allowed_video_formats = VIDEO_HTML5 & `excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-article	VIDEOmessaggio presente & `placement = IN-ARTICLE`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
Nativo	Messaggio NATIVE presente & `VIDEO = 000x000` all'interno del messaggio nativo	`Allowed_ad_types = NATIVE`
In-banner	`excluded_attribute ≠ 95` Tipo di video: video in-banner (può essere bloccato dal publisher)	`Allowed_ad_types = BANNER`

Annunci video nel protocollo Google RTB

Requisiti dell'acquirente

Macro supportate

Dettagli callout

Pretargeting

Esempi di richieste di offerta e risposte

Formati video AdX

In che modo gli acquirenti possono includere i video

Web

Indicatori consigliati di OpenRTB

Desktop e Web mobile

App mobile

Indicatori consigliati del protocollo AdX

Web desktop e web mobile

App mobile

In che modo i publisher possono consentire/negare i video

OpenRTB

Protocollo AdX

Casi limite

Glossario

Campi AdX e OpenRTB nei formati in-stream e outstream

Protocollo AdX

Protocollo OpenRTB

Origine valore richiesta di offerta

Formato del video	Dettagli della richiesta di offerta pertinente per il video	Indicatori correlati pertinenti ai video
In-stream	VIDEOmessaggio presente `placement = INSTREAM`	`Allowed_video_formats = VIDEO_HTML5 excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
Annuncio in-feed	VIDEOmessaggio presente & `placement = IN-FEED`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-article	VIDEOmessaggio presente &`placement = IN-ARTICLE`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
Nativo	Messaggio NATIVE presente & `VIDEO = 000x000` all'interno del messaggio nativo	`Allowed_ad_types = NATIVE`
Interstitial	VIDEOmessaggio presente & `placement = INTERSTITIAL &`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = VIDEO`
In-banner (MRAID)	`excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable) & excluded_attribute ≠ 32 MraidType: MRAID`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = BANNER`
In-banner (no MRAID)	`excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable) & excluded_attribute = 32 MraidType: MRAID`	`Allowed_video_formats = VIDEO_HTML5 & excluded_attribute = 30 InstreamVastVideoType: Vpaid Allowed_ad_types = BANNER`

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`
Attiva VPAID	Web in-stream	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)
Attiva l'outstream (istruzioni)	Annuncio in-feed In-article	Oggetto video presente e `video.placement = IN-FEED` o `IN-ARTICLE`
Attiva l'outstream (istruzioni)	Nativo	Oggetto nativo presente
Blocca interstitial video	App interstitial	Oggetto VIDEO non presente

Opzione Pub	Formati applicabili	Viene descritto nella richiesta di offerta come (NOTA: questi sono TUTTI gli indicatori dell'opzione pub nel richiesta di offerta; per gli indicatori consigliati, consulta la tabella di seguito)	Impostazione predefinita
Specificare un'unità per video in-stream	In-stream (tutti)	Videomessaggio presente e `placement = INSTREAM`	n/d
Attiva VPAID	Web in-stream	Videomessaggio presente e `Allowed_video_formats = VPAID_JS &` `excluded_attribute ≠ 30 InstreamVastVideoType: Vpaid`	Disattivato
Attiva IBV	In-banner Interstitial	`excluded_attribute ≠ 95 VideoType: In-Banner Video (Publisher Blockable)`	Disattivato
Attiva outstream (istruzioni)	Annuncio in-feed In-article	Videomessaggio presente e `Allowed_video_formats = VIDEO_HTML5 & placement = IN-FEED or IN-ARTICLE`	Disattivato
Attiva outstream (istruzioni)	Nativo	Messaggio NATIVE presente e `VIDEO = 000x000` all'interno del messaggio nativo	Disattivato
Blocca interstitial video	App interstitial	VIDEOmessaggio non presente & `excluded_attribute = 30 InstreamVastVideoType: Vpaid`	Attivato

OpenRTB Oggetto	Campi	AdX /Piattaforma Offerta outstream	Valori di esempio	Chi li determina? /Dove genera questo valore da?
Oggetto
Video	mimi	sì	["application/javascript", "video/mp4"]",	Google
	durata minima	no		Configurato dal publisher
	durata massima	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 di avvio	sì	0	Google, impostazione predefinita di 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