Parametri obbligatori e consigliati per la pubblicità programmatica

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.

Di seguito è riportato un sottoinsieme di parametri URL del tag annuncio VAST. Questi parametri riguardano le soluzioni video basate su tag per la pubblicità programmatica senza integrazione con l'SDK IMA.

Consulta l'elenco dei parametri obbligatori e consigliati per il web o dei parametri obbligatori per le app.

 Vai a uno specifico parametro dell'elenco

an description_url hl idtype is_lat

msid plcmt pp rdid sid url

vpa vpmute vpos wta

 

Parametro	Dettagli
hl (Lingua)	Il parametro della lingua accetta un valore costante utilizzato per la richiesta di annunci in tale lingua, per la lingua della selezione degli annunci e il rendering degli annunci video nell'allocazione dinamica dei video in Ad Exchange o AdSense. 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. Esempio di utilizzo hl=it Requisito Consigliato per la monetizzazione con pubblicità programmatica
description_url (URL descrizione)	Il parametro URL description accetta un valore variabile che descrive il video riprodotto sulla pagina. Di solito è la pagina che ospita il video player, ma potrebbe trattarsi anche di una pagina contenente testo che descrive il video. Il valore description_url deve essere codificato come URL dei video player nelle pagine web e dei dispositivi TV connessi a internet (CTV)/OTT, nonché non codificato per i video player in-app mobile. Questo parametro non viene impostato automaticamente dall'SDK IMA, ma deve essere impostato manualmente. Esempio di utilizzo Codificato come URL: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html Non codificato: description_url= https://www.sample.com/golf.html Requisito Obbligatorio per Web, app e Ad Exchange Consigliato per la monetizzazione con pubblicità programmatica
msid (ID app) an (Nome dell'app)	I parametri del nome e dell'ID dell'app accettano valori variabili che devono essere applicati alle richieste inviate da app per dispositivi mobili e dispositivi TV connessi a internet, dato che sono richiesti dalla maggior parte degli annunci video di pubblicità programmatica. L'SDK IMA completa automaticamente entrambi i parametri, ma devono essere specificati manualmente nelle chiamate VAST dirette (ambienti non SDK). Benché il nome dell'app debba essere un nome leggibile, su iOS e tvOS l'SDK non riesce ad accedere all'app ID. In questi casi, il parametro msid non viene inviato e l'SDK invia l'app bundle tramite il parametro an. Esempio di utilizzo msid=com.package.publisher&an=sample%20app Gli app ID vengono denominati e formattati in modo diverso a seconda dello store. Consulta le linee guida dello IAB per l'identificazione delle app o esempi di identificatori univoci comuni. Per le piattaforme in cui non esiste uno store, l'IAB consiglia ai publisher di utilizzare il seguente formato per gli ID store: com.publisher.deviceplatform Requisito Entrambi i parametri sono obbligatori per l'app Consigliato per la monetizzazione con pubblicità programmatica
plcmt (Posizionamento)	Il parametro di posizionamento 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 di contenuto in-stream o aggiuntivo. Esempio di utilizzo Richiesta in-stream: plcmt=1 Richiesta di contenuti aggiuntivi: plcmt=2 Requisito   Obbligatorio per il web e la monetizzazione con pubblicità programmatica
pp (Profilo creatività)	Il parametro del profilo della creatività accetta un valore variabile che controlla quali creatività sono idonee alla pubblicazione in base alla configurazione impostata in un profilo di creatività video e audio. Esempio di utilizzo pp=creative_profile Requisito Consigliato per la monetizzazione con pubblicità programmatica
rdid idtype is_lat (Identificatori dei dispositivi reimpostabili)	Gli identificatori di dispositivi reimpostabili accettano valori variabili. Con applicazioni integrate (non sul Web o Web mobile), l'SDK passa identificatori di dispositivi reimpostabili relativi al targeting degli utenti nelle richieste di streaming con i parametri rdid, idtype e is_lat. Per gli streaming SSB, devi passare questi parametri in modo esplicito, proprio come faresti per una richiesta di annuncio lato client. Scopri di più sugli identificatori di dispositivi. Quasi tutti gli annunci video programmatici richiedono la presenza di questi valori. A partire da iOS 14.5, Apple ha ritirato l'indicatore LAT. Google si affida invece alla presenza di un IDFA diverso da zero per indicare che l'utente ha acconsentito al monitoraggio sulle versioni di iOS che supportano la funzionalità App Tracking Transparency. Di conseguenza, è necessario un UserAgent valido che indichi la versione corretta del sistema operativo. Esempio di utilizzo Vedi esempi dettagliati di identificatori di dispositivi reimpostabili. Requisito Obbligatorio per le app Consigliato per la monetizzazione con pubblicità programmatica
sid (ID sessione)	Il parametro dell'ID sessione accetta un valore variabile che rappresenta un identificatore pubblicità che tutela la privacy utilizzato solo per la quota limite. L'ID sessione è supportato per le richieste video in-stream da TV connesse a internet e nell'inventario video in-stream da app mobile sui dispositivi. Non è attualmente supportato per il web. Secondo le linee guida dell'identificatore della pubblicità di IAB, questo parametro deve essere compilato nel formato UUID. Scopri di più sugli identificatori di dispositivi reimpostabili per il targeting degli utenti. Puoi disattivare la trasmissione dell'ID sessione impostando sid=0. Esempio di utilizzo 123e4567-e89b-12d3-a456-426614174000 Requisito Consigliato per la monetizzazione con pubblicità programmatica
url (URL)	Il parametro 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 completato dinamicamente nella richiesta di annuncio.  In una pagina web, questo è l'URL della pagina che mostra il video player. Se utilizzi l'SDK IMA, il valore URL si imposta automaticamente. Se il player imposta questo valore, l'SDK IMA rispetta il valore impostato. In un'app (mobile o TV connessa a Internet (CTV)), 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 computer desktop.* Il valore di questo parametro deve essere codificato. Esempio di utilizzo url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html * Per le app, se non è possibile impostare questo parametro su un valore URL variabile, si consiglia di configurarlo come segue: url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com Requisito Obbligatorio per Web e app. Consigliato per la monetizzazione con pubblicità programmatica
vpa (Riproduzione video automatica)	Consigliato per MRC Linee guida per la misurazione dei video Il parametro della riproduzione video automatica 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 deve essere impostato se sconosciuto. Esempio di utilizzo Riproduzione automatica: vpa=auto Click-to-play: vpa=click Requisito Consigliato per la monetizzazione con pubblicità programmatica
vpmute (Disattiva audio riproduzione video)	Consigliato per MRC Linee guida per la misurazione dei video Il parametro del video con audio disattivato accetta un valore costante che indica se la riproduzione dell'annuncio inizia quando l'audio del video player è disattivato. Esempio di utilizzo Audio disattivato: vpmute=1 Audio riattivato: vpmute=0 Requisito   Obbligatorio per il web e la monetizzazione con pubblicità programmatica
vpos (Posizione video)	Il parametro della posizione video accetta un valore costante che indica se la richiesta di annuncio è stata inviata da pre-roll, mid-roll o post-roll. Esempio di utilizzo Pre-roll: vpos=preroll Mid-roll: vpos=midroll Post-roll: vpos=postroll Requisito Consigliato per la monetizzazione con pubblicità programmatica
wta (Perché questo annuncio?)	Il parametro "Perché questo annuncio?" accetta un valore costante che indica se il video player supporta il rendering di "Perché questo annuncio?". La funzionalità "Perché questo annuncio?" è supportata automaticamente quando si utilizza l'SDK IMA. Se non viene usato l'SDK IMA, i video player devono implementare il supporto di Icon e IconClickFallbackImage VAST, come documentato nello standard IAB relativo a VAST. Le richieste di annunci audio devono inviare wta=1 se 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. Per essere idonee al traffico della domanda di Google e delle prenotazioni ospitate da Google nel SEE, le richieste di annunci devono inviare wta=1 per indicare che viene eseguito il rendering dell'icona Scegli Tu!, come fornita nella risposta VAST, nell'annuncio video, negli annunci companion o altrimenti fornita all'utente per tutte le creatività dell'annuncio. Esempio di utilizzo Supportato: wta=1 Non supportato: wta=0 Requisito Obbligatorio per Ad Exchange Obbligatorio per il traffico nel SEE web e app Consigliato per la monetizzazione con pubblicità programmatica