L'implementazione di una soluzione video basata su tag senza l'utilizzo dell'SDK IMA per la domanda di Ad Exchange è un'offerta ancora in fase beta e potrebbe non essere disponibile per la tua rete. Per ulteriori informazioni, puoi contattare il tuo account manager.
In questo articolo è riportato un elenco di parametri obbligatori e consigliati per i tag annuncio VAST utilizzati per pubblicare annunci nelle implementazioni web.
In questa pagina
- Parametri obbligatori per la pubblicazione di annunci
- Parametri obbligatori per la pubblicità programmatica
- Parametri consigliati per la pubblicità programmatica
Puoi esaminare gli elenchi per altri tipi di implementazione o i requisiti degli URL per i tag annuncio VAST.
Parametri obbligatori e consigliati per il web
Parametri obbligatori per la pubblicazione di annunci
correlator (Correlatore)
Descrizione
Il parametro correlatore (correlator) accetta un valore variabile condiviso da più richieste provenienti dalla medesima visualizzazione di pagina. Viene utilizzato per implementare esclusioni competitive, anche negli ambienti senza cookie.
Esempi di utilizzo
correlator=4345645667
Requisiti e consigli
Questo parametro è obbligatorio per implementare la pubblicazione di annunci su web, app mobile, TV connesse a internet, audio e out of home digitale.
Utilizzo dell'SDK
- Se utilizzi l'SDK IMA, il valore correlatore viene impostato automaticamente. Se il player cerca di impostare questo valore, l'SDK lo sovrascrive con un proprio valore.
- Se non utilizzi l'SDK IMA, assicurati di impostare questo valore su un numero intero positivo veramente casuale che non venga riutilizzato da più visualizzazioni di pagina.
description_url (URL descrizione)
Descrizione
Il parametro URL di descrizione (description_url) accetta un valore variabile che dovrebbe descrivere il video in riproduzione sulla pagina.
L'URL di descrizione deve riguardare i video in riproduzione su una pagina specifica di un'app web, un'app mobile o un'app TV. Non deve essere il dominio di primo livello per tutti i video o tutte le richieste di annunci. Ad esempio, se hai una pagina https://www.sample.com/golf.html per mostrare video sul golf, impostala come valore di description_url.
Esempi di utilizzo
Il valore description_url deve essere codificato negli URL di pagine web con video e di dispositivi TV connesse a internet (CTV)/OTT. Tuttavia, il valore description_url non deve essere codificato per le app mobile.
Codificato come URL:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
Non codificato:
description_url=
https://www.sample.com/golf.html
Requisiti e consigli
Questo parametro è obbligatorio per implementare la pubblicazione di annunci su web e app mobile. È obbligatorio anche se utilizzi Ad Exchange o AdSense per l'allocazione dinamica.
Questo parametro è consigliato per la monetizzazione programmatica.
Utilizzo dell'SDK
Questo parametro non viene impostato automaticamente dall'SDK IMA, ma deve essere impostato manualmente.
Consulta le guide all'SDK IMA per la tua piattaforma.
env (Ambiente)
Descrizione
Il parametro dell'ambiente (env) accetta un valore costante che indica una richiesta in-stream o proveniente in modo specifico da un video player.
I valori possibili sono instream, che può essere utilizzato per annunci audio e video, e vp, che può essere utilizzato solo per annunci video.
Esempi di utilizzo
Video e/o audio:
env=instream
Solo video:
env=vp
Requisiti e consigli
Questo parametro è obbligatorio per implementare la pubblicazione di annunci su web, app mobile, TV connesse a internet, audio e out of home digitale.
Questo parametro è obbligatorio per generare report accurati sul tipo di richiesta suddiviso per "Tag video".
gdfp_req (Indicatore dello schema)
Descrizione
Il parametro dell'indicatore dello schema di Google Ad Manager (gdfp_req) accetta un valore costante che indica che la richiesta di annuncio riguarda l'inventario di Google Ad Manager.
Esempi di utilizzo
gdfp_req=1
Requisiti e consigli
Questo parametro è obbligatorio per implementare la pubblicazione di annunci su web, app mobile, TV connesse a internet, audio e out of home digitale.
iu (Unità pubblicitaria)
Descrizione
Il parametro dell'unità pubblicitaria (iu) accetta un valore variabile che deve essere impostato sull'unità pubblicitaria corrente, nel formato: /network_code/.../ad_unit.
Esempi di utilizzo
iu=/6062/videodemo
Requisiti e consigli
Questo parametro è obbligatorio per implementare la pubblicazione di annunci su web, app mobile, TV connesse a internet, audio e out of home digitale.
output (Output)
Descrizione
Il parametro formato di output (output) accetta un valore costante che deve essere impostato sul formato di output dell'annuncio.
Esempi di utilizzo
Utilizza la versione VAST predefinita della tua rete:
output=vast
Utilizza VAST 4 (puoi impostare versioni specifiche per tag specifici):
output=xml_vast4
Utilizza l'impostazione VMAP predefinita della tua rete:
output=vmap
Utilizza VMAP 1:
output=xml_vmap1
Utilizza VMAP 1, che restituisce VAST 4 (se restituirai VAST all'interno di VMAP):
output=xml_vmap1_vast4
Requisiti e consigli
Questo parametro è obbligatorio per implementare la pubblicazione di annunci su web, app mobile, TV connesse a internet, audio e out of home digitale. È obbligatorio per generare il formato corretto della risposta alla pubblicazione degli annunci.
Utilizzo dell'SDK
Per VAST, tieni presente che se il tuo video player utilizza l'SDK IMA, il parametro output relativo a una richiesta di annuncio video sarà sempre impostato su output=xml_vast4. Questo non crea alcun rischio di affidabilità, poiché l'SDK è compatibile con qualsiasi versione precedente di VAST pubblicabile da qualsiasi ad server di terze parti.
Versione VAST per Authorized Buyers e Open Bidding
Se vuoi filtrare rigorosamente in base alla versione VAST per Authorized Buyers e Open Bidding, puoi attivare l'impostazione "Filtra esclusivamente la versione VAST" nelle impostazioni della rete.
sz (Dimensione)
Descrizione
Il parametro delle dimensioni (sz) accetta un valore variabile che deve essere impostato sulle dimensioni dell'area annuncio video principale.
Più dimensioni devono essere separate dal carattere barra verticale (|).
Non includere "v" dopo la dimensione.
Esempi di utilizzo
Una dimensione:sz=400x300
Più dimensioni:sz=300x250|400x300
Requisiti e consigli
Questo parametro è obbligatorio per implementare la pubblicazione di annunci su web, app mobile, TV connesse a internet e out of home digitale.
Questo parametro è facoltativo se si richiede solo ad_type=audio.
unviewed_position_start (Impressioni in ritardo)
Descrizione
Il parametro delle impressioni ritardate (unviewed_position_start) accetta un valore costante per indicare le impressioni ritardate per i video.
Esempi di utilizzo
unviewed_position_start=1
Requisiti e consigli
Questo parametro è necessario per implementare la pubblicazione di annunci su web e app mobile quando esiste un'opportunità di impressione ritardata.
url (URL)
Descrizione
Il parametro URL (url) accetta un valore variabile che deve essere impostato sull'URL completo da cui parte la richiesta. Questo valore è necessario per consentire agli acquirenti di identificare e comprendere il contesto da cui proviene la richiesta. Per quanto possibile, il valore dovrebbe essere inserito dinamicamente nella richiesta di annuncio.
- Sul web, questo è l'URL della pagina che mostra il video player.
- Negli ambienti non web, questo valore deve essere impostato su un URL che rappresenta nel modo più accurato l'inventario video o audio monetizzato. Ad esempio, se l'utente sta guardando un video in un'app mobile disponibile anche su un URL equivalente per desktop.*
Nota: url è diverso da description_url in quanto url si riferisce alla località da cui è stata effettuata una richiesta di annuncio, mentre description_url è una pagina web sottoponibile a scansione che descrive i contenuti video.
Il valore di questo parametro deve essere codificato.
Esempi di utilizzo
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* Per le app, se non è possibile impostare questo parametro su un valore URL variabile, si consiglia di utilizzare il seguente pattern: url=https%3A%2F%2F<app/bundleid>.example.com
Requisiti e consigli
Questo parametro è obbligatorio solo per la monetizzazione con pubblicità programmatica su web, app mobile, TV connesse a internet, audio e out of home digitale.
Utilizzo dell'SDK
Se utilizzi l'SDK IMA, il valore URL si imposta automaticamente. Se il player imposta questo valore, l'SDK IMA rispetta il valore impostato.
Parametri obbligatori per la pubblicità programmatica
ott_placement (Posizionamento OTT)
Descrizione
Il parametro del posizionamento OTT (ott_placement) accetta un valore costante che indica una richiesta di un tipo specifico di posizionamento.
Definizioni dei posizionamenti per gli esempi riportati di seguito:
- In pausa: formato outstream che viene visualizzato tramite overlay sopra i contenuti video quando un utente mette in pausa la riproduzione dei contenuti.
- Schermata Home: annuncio visualizzato nella schermata Home di un dispositivo TV connesso a internet o di un'app OTT. Sono incluse le implementazioni di masthead, banner e riquadri nella schermata Home.
- Picture in picture: annuncio video in-stream riprodotto in un video player dell'annuncio separato accanto ai contenuti video. In genere, richiede di comprimere i contenuti video e di caricare un secondo video player.
- Banner L: annuncio display in-stream che prevede la compressione dei contenuti video e la creazione di un annuncio intorno al video. In genere, ma non solo, una casella di contenuti dell'annuncio a L.
- In overlay: qualsiasi formato di annuncio in-stream visualizzato sopra i contenuti video, ma che non occupa l'intero schermo. Può essere un annuncio display o video.
Esempi di utilizzo
Formati supportati e relativi valori corrispondenti:
In pausa
:ott_placement=1
Schermata Home:
ott_placement=2
Picture in picture:
ott_placement=3
Banner L:
ott_placement=4
In overlay
:ott_placement=5
Personalizzato/altro
:ott_placement=99
Requisiti e consigli
Questo parametro è obbligatorio solo per la monetizzazione programmatica su web, app mobile e TV connesse a internet per i publisher che monetizzano posizionamenti non standard in ambienti di streaming OTT.
plcmt (Posizionamento)
Descrizione
Il parametro posizionamento (plcmt) accetta un valore costante che viene utilizzato per indicare se l'inventario in-stream viene dichiarato "in-stream" o "aggiuntivo" in base alle indicazioni nelle specifiche IAB.
Per le richieste non in-stream, questo campo viene compilato automaticamente per gli acquirenti in base al formato di inventario dichiarato e sostituisce qualsiasi dichiarazione in-stream o aggiuntiva.
Esempi di utilizzo
Richiesta in-stream
:
plcmt=1
Richiesta di contenuti aggiuntivi
:
plcmt=2
Requisiti e consigli
Questo parametro è obbligatorio per la monetizzazione con pubblicità programmatica su web, app mobile, TV connesse a internet, audio e out of home digitale.
vpa (Riproduzione video automatica)
Descrizione
Il parametro della riproduzione video automatica (vpa) accetta un valore costante che indica se i contenuti video di un annuncio iniziano tramite riproduzione automatica o clic.
I valori possibili sono click se la pagina attende un'azione dell'utente o auto se il video viene riprodotto automaticamente. Questo parametro non modifica lo stato del video player: il comportamento della riproduzione deve essere gestito direttamente dal video player.
Esempi di utilizzo
Riproduzione automatica:
vpa=auto
Click-to-play:
vpa=click
Questo parametro non deve essere impostato se sconosciuto.
Requisiti e consigli
Questo parametro è obbligatorio per la monetizzazione con pubblicità programmatica su web, app mobile, TV connesse a internet e audio.
Questo parametro è consigliato anche dalle linee guida sulla misurazione dei video del Media Rating Council (MRC).
vpmute (Riproduzione video con audio disattivato)
Descrizione
Il parametro della riproduzione video con audio disattivato (vpmute) accetta un valore costante che indica se la riproduzione dell'annuncio inizia quando l'audio del video player è disattivato. Questo parametro non modifica lo stato del video player: il comportamento della riproduzione deve essere gestito direttamente dal video player.
Esempi di utilizzo
La riproduzione inizia con l'audio disattivato:
vpmute=1
La riproduzione inizia con l'audio riattivato:
vpmute=0
Requisiti e consigli
Questo parametro è obbligatorio per la monetizzazione con pubblicità programmatica su web, app mobile, TV connesse a internet, audio e out of home digitale.
Questo parametro è consigliato anche dalle linee guida sulla misurazione dei video del Media Rating Council (MRC).
Parametri consigliati per la pubblicità programmatica
aconp (Riproduzione audio continua)
Descrizione
Il parametro dell'audio continuo (aconp) accetta un valore costante che indica che il player intende riprodurre continuamente i contenuti audio. In questo modo, Google Ad Manager può selezionare gli annunci più adatti per l'esperienza utente.
Esempi di utilizzo
Riproduzione continua ON:
aconp=2
Riproduzione continua OFF:
aconp=1
Se non sai se l'audio viene riprodotto continuamente, questo parametro non deve essere impostato o deve essere impostato su aconp=0.
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci in un'implementazione specifica, è consigliato per la monetizzazione programmatica su web, app mobile, TV connesse a internet, audio e out of home digitale.
Questo parametro è consigliato anche dalle linee guida sulla misurazione dell'audio del Media Rating Council (MRC).
dth (Suggerimento sul tipo di dispositivo)
Descrizione
Il parametro di suggerimento del tipo di dispositivo (dth) accetta un valore costante che contribuisce a ridurre la classificazione errata dei dispositivi, in particolare negli ambienti come TV connesse a internet e set-top box.
Una classificazione errata del dispositivo potrebbe derivare da errori indesiderati da parte del publisher o dell'OEM della TV connessa a internet. Questo parametro deve essere utilizzato insieme ad altri indicatori per consentire a Google di segnalare automaticamente le istanze in cui l'inventario per le TV connesse a internet potrebbe essere riclassificato.
Esempi di utilizzo
Richieste da:
- Feature phone:
dth=1 - Smartphone:
dth=2 - Computer:
dth=3 - Tablet:
dth=4 - TV connessa a internet:
dth=5 - Console per videogiochi:
dth=6 - Set-top box:
dth=7
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci in un'implementazione specifica, è consigliato per la monetizzazione programmatica su web, app mobile, TV connesse a internet, audio e out of home digitale.
Utilizzo dell'SDK
Questo parametro è consigliato per le implementazioni PAL e PAI (non SDK). Non è necessario per l'SDK IMA o l'SDK DAI.
givn (Nonce video)
Descrizione
Per le integrazioni che utilizzano la libreria di accesso programmatico (PAL), il parametro video nonce accetta un valore di stringa variabile.
Il nonce è sicuro per l'URL, quindi non è necessario codificarlo.
Nota: se in precedenza hai fornito un nonce utilizzando il parametro precedente paln, ti consigliamo vivamente di eseguire la migrazione al parametro givn e di interrompere l'invio di paln. Non includere entrambi i parametri.
Esempi di utilizzo
Scopri di più sul valore trasmesso a questo parametro nelle guide introduttive per PAL.
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci in un'implementazione specifica, è consigliato per la monetizzazione programmatica su web, app mobile, TV connesse a internet, audio e out of home digitale.
hl (Lingua)
Descrizione
Il parametro della lingua (hl) accetta un valore costante utilizzato per la richiesta di annunci in quella lingua, per la lingua della selezione degli annunci e il rendering degli annunci video nell'allocazione dinamica dei video in Ad Exchange o AdSense.
Esempi di utilizzo
Richiesta di annunci in italiano:
hl=it
Il valore del parametro può essere qualsiasi codice ISO 639-1 (due lettere) o ISO 639-2 (tre lettere). Consulta l'elenco di codici validi.
Se omesso, il valore predefinito sarà la lingua del targeting degli annunci per lingua in Ad Exchange.
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci in un'implementazione specifica, è consigliato per la monetizzazione programmatica su web, app mobile, TV connesse a internet, audio e out of home digitale.
omid_p (Nome del partner OMID)
Descrizione
Il parametro nome partner OMID (omid_p) accetta un valore variabile che indica il nome del partner che integra la misurazione OMID e la relativa versione.
Il parametro API SDK supportate (sdk_apis) accetta valori variabili che possono essere un singolo elenco o un elenco separato da virgole di API supportate.
Questi parametri fanno parte di un insieme di parametri utilizzati per la visibilità e la verifica degli annunci.
Esempi di utilizzo
Quando non utilizzi PAL
:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Consulta l'elenco dei possibili valori di framework dell'API.
Quando utilizzi PAL
:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci in un'implementazione specifica, è consigliato per la monetizzazione programmatica su web, app mobile, TV connesse a internet, audio e out of home digitale.
Utilizzo dell'SDK
- Questo parametro è applicabile solo ai publisher che vogliono usare la misurazione con Visualizzazione attiva quando utilizzano l'SDK Open Measurement (SDK OM).
- Per indicare il supporto OMID quando utilizzi la libreria di accesso programmatico (PAL), devi utilizzare
omidPartnerNameeomidPartnerVersionper impostare il nome e la versione partner. Se non utilizzi l'SDK PAL o IMA, devi impostare i parametriomid_pesdk_apis. - Questo valore non deve essere utilizzato quando si utilizza l'SDK IMA perché viene impostato automaticamente.
vconp (Riproduzione video continua)
Descrizione
Il parametro della riproduzione video continua (vconp) accetta un valore costante che indica se il player riproduce continuamente i contenuti video, come in una trasmissione TV.
Esempi di utilizzo
Riproduzione continua ON:
vconp=2
Riproduzione continua OFF:
vconp=1
Questo parametro non deve essere impostato se sconosciuto.
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci in un'implementazione specifica, è consigliato per la monetizzazione con pubblicità programmatica su web, app mobile, TV connesse a internet e audio.
Questo parametro è consigliato anche dalle linee guida sulla misurazione dei video del Media Rating Council (MRC).
vid_d (Durata del video)
Descrizione
Il parametro della durata del video (vid_d) accetta un valore variabile che specifica la durata dei contenuti in secondi.
- I parametri
vid_deallcuesvengono usati per pubblicare annunci mid-roll senza importazione di contenuti. - Per restituire mid-roll è necessario utilizzare le regole per gli annunci. Se nelle regole per gli annunci sono impiegati cue point basati sul tempo (ad esempio, "Ogni N secondi" o "A orari prefissati"), vengono usati questi, mentre vengono ignorati quelli passati nel parametro
allcues. Per i mid-roll è comunque necessaria una durata, pertanto è necessario passare il parametrovid_d.
Esempi di utilizzo
Durata dei contenuti video di 90.000 secondi (25 ore):
vid_d=90000
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci in un'implementazione specifica, è consigliato per la monetizzazione con pubblicità programmatica su web, app mobile e TV connesse a internet.
vpos (Posizione video)
Descrizione
Il parametro della posizione video (vpos) video accetta un valore costante che indica se la richiesta di annuncio è stata inviata da pre-roll, mid-roll o post-roll.
Esempi di utilizzo
Pre-roll:
vpos=preroll
Mid-roll:
vpos=midroll
Post-roll:
vpos=postroll
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci in un'implementazione specifica, è consigliato per la monetizzazione con pubblicità programmatica su web, app mobile, TV connesse a internet e audio.
Se vengono utilizzate le regole per gli annunci, questo parametro non è necessario perché viene aggiunto automaticamente dall'ad server.
wta (Perché questo annuncio?)
Descrizione
Il parametro "Perché questo annuncio?" (wta) accetta un valore costante che indica il supporto da parte del video player per il rendering del badge annuncio.
Esempi di utilizzo
Se il player deve eseguire il rendering dell'icona Scegli Tu! fornita nella risposta VAST, utilizza:
wta=1(oppure ometti il parametrowtao passawtasenza impostare un valore)Le richieste audio devono utilizzare
wta=1se viene eseguito il rendering dell'icona Scegli Tu!, come fornita nella risposta VAST, nelle creatività companion o se viene fornita in altro modo all'utente.
Se il player non deve eseguire il rendering dell'icona Scegli Tu! fornita nella risposta VAST, utilizza:
wta=0
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci per un tipo di implementazione specifico, è consigliato per la monetizzazione con pubblicità programmatica per web, app mobile, TV connesse a internet e audio.
Quando viene utilizzato il parametro:
- Il traffico
&wta=0non è idoneo per determinati tipi di personalizzazione da parte della domanda di Google. - Il traffico
&wta=0proveniente dal SEE non è idoneo per le creatività con badge annuncio attivato negli elementi pubblicitari di pubblicità programmatica garantita gestiti dal publisher e con prenotazione.
Gli annunci devono rispettare i requisiti normativi applicabili per gli annunci pubblicati nello Spazio economico europeo (SEE). Questo include un meccanismo che consente agli utenti di segnalare contenuti illegali. I publisher devono comunicare a Google eventuali segnalazioni di contenuti illegali utilizzando il modulo Segnalazioni di contenuti su Google.
Utilizzo dell'SDK
La funzionalità di badge annuncio è supportata automaticamente quando si utilizza l'SDK IMA. Se non viene usato l'SDK IMA, i video player devono implementare il supporto diIcon e IconClickFallbackImage VAST, come documentato nello standard IAB relativo a VAST.