Questa pagina è stata tradotta dall'API Cloud Translation.

Annunci video

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

Gli acquirenti possono acquistare inventario video in più posizionamenti, attualmente in-stream e interstitial. Per informazioni dettagliate, consulta la sezione Annunci interstitial.

Requisiti degli acquirenti

I nuovi acquirenti RTB dovrebbero sviluppare i propri 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 Creare la risposta.

Macro supportate

Le macro riportate di seguito sono supportate nelle creatività video in-stream:

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

Le macro clic (come CLICK_URL_ESC) non sono necessarie perché Authorized Buyers include i tracker dei clic in un wrapper VAST. Pertanto, le macro clic non sono supportate per gli annunci video in-stream. Per saperne di più 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 file proto-offerte-in tempo reale per identificare le richieste video e fornire ulteriori informazioni sulla richiesta specifiche per i video.

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

description_url

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

    http://www.publisher.com/watchpagelink

EndCapSupport

Quando l'opzione è abilitata, l'annuncio companion può essere scelto per il rendering come immagine finale (scheda informativa) nell'area video al termine della riproduzione dell'annuncio video.

`END_CAP_NOT_ENABLED`	L'annuncio companion non viene visualizzato come creatività finale.
`END_CAP_OPTIONAL`	L'immagine statica finale viene visualizzata se la risposta contiene un banner companion idoneo, 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 è impostato su true, il video viene incorporato in pagine esterne al dominio del publisher.

is_rewarded

Se impostato su true, indica che l'utente riceve un premio per aver visualizzato l'annuncio video. In genere i premi possono essere la lettura di un articolo extra senza costi, la possibilità di ricevere una vita extra in un gioco o la ricezione di una sessione musicale sponsorizzata senza annunci.

max_ad_duration

La durata massima consentita per l'annuncio restituito in millisecondi. Se il criterio è impostato su 0, non esiste 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 in grado di 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 da restituire. Se non è impostato o ha un valore minore o uguale a zero, non è prevista una durata minima.

Placement

Descrive dove verrà riprodotto il video.

`UNKNOWN_PLACEMENT`	Il posizionamento è sconosciuto o indeterminabile.
`INSTREAM`	In-stream significa che l'annuncio viene riprodotto prima, durante o dopo altri contenuti video. È simile a uno spot televisivo tradizionale. I contenuti video che l'utente sta guardando non vengono riprodotti durante la riproduzione dell'annuncio.
`INTERSTITIAL`	Interstitial significa che l'annuncio video viene riprodotto davanti a contenuti non video (ad esempio un articolo di notizie o un videogioco). L'annuncio copre tutto o quasi tutto lo spazio occupato sullo schermo dai contenuti e l'utente non è in grado di passare ai contenuti fino a quando l'annuncio non è stato completato o è stato saltato.
`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 un'app social, un articolo e così via. Il video viene visualizzato nel feed principale e nel flusso di visione e lettura dell'utente. Il video non viene visualizzato lateralmente come i video in-banner.

skippable_max_ad_duration

La durata massima in millisecondi per l'annuncio da restituire se questo annuncio è ignorabile. In genere è diversa dalla durata massima consentita 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 è determinato come riproduzione automatica o click-to-play in base alla migliore misurazione disponibile.

`AUTO_PLAY_SOUND_ON`	significa 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`	l'annuncio non viene riprodotto finché non viene fatto clic.

video_ad_skippable

È un valore di SkippableBidRequestType che contiene uno dei seguenti valori:

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

Se questo campo non viene configurato, l'impostazione predefinita consente gli annunci ignorabili.

videoad_start_delay

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

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

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

advertising_id

