In questo articolo è riportato un elenco di parametri obbligatori e consigliati per i tag annuncio VAST utilizzati per pubblicare annunci nelle implementazioni out of home digitali.
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 per gli URL per i tag annuncio VAST.
Parametri obbligatori e consigliati per l'out of home digitale
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.
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.
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
idtype (Tipo di dispositivo)
Descrizione
I parametri degli identificatori di dispositivi reimpostabili (rdid, idtype, is_lat) accettano valori variabili. Questo valore è noto anche come identificatore per la pubblicità (IFA).
Con le applicazioni mobile che utilizzano l'SDK IMA per Android o iOS, l'SDK IMA passa degli identificatori di dispositivi reimpostabili relativi al targeting degli utenti nelle richieste di streaming con i parametri rdid, idtype e is_lat.
Quando non viene utilizzato l'SDK IMA o quando viene utilizzato il beaconing lato server (SSB), devi passare questi valori come parametri espliciti. 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 |
Esempi di utilizzo
Vedi esempi dettagliati di identificatori di dispositivi reimpostabili.
Requisiti e consigli
Sebbene questi parametri non siano necessari per pubblicare annunci in un'implementazione specifica, sono obbligatori per la monetizzazione con pubblicità programmatica su app mobile, TV connesse a internet, audio e out of home digitale.
Gli identificatori di dispositivi reimpostabili non vengono utilizzati per le implementazioni web.
Utilizzo dell'SDK
L'SDK IMA passerà automaticamente questo campo, a meno che idType non sia impostato su dpid. In questo caso, il publisher dovrà trasmettere manualmente il parametro rdid.
I publisher dovranno passare questi parametri manualmente quando utilizzano l'SDK PAL.
is_lat (Limita il monitoraggio degli annunci)
Descrizione
I parametri degli identificatori di dispositivi reimpostabili (rdid, idtype, is_lat) accettano valori variabili. Questo valore è noto anche come identificatore per la pubblicità (IFA).
Con le applicazioni mobile che utilizzano l'SDK IMA per Android o iOS, l'SDK IMA passa degli identificatori di dispositivi reimpostabili relativi al targeting degli utenti nelle richieste di streaming con i parametri rdid, idtype e is_lat.
Quando non viene utilizzato l'SDK IMA o quando viene utilizzato il beaconing lato server (SSB), devi passare questi valori come parametri espliciti. 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 |
Esempi di utilizzo
Vedi esempi dettagliati di identificatori di dispositivi reimpostabili.
Requisiti e consigli
Sebbene questi parametri non siano necessari per pubblicare annunci in un'implementazione specifica, sono obbligatori per la monetizzazione con pubblicità programmatica su app mobile, TV connesse a internet, audio e out of home digitale.
Gli identificatori di dispositivi reimpostabili non vengono utilizzati per le implementazioni web.
Utilizzo dell'SDK
L'SDK IMA passerà automaticamente questo campo, a meno che idType non sia impostato su dpid. In questo caso, il publisher dovrà trasmettere manualmente il parametro rdid.
I publisher dovranno passare questi parametri manualmente quando utilizzano l'SDK PAL.
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.
rdid (Identificatore reimpostabile del dispositivo)
Descrizione
I parametri degli identificatori di dispositivi reimpostabili (rdid, idtype, is_lat) accettano valori variabili. Questo valore è noto anche come identificatore per la pubblicità (IFA).
Con le applicazioni mobile che utilizzano l'SDK IMA per Android o iOS, l'SDK IMA passa degli identificatori di dispositivi reimpostabili relativi al targeting degli utenti nelle richieste di streaming con i parametri rdid, idtype e is_lat.
Quando non viene utilizzato l'SDK IMA o quando viene utilizzato il beaconing lato server (SSB), devi passare questi valori come parametri espliciti. 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 |
Esempi di utilizzo
Vedi esempi dettagliati di identificatori di dispositivi reimpostabili.
Requisiti e consigli
Sebbene questi parametri non siano necessari per pubblicare annunci in un'implementazione specifica, sono obbligatori per la monetizzazione con pubblicità programmatica su app mobile, TV connesse a internet, audio e out of home digitale.
Gli identificatori di dispositivi reimpostabili non vengono utilizzati per le implementazioni web.
Utilizzo dell'SDK
L'SDK IMA passerà automaticamente questo campo, a meno che idType non sia impostato su dpid. In questo caso, il publisher dovrà trasmettere manualmente il parametro rdid.
I publisher dovranno passare questi parametri manualmente quando utilizzano l'SDK PAL.
sid (ID sessione)
Descrizione
Il parametro dell'ID sessione (sid) 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.
Puoi disattivare la trasmissione dell'ID sessione impostando sid=0.
Esempi di utilizzo
sid=123e4567-e89b-12d3-a456-426614174000
Questo parametro deve essere compilato nel formato UUID. Scopri di più sugli identificatori reimpostabili di dispositivi per il targeting degli utenti.
Requisiti e consigli
Sebbene questo parametro non sia necessario per pubblicare annunci in un'implementazione specifica, è obbligatorio per la monetizzazione con pubblicità programmatica in out of home digitale.
Questo parametro è consigliato per la monetizzazione con pubblicità programmatica su app mobile, TV connesse a internet e audio.
Utilizzo dell'SDK
Questo parametro viene inviato automaticamente dall'SDK IMA.
venuetype (Tipo di sede)
Descrizione
Il parametro del tipo di sede (venuetype) viene utilizzato per indicare il tipo di sede fuori casa. I valori idonei sono gli ID di enumerazione interi supportati dalla tassonomia del tipo di sede 1.1 OpenOOH di IAB.
Esempi di utilizzo
Camere di hotel:
venuetype=80703
Tablet sul sedile posteriore di un taxi:
venuetype=103
Requisiti e consigli
Questo parametro è obbligatorio per la monetizzazione con pubblicità programmatica in out of home digitale.
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).
an (Nome dell'app)
Descrizione
Il parametro ID app (msid) e il parametro nome app (an) accettano valori variabili che devono essere applicati alle richieste inviate da app mobile e dispositivi TV connessi a internet, dato che sono richiesti dalla maggior parte degli annunci video programmatici.
Il nome dell'app deve essere un nome leggibile.
Esempi 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
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci in un'implementazione specifica, è consigliato per la monetizzazione programmatica in app mobile, TV connesse a internet, audio e out of home digitale.
Per la sicurezza del brand e per offrire una maggiore trasparenza agli acquirenti, è vivamente consigliato includere le informazioni sull'app.
Utilizzo dell'SDK
Ad eccezione di iOS e tvOS, l'SDK IMA compila automaticamente entrambi i parametri, ma devono essere specificati manualmente negli ambienti non SDK, incluse le chiamate VAST dirette, o quando si utilizza la libreria di accesso programmatico (PAL) o l'inventario autenticato dal publisher (PAI).
Su iOS e tvOS, l'SDK IMA o PAL non riesce ad accedere all'ID app. In questi casi, il parametro msid non viene inviato e l'SDK invia l'app bundle tramite il parametro an.
Nota: se viene utilizzato l'SDK IMA HTML5, le informazioni sull'app non vengono utilizzate.
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 e ambienti set-top box, audio e out of home digitale.
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.
msid (ID app)
Descrizione
Il parametro ID app (msid) e il parametro nome app (an) accettano valori variabili che devono essere applicati alle richieste inviate da app mobile e dispositivi TV connessi a internet, dato che sono richiesti dalla maggior parte degli annunci video programmatici.
Il nome dell'app deve essere un nome leggibile.
Esempi 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
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci in un'implementazione specifica, è consigliato per la monetizzazione programmatica in app mobile, TV connesse a internet, audio e out of home digitale.
Per la sicurezza del brand e per offrire una maggiore trasparenza agli acquirenti, è vivamente consigliato includere le informazioni sull'app.
Utilizzo dell'SDK
Ad eccezione di iOS e tvOS, l'SDK IMA compila automaticamente entrambi i parametri, ma devono essere specificati manualmente negli ambienti non SDK, incluse le chiamate VAST dirette, o quando si utilizza la libreria di accesso programmatico (PAL) o l'inventario autenticato dal publisher (PAI).
Su iOS e tvOS, l'SDK IMA o PAL non riesce ad accedere all'ID app. In questi casi, il parametro msid non viene inviato e l'SDK invia l'app bundle tramite il parametro an.
Nota: se viene utilizzato l'SDK IMA HTML5, le informazioni sull'app non vengono utilizzate.
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.