Questo campo è un UUID a 16 byte 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`	sono inclusi i cellulari con funzionalità video.
`TABLET`	include i tablet.
`PERSONAL_COMPUTER`	sono inclusi computer e laptop.
`CONNECTED_TV`	include sia TV connesse a internet (ovvero smart TV) sia 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 questa area sia visibile all'utente finale in base alla frequenza con cui è stata visibile in passato. Espressa come percentuale compresa nell'intervallo [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) di riproduzione del video. Questo viene 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 il verticale, i fornitori consentiti e le informazioni sul canale. Tutti gli altri campi esistenti nella richiesta di offerta si applicano anche al video.

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

allowed_vendor_type

Il fornitore consentito. Consulta il file vendors.txt nella documentazione tecnica per un elenco degli ID. Ad esempio, 309 = Unità video DFA.

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 l'utilizzo del formato Flash Video (FLV) per i video.
`VIDEO_HTML5`	Consente l'utilizzo del formato video HTML5 per i video.
`VPAID_FLASH`	Consente l'utilizzo del formato video Flash VPAID (Video Player Ad-Serve Interface Definition) per i video.
`VPAID_JS`	Consente l'utilizzo dei video che utilizzano il 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 annuncio.
`CreativeFormat`	Il formato della creatività rappresenta i possibili formati per la creatività in quest'area companion.

url

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

    http://www.publisher.com/watchpagelink

Quando risponde 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 appropriata per l'annuncio video. Di seguito è riportato un estratto di una risposta all'offerta video corretta:

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 in una risposta all'offerta video sono i seguenti:

attribute: Tutti 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 sia presente nell'elenco excluded_attribute della richiesta di offerta. Imposta questo campo solo se viene restituito uno snippet HTML o un annuncio video. Ad esempio, l'impostazione di questo campo su 30 indica che l'annuncio richiede il supporto VPAID per il rendering.

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

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

Formato del video	Indicatori consigliati (solo indicatori pertinenti video)	Indicatori correlati (solo indicatori pertinenti video)
In-stream (VPAID)	Oggetto VIDEO presente & `video.placement = INSTREAM &`
In-stream (no 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` posizionamento dipende dall'effettivo posizionamento, valori 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 e `banner.battr ≠ 6` Video in-banner (riproduzione automatica) e `banner.battr ≠ 7` video in-banner (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` posizionamento dipende dall'effettivo posizionamento, valori 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`
Interstiziale (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)

Formato del video	Indicatori consigliati pertinenti ai video	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 (no 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 NATIVO presente e `VIDEO = 000x000` all'interno del messaggio nativo	`Allowed_ad_types = NATIVE`
In-banner	`excluded_attribute ≠ 95` VideoType: video in-banner (può essere bloccato dal publisher)	`Allowed_ad_types = BANNER`

Annunci video

Requisiti degli acquirenti

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 per dispositivi mobili

Indicatori consigliati del protocollo AdX

Desktop e Web mobile

App per dispositivi mobili

In che modo gli editori 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 ai video pertinenti
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 NATIVO presente e `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 (nessun 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
Specifica un'unità 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 gli outstream (instructions)	Annuncio in-feed In-article	Oggetto video presente & `video.placement = IN-FEED` o `IN-ARTICLE`
Attiva gli outstream (instructions)	Nativo	Oggetto nativo presente
Blocca interstitial video	App interstitial	Oggetto VIDEO non presente

Opzione Pub	Formati applicabili	Descritto nella richiesta di offerta come (NOTA: questi sono TUTTI gli indicatori dell'opzione Pub nella richiesta di offerta; per gli indicatori consigliati, consulta la tabella di seguito)	Impostazione predefinita
Specifica un'unità 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 (instructions)	Annuncio in-feed In-article	Videomessaggio presente e `Allowed_video_formats = VIDEO_HTML5 & placement = IN-FEED or IN-ARTICLE`	Disattivato
Attiva Outstream (instructions)	Nativo	Messaggio NATIVE presente e `VIDEO = 000x000` all'interno del messaggio nativo	Disattivato
Blocca interstitial video	App interstitial	VIDEOmessaggio non presente e `excluded_attribute = 30 InstreamVastVideoType: Vpaid`	Attivato

Oggetto OpenRTB	Campi	AdX /Piattaforma di scambio Offerte Outstream	Valori di esempio	Chi la determina? /Da dove deriva questo valore?
Oggetto
Video	mimi	sì	["application/javascript", "video/mp4"]",	Google
	durata min	no		Configurata dal publisher
	durata massima	sì		Configurata dal publisher
	playmet hod	sì	[6]	Generalmente 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 player	sì	400,400,300	Google
	altezza player	sì	225,300,153	Google
	ritardo di avvio	sì	0	Google, valore predefinito di 5 secondi
	ignora	sì	1	Il publisher/Google - per interstitial => Google - per in-stream => Il publisher decide se consentire ignorabili, non ignorabili o entrambi. Annunci con premio, sempre senza ignorarli
	velocità in bit minima	No		Google
	velocità in bit massima	no		Google
	pos	sì	1	Google
Dispositivo
	Rapporto Px	sì	1	Google
impressione
	Sicurezza	sì	1	Il valore predefinito di Google è true perché il tag annuncio è sempre sicuro