In questo articolo è riportato un elenco completo dei parametri che possono essere utilizzati in un tag annuncio VAST. Può essere utile se vuoi saperne di più su un parametro specifico.
In questa pagina
- Parametri obbligatori per la pubblicazione di annunci
- Parametri obbligatori per la pubblicità programmatica
- Parametri consigliati per la pubblicità programmatica
- Altri parametri
Elenchi dei parametri per tipo di implementazione
Se utilizzi un'implementazione specifica, puoi usare elenchi di parametri personalizzati che descrivono l'utilizzo e i requisiti di quell'implementazione. Utilizza l'elenco di parametri personalizzati per:
Web App per dispositivi mobili TV connessa a internet Audio Out of home digitale
Tutti i parametri
Parametri obbligatori per la pubblicazione di annunci
In genere, questi parametri sono obbligatori per la pubblicazione degli annunci per la maggior parte delle implementazioni. Tuttavia, potrebbero verificarsi casi in cui non sono obbligatori. Per informazioni più accurate, usa l'elenco dei parametri per il tuo tipo di implementazione specifico.
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.
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.
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".
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.
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.
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.
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.
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.
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 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 URL si imposta automaticamente. Se il player imposta questo valore, l'SDK IMA rispetta il valore impostato.
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 obbligatori per la pubblicità programmatica
Descrizione
Il parametro posizionamento OTT (ott_placement) accetta un valore costante che indica una richiesta di posizionamento OTT non in-stream.
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.
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.
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.
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).
Parametri consigliati per la pubblicità programmatica
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).
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.
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.
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
L'SDK IMA completa 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).
Nota: se viene utilizzato l'SDK IMA HTML5, le informazioni sull'app non vengono utilizzate.
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.
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.
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.
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.
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.
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
L'SDK IMA completa 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).
Nota: se viene utilizzato l'SDK IMA HTML5, le informazioni sull'app non vengono utilizzate.
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.
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
Mentre l'SDK IMA passa automaticamente questo campo, i publisher passano questi parametri manualmente quando utilizzano l'SDK PAL.
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
Secondo le linee guida sull'identificatore della pubblicità di IAB, questo parametro deve essere inserito nel formato UUID. Scopri di più sugli identificatori di dispositivi reimpostabili 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.
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).
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.
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.
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.Altri parametri
In genere, questi parametri non sono esplicitamente obbligatori per pubblicare gli annunci, ma potrebbero essere necessari per utilizzare determinate funzionalità o per determinati tipi di implementazione.
Descrizione
Il parametro della regola per gli annunci (ad_rule) accetta un valore costante che indica se restituire una creatività VAST o una risposta alle regole per gli annunci.
L'impostazione predefinita delle regole per gli annunci dipende da un'impostazione della rete Google Ad Manager che consente a tutte le richieste di essere richieste di regole per gli annunci. Se viene utilizzata l'impostazione della rete, non è necessario impostare ad_rule nel tag annuncio. Se vuoi disattivare la funzionalità in base alla richiesta di annunci, puoi passare ad_rule=0 per sostituire l'impostazione della rete. Inoltre, se le regole per gli annunci non sono attive per impostazione predefinita, puoi attivarle o disattivarle passando rispettivamente ad_rule=1 e ad_rule=0.
Esempi di utilizzo
Se l'impostazione delle regole per gli annunci è disattivata:
- Richiesta di creatività VAST:
ad_rule=0o non impostato
Se l'impostazione delle regole per gli annunci è attiva:
- Richiesta di creatività VAST:
ad_rule=0 - Richiesta di regole per gli annunci (VMAP):
ad_rule=1o non impostato
Se scegli di non utilizzare le regole degli annunci, puoi utilizzare i parametri dei tag annuncio per indicare la durata dell'interruzione pubblicitaria e del pod per i tag VAST utilizzando pmnd, pmxd e pmad.
Requisiti e consigli
Sebbene questo parametro non sia necessario per pubblicare annunci per un tipo di implementazione specifico, è obbligatorio per utilizzare correttamente le regole per gli annunci video.
Descrizione
Il parametro del Consenso aggiuntivo (addtl_consent) accetta valori variabili ed è utilizzato dai publisher che vogliono integrare la versione 2.0 del TCF di IAB e utilizzare un fornitore non ancora registrato nell'Elenco dei fornitori globali (Global Vendor List, GVL) di IAB Europe, ma che è presente nell'elenco dei fornitori di tecnologia pubblicitaria (ATP) di Google.
Per ulteriori informazioni sui valori trasmessi a questo parametro, consulta la pagina Specifica tecnica della Modalità di Consenso aggiuntivo.
Esempio di utilizzo
addtl_consent=1~1.35.41.101
Descrizione
Il parametro di test degli annunci (adtest) deve essere utilizzato per assicurarsi che le query usate per testare l'inventario di backfill (non garantito) non vengano identificate come traffico non valido e non abbiano un impatto sulle entrate.
Quando testi il backfill, imposta questo parametro su on per assicurarti che nessun annuncio registri impressioni o clic durante il test. Impostalo su off negli ambienti di test per eseguire la fatturazione normalmente. Se non viene impostato, il valore predefinito di questo parametro è off.
Nota: quando testi gli elementi pubblicitari venduti direttamente, devi utilizzare elementi pubblicitari di test senza impatto sulle entrate.
Esempi di utilizzo
On:
adtest=on
Off:
adtest=off
Descrizione
Il parametro del tipo di annuncio (ad_type) accetta un valore costante che indica i tipi di annunci da restituire per la richiesta.
Quando ad_type è impostato su audio oppure audio_video, il parametrovpmute deve essere impostato su 0.
Esempi di utilizzo
Consente solo annunci audio:
ad_type=audio
Consente annunci video ignorabili e non ignorabili:
ad_type=video
Consente annunci audio e video:
ad_type=audio_video
Questo valore
audio_videoconsente a entrambi i formati di competere, ma ne viene pubblicato solo uno. È destinato esclusivamente alla pubblicazione di creatività video in contenuti audio che supportano la riproduzione di annunci video o creatività audio in video player in-stream per contenuti che possono essere "ascoltati" di natura, come stream di sport, videocast, notizie e così via. Scopri di più sull'audio nei contenuti video.
Consente solo annunci video ignorabili:
ad_type=skippablevideo
Consente solo annunci video non ignorabili:
ad_type=standardvideo
Requisiti e consigli
- Se la tua app include contenuti video, imposta questo parametro su
video,audio_videoo non impostarlo. - Se la tua app include solo contenuti audio (ad esempio un'app di radio o con contenuti parlati), devi impostare questo parametro su
audio. Se non viene impostato, non verranno restituiti annunci audio.
Descrizione
Il parametro delle dimensioni degli annunci non lineari (afvsz) accetta valori costanti che devono essere un elenco separato da virgole di dimensioni di annunci non lineari da poter visualizzare nell'area annuncio video.
Le dimensioni devono essere tra quelle supportate:
200 x 200250 x 250300 x 250336 x 280450 x 50468 x 60480 x 90729 x 90
Quando utilizzi l'SDK IMA, i contenuti di questo campo vengono sovrascritti e completati con tutte le dimensioni supportate comprese tra nonLinearAdSlotWidth e nonLinearAdSlotHeight.
Il parametro può essere omesso o lasciato vuoto quando non sono supportate dimensioni non lineari.
Esempi di utilizzo
Sono supportate tutte le dimensioni:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90
La larghezza massima è 250:
afvsz=200x200,250x250
L'altezza massima è 60:
afvsz=450x50,468x60
La larghezza massima è 100:
//empty; no values supported
Requisiti e consigli
Sebbene questo parametro non sia necessario per pubblicare annunci per un tipo di implementazione o transazione specifico, è obbligatorio per pubblicare annunci video non lineari se non utilizzi l'SDK IMA.
Descrizione
Il parametro tutti i cue (allcues) accetta valori variabili che sono un elenco separato da virgole di cue point espressi in millisecondi. Per ogni valore Google Ad Manager restituisce un'interruzione pubblicitaria.
- I parametri
vid_deallcuesvengono usati per pubblicare annunci mid-roll senza importazione di contenuti. - Per restituire mid-roll sono necessarie anche 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
Cue point a 10 e 20 secondi:
allcues=10000,20000
Descrizione
Il parametro delle dimensioni companion (ciu_szs) accetta valori variabili che devono essere un elenco separato da virgole di dimensioni companion.
I valori separati da barra verticale (|) indicano un'area annuncio con più dimensioni.
Esempi di utilizzo
ciu_szs=728x90,300x250
Dimensioni con un'area annuncio con più dimensioni:
ciu_szs=728x90,300x200|300x250
Descrizione
I parametri ID origine di contenuto (cmsid) e ID video (vid) accettano valori variabili.
Per indirizzare gli annunci a contenuti video, il tag video principale deve includere entrambi questi parametri.
cmsidè un numero univoco per ogni origine di contenuto. Per individuarlo in Google Ad Manager, fai clic su Video, poi su Origini di contenuto e poi sul nome dell'origine.vidè una stringa o un numero che identifica un particolare video. Questo ID viene assegnato dal CMS che ospita il tuo contenuto. Per individuarlo in Google Ad Manager, fai clic su Video, su Contenuti e poi sul contenuto video specifico.
Esempi di utilizzo
cmsid=[value]&vid=[value]
Se stai creando un tag per un video on demand con l'inserimento di annunci dinamici, dovresti utilizzare le macro che inseriscono in modo dinamico l'ID video e l'origine di contenuto corretti.
Ad esempio: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Requisiti e consigli
Sebbene questi parametri non siano necessari per pubblicare annunci in un tipo di implementazione o transazione specifico, sono obbligatori per utilizzare il targeting basato sui contenuti video.
Descrizione
Il parametro dei parametri personalizzati (cust_params) accetta valori variabili, ovvero coppie chiave-valore che ti consentono di impostare un targeting specifico, come dati demografici, determinate posizioni su una pagina oppure una o più pagine specifiche.
Esempi di utilizzo
Consulta alcuni esempi di come aggiungere coppie chiave-valore.
Descrizione
Il parametro della categoria di esclusione (excl_cat) accetta valori variabili ed è utilizzato per bloccare tutti gli elementi pubblicitari contenenti l'etichetta di esclusione nella richiesta di annuncio. Utilizza il parametro cust_params per impostare la categoria e le etichette di esclusione.
Esempi di utilizzo
Per impostare la categoria di esclusione per due etichette di esclusione (airline_excl_label e train_excl_label), utilizza il carattere della barra verticale (|) per separare le etichette:
excl_cat=airline_excl_label%7Ctrain_excl_label
Quindi, applica la codifica URL e utilizza la stringa codificata in cust_params:
&cust_params=excl_cat%3Dairline_excl_label%7Ctrain_excl_label
Descrizione
Il parametro GDPR (gdpr) accetta valori costanti ed è utilizzato dai publisher che vogliono integrare la versione 2.0 del TCF di IAB. Le richieste VAST dirette non leggono automaticamente i valori, ma questi vengono accettati se aggiunti ai tag annuncio.
Solo 0 e 1 sono valori validi per questo parametro, dove 0 indica che il GDPR non è applicabile e 1 che si applica il GDPR. Se si applica il GDPR, devi fornire anche una stringa TC valida utilizzando il parametro gdpr_consent.
Per ulteriori informazioni sui valori trasmessi a questo parametro, consulta le indicazioni generali per l'implementazione del framework oppure la sezione relativa alla stringa TC della specifica TCF versione 2.0 di IAB.
Esempi di utilizzo
Si applica il GDPR:
gdpr=1
Il GDPR non si applica:
gdpr=0
Descrizione
Il parametro del consenso GDPR (gdpr_consent) accetta valori variabili ed è utilizzato dai publisher che vogliono integrare la versione 2.0 del TCF di IAB. Le richieste VAST dirette non leggono automaticamente i valori, ma questi vengono accettati se aggiunti ai tag annuncio.
Per ulteriori informazioni sui valori trasmessi a questo parametro, consulta le indicazioni generali per l'implementazione del framework oppure la sezione relativa alla stringa TC della specifica TCF versione 2.0 di IAB.
Esempi di utilizzo
gdpr_consent=GDPR_CONSENT_123
Descrizione
Il parametro URL di esclusione IAB (iabexcl) accetta valori variabili, ovvero un elenco separato da virgole di categorie.
Esempi di utilizzo
iabexcl=3,14,527 esclude "Autocarri commerciali", "Veicoli fuoristrada" e "Rugby".
Puoi scaricare un elenco delle categorie della tassonomia dei contenuti IAB e dei relativi ID.
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
Mentre l'SDK IMA passa automaticamente questo campo, i publisher passano questi parametri manualmente quando utilizzano l'SDK PAL.
Descrizione
Il parametro del dominio del partner di inventario (ipd) accetta valori variabili che devono essere impostati sulle dichiarazioni inventorypartnerdomain nel file app-ads.txt (o ads.txt) del publisher.
Il parametro inventorypartnerdomain è una specifica dell'IAB che consente ai publisher di designare un dominio di un partner di condivisione dell'inventario per la convalida del file ads.txt/app-ads.txt.
La dichiarazione IPD è particolarmente importante nei casi d'uso di condivisione dell'inventario, in cui l'inventario pubblicitario da cui proviene una richiesta potrebbe essere di proprietà di un altro partner (il partner di condivisione dell'inventario).
Scopri di più su ads.txt/app-ads.txt e sui partner di condivisione dell'inventario.
Esempi di utilizzo
inventorypartnerdomain si trova nel file app-ads.txt che rimanda al file .txt del partner che può monetizzare l'inventario. Il valore nel parametro ipd deve corrispondere a un valore nel file app-ads.txt in uno degli elementi inventorypartnerdomain.Requisiti e consigli
Questo parametro è obbligatorio per i publisher che monetizzano su un inventario di proprietà di terze parti.
Descrizione
Il parametro dell'entità del ping delle impressioni (ipe) accetta un valore costante utilizzato per indicare i ping delle impressioni e le conversioni che hanno origine dal server, non dal client.
L'entità del ping delle impressioni viene utilizzata quando un server invia ping o beacon delle impressioni dal server.
Esempi di utilizzo
Beaconing lato server (SSB):
ipe=ssb
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
Mentre l'SDK IMA passa automaticamente questo campo, i publisher passano questi parametri manualmente quando utilizzano l'SDK PAL.
Descrizione
Il parametro ultima posizione nel pod (lip) accetta un valore costante per indicare una richiesta dall'ultima posizione in un pod per il targeting o i report.
Nota: questo parametro non si applica ai pod ottimizzati e viene ignorato se utilizzato.
Esempi di utilizzo
lip=1
Descrizione
Il parametro annunci con limitazioni (ltd) accetta un valore costante che indica se pubblicare annunci in modo limitato o meno in assenza del consenso all'uso di cookie o altri identificatori locali.
Questo parametro viene utilizzato per indicare una richiesta di annunci con limitazioni ed è diverso dal parametro is_lat. Disattiva la personalizzazione e l'utilizzo di identificatori per queste finalità.
ltd=1 cambia il comportamento dell'SDK IMA per trattare la richiesta come se fosse senza ID e per non consentire l'archiviazione.Esempi di utilizzo
ltd=1
Descrizione
Il parametro durata minima dell'annuncio (min_ad_duration) e il parametro durata massima dell'annuncio (max_ad_duration) accettano valori variabili che, considerati insieme, specificano la durata (in millisecondi) che un annuncio deve rispettare.
Questi parametri possono essere utilizzati per limitare le creatività a una durata richiesta nel tag annuncio per singoli annunci o nelle richieste di pod ottimizzati.
Esempi di utilizzo
min_ad_duration=15000&max_ad_duration=30000
Descrizione
Il parametro durata minima dell'annuncio (min_ad_duration) e il parametro durata massima dell'annuncio (max_ad_duration) accettano valori variabili che, considerati insieme, specificano la durata (in millisecondi) che un annuncio deve rispettare.
Questi parametri possono essere utilizzati per limitare le creatività a una durata richiesta nel tag annuncio per singoli annunci o nelle richieste di pod ottimizzati.
Esempi di utilizzo
min_ad_duration=15000&max_ad_duration=30000
Descrizione
Il parametro numero di mid-roll (mridx) accetta un valore variabile che indica il numero ordinale del mid-roll (ad esempio, mid-roll 1, mid-roll 2 e così via).
Esempi di utilizzo
mridx=2
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci per un'implementazione o un tipo di transazione specifici, è obbligatorio per scegliere come target un mid-roll specifico, generare report sul mid-roll e fare previsioni sul mid-roll.
Descrizione
Il parametro senza riserva (nofb) accetta un valore costante per indicare che la richiesta di annuncio non deve restituire una playlist di annunci video di riserva.
Esempi di utilizzo
Riserva disattivata
:
nofb=1
L'annuncio di riserva singolo e il buffet pubblicitario per i pod ottimizzati possono essere disattivati su base di richiesta di annuncio trasmettendo nofb=1.
Descrizione
Il parametro annunci non personalizzati (npa) accetta un valore costante a indicare che la richiesta di annuncio deve essere considerata non personalizzata.
È necessario specificare npa=1 o includere semplicemente npa (senza un valore impostato) per codificare la richiesta come non personalizzata. Le richieste di annunci che non presentano questo parametro o che sono impostate su npa=0 ricevono per impostazione predefinita annunci personalizzati.
Esempi di utilizzo
Annunci non personalizzati
:
npa=1
Requisiti e consigli
Questo parametro è obbligatorio solo se l'utente disattiva la personalizzazione. I publisher devono assicurarsi di rappresentare lo stato esatto dell'utente quando lo controllano.
Descrizione
Il parametro posizionamento OTT (ott_placement) accetta un valore costante che indica una richiesta di posizionamento OTT non in-stream.
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.
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.
Descrizione
Il parametro massimo annunci pod (pmad) accetta un valore variabile che indica il numero massimo di annunci in un pod.
Questo parametro limita il numero totale di annunci in un pod ottimizzato, una funzionalità disponibile per i publisher che dispongono di un pacchetto video avanzato.
Questo parametro non deve essere utilizzato per VMAP (se ad_rule=1).
Esempi di utilizzo
pmad=4
Descrizione
Il parametro durata minima del pod (pmnd) e il parametro durata massima del pod (pmxd) accettano valori variabili che, considerati insieme, specificano la durata (in millisecondi) che un pod deve rispettare.
Questi parametri vengono utilizzati per richiedere più annunci in un pod ottimizzato, una funzionalità disponibile per i publisher che dispongono di un pacchetto video avanzato. Quando vengono utilizzate le regole per gli annunci, Google Ad Manager aggiunge automaticamente queste informazioni.
Questo parametro non deve essere utilizzato per VMAP (se ad_rule=1).
Esempi di utilizzo
pmnd=0&pmxd=60000
Descrizione
Il parametro durata minima del pod (pmnd) e il parametro durata massima del pod (pmxd) accettano valori variabili che, considerati insieme, specificano la durata (in millisecondi) che un pod deve rispettare.
Questi parametri vengono utilizzati per richiedere più annunci in un pod ottimizzato, una funzionalità disponibile per i publisher che dispongono di un pacchetto video avanzato. Quando vengono utilizzate le regole per gli annunci, Google Ad Manager aggiunge automaticamente queste informazioni.
Questo parametro non deve essere utilizzato per VMAP (se ad_rule=1).
Esempi di utilizzo
pmnd=0&pmxd=60000
Descrizione
Il parametro del tempo di visualizzazione forzato massimo del pod (pmxfwt) accetta un valore variabile che specifica la durata massima non ignorabile di un pod in millisecondi.
Se supporti pod con una combinazione di annunci video non ignorabili e ignorabili e vuoi limitare la durata degli annunci per gli utenti, usa questo parametro per definire la durata massima di visualizzazione degli annunci non ignorabili per l'utente.
Nota: il parametro durata massima del pod (pmxd) sostituisce questo parametro per definire la durata totale massima del pod (inclusa la durata complessiva per gli annunci ignorabili).
Esempio di utilizzo
pmxfwt=30000
Descrizione
Il parametro numero di pod (pod) accetta un valore variabile che rappresenta il numero ordinale del pod in un video (ad esempio, pod 1, pod 2 e così via).
Esempi di utilizzo
pod=3
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci per un tipo di implementazione o transazione specifico, è obbligatorio per consentire la pubblicazione dello stesso annuncio in pod diversi e per utilizzare correttamente le esclusioni competitive, la quota limite e le relative funzionalità.
Descrizione
Il parametro profilo della creatività (pp) 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.
Esempi di utilizzo
pp=creative_profile
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci in un'implementazione specifica, è obbligatorio per limitare i file multimediali per le creatività ospitate da Google Ad Manager con profili di creatività video e audio. Per i reindirizzamenti o gli annunci programmatici, viene utilizzato per garantire la disponibilità del requisito, ma non limita i file multimediali a quelli selezionati nel profilo della creatività.
Descrizione
Il parametro Publisher Privacy Treatment (ppt) accetta un valore costante che viene utilizzato per indicare se disattivare la personalizzazione degli annunci per la richiesta di annuncio.
Questo parametro consente di applicare annunci non personalizzati che possono essere diversi da npa=1 e rdp=1. Ha impatto sia sulle prenotazioni sia sulla domanda di pubblicità programmatica.
Scopri di più su Publisher Privacy Treatment.
Esempi di utilizzo
Disattiva la personalizzazione degli annunci
:
ppt=1
Descrizione
Il parametro identificatore fornito dal publisher (PPID) accetta un valore variabile ed è usato per la quota limite, la segmentazione del pubblico, il targeting, la rotazione degli annunci sequenziale e altri controlli di pubblicazione degli annunci basati sui segmenti di pubblico nei vari dispositivi.
Scopri di più sugli identificatori forniti dai publisher.
Esempi di utilizzo
ppid=12JD92JD8078S8J29SDOAKC0EF230337
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci per un tipo di implementazione o transazione specifico, è obbligatorio per utilizzare un identificatore coerente indipendentemente dalla piattaforma. Può essere utilizzato quando non sono presenti altri identificatori e può essere fornito agli acquirenti.
Descrizione
Il parametro posizione nel pod (ppos) accetta un valore variabile che rappresenta la posizione all'interno di un pod (ad esempio, posizione 1, posizione 2 e così via).
Questo parametro interessa soltanto i pod standard ed è obbligatorio per la compilazione automatica degli annunci companion. Quando vengono utilizzate le regole per gli annunci, Google Ad Manager aggiunge automaticamente queste informazioni.
Esempi di utilizzo
ppos=2
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci per un tipo specifico di implementazione o transazione, è obbligatorio per i pod standard quando è necessario il targeting per posizione e per le previsioni e i report sui pod standard. È inoltre obbligatorio per utilizzare correttamente le esclusioni competitive, la quota limite e le relative funzionalità.
Descrizione
Il parametro JSON degli indicatori forniti dal publisher (ppsj) accetta un valore variabile con codifica base64 contenente i dati relativi al pubblico e al contesto forniti dal publisher per migliorare la monetizzazione della pubblicità programmatica.
Questo parametro può essere utilizzato per inviare determinati indicatori agli acquirenti/offerenti.
Scopri di più sugli indicatori forniti dal publisher e sulle tassonomie supportate.
Esempi di utilizzo
Oggetto JSON
:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
Applica il valore con codifica base64
:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
Esamina i dettagli delle coppie chiave-valore JSON valide
nell'esempio di SDK IMA per HTML5.
Descrizione
Il parametro ID modello di interruzione pubblicitaria (ptpl) e il parametro nome (ptpln) accettano valori variabili che vengono utilizzati per indicare quale modello di interruzione pubblicitaria deve essere applicato alla richiesta del pod ottimizzato.
I modelli di interruzioni pubblicitarie consentono di configurare gli spot pubblicitari o spot pubblicitari personalizzati da includere in un'interruzione pubblicitaria e di stabilire in quale ordine devono essere pubblicati.
Per richiedere un modello di interruzione pubblicitaria è necessario solo uno di questi parametri.
Esempi di utilizzo
Scopri di più su come configurare e richiedere modelli di interruzione pubblicitaria.
Requisiti e consigli
Questi parametri sono obbligatori solo se richiedi direttamente un modello di interruzione pubblicitaria.
Descrizione
Il parametro ID modello di interruzione pubblicitaria (ptpl) e il parametro nome (ptpln) accettano valori variabili che vengono utilizzati per indicare quale modello di interruzione pubblicitaria deve essere applicato alla richiesta del pod ottimizzato.
I modelli di interruzioni pubblicitarie consentono di configurare gli spot pubblicitari o spot pubblicitari personalizzati da includere in un'interruzione pubblicitaria e di stabilire in quale ordine devono essere pubblicati.
Per richiedere un modello di interruzione pubblicitaria è necessario solo uno di questi parametri.
Esempi di utilizzo
Scopri di più su come configurare e richiedere modelli di interruzione pubblicitaria.
Requisiti e consigli
Questi parametri sono obbligatori solo se richiedi direttamente un modello di interruzione pubblicitaria.
Descrizione
Il parametro prezzo pubblico per Ad Exchange (pubf) e il parametro prezzo privato per Ad Exchange (pvtf) accettano valori variabili che vengono utilizzati per aggiungere prezzi minimi ai tag di Ad Exchange.
Questi parametri sono l'equivalente di google_ad_public_floor e google_ad_private_floor.
Esempi di utilizzo
Prezzo pubblico
:
pubf=123
Prezzo privato
:
pvtf=123
Requisiti e consigli
Questi parametri sono disponibili solo per i publisher nello Spazio economico europeo ("SEE") o in Svizzera che hanno ricevuto l'approvazione per l'utilizzo della funzionalità "Prezzo minimo".
Scopri come inviare una richiesta.
Descrizione
Il parametro ID set di app (pvid) accetta un valore variabile impostato sull'ID set di app per Android, mentre il parametro ambito set di app (pvid_s) accetta un valore costante che rappresenta l'ambito dell'ID set di app (scope_app o scope_developer).
Leggi la documentazione per Android su come recuperare l'ID set di app.
Esempi di utilizzo
pvid=[AppSetID_value]
pvid_s=scope_app
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci in un'implementazione specifica, è consigliato per la monetizzazione programmatica nelle app mobile sui dispositivi Android.
Utilizzo dell'SDK
L'SDK IMA/PAL passa automaticamente questo campo, invece i publisher con implementazioni senza SDK devono chiamare l'SDK del set di app e passare questi parametri manualmente nella richiesta di annuncio.
Descrizione
Il parametro ID set di app (pvid) accetta un valore variabile impostato sull'ID set di app per Android, mentre il parametro ambito set di app (pvid_s) accetta un valore costante che rappresenta l'ambito dell'ID set di app (scope_app o scope_developer).
Leggi la documentazione per Android su come recuperare l'ID set di app.
Esempi di utilizzo
pvid=[AppSetID_value]
pvid_s=scope_app
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci in un'implementazione specifica, è consigliato per la monetizzazione programmatica nelle app mobile sui dispositivi Android.
Utilizzo dell'SDK
L'SDK IMA/PAL passa automaticamente questo campo, invece i publisher con implementazioni senza SDK devono chiamare l'SDK del set di app e passare questi parametri manualmente nella richiesta di annuncio.
Descrizione
Il parametro prezzo pubblico per Ad Exchange (pubf) e il parametro prezzo privato per Ad Exchange (pvtf) accettano valori variabili che vengono utilizzati per aggiungere prezzi minimi ai tag di Ad Exchange.
Questi parametri sono l'equivalente di google_ad_public_floor e google_ad_private_floor.
Esempi di utilizzo
Prezzo pubblico
:
pubf=123
Prezzo privato
:
pvtf=123
Requisiti e consigli
Questi parametri sono disponibili solo per i publisher nello Spazio economico europeo ("SEE") o in Svizzera che hanno ricevuto l'approvazione per l'utilizzo della funzionalità "Prezzo minimo".
Scopri come inviare una richiesta.
Descrizione
Il parametro del trattamento dati limitato (rdp) accetta un valore costante, a indicare che la richiesta di annuncio deve limitare il trattamento dati.
Puoi limitare il trattamento dati a livello di rete attivando l'impostazione di rete Trattamento dati limitato.
Esempi di utilizzo
Trattamento dati limitato:
rdp=1 o rdp (senza un valore impostato)
Trattamento dati non limitato:
rdp=0
Descrizione
Il parametro della catena di fornitura (schain) accetta un valore variabile che deve essere un oggetto SupplyChain serializzato. Quando questo parametro è incluso, Google aggiunge un nodo a tutti gli oggetti schain ricevuti prima di inviarli agli acquirenti.
Consulta la documentazione completa di IAB per comunicare le informazioni di SupplyChain tramite un tag (anziché OpenRTB).
In base alla documentazione di IAB, di seguito è descritta la serializzazione dell'oggetto SupplyChain:
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObjecteSupplyChainNodesono proprietà separate da virgole in modo che i campi facoltativi possano essere omessi e quelli che è possibile escludere facoltativamente separati da virgole.- Ogni elemento
SupplyChainNodeè separato da un "!". - Se il valore di una proprietà contiene caratteri che richiedono la codifica dell'URL (ad esempio "
," o "!"), il valore deve essere codificato nell'URL prima della serializzazione.
Ordine di serializzazione
Le proprietà SupplyChainObject vengono serializzate in questo ordine:
ver,complete
Le proprietà SupplyChainNode vengono serializzate in questo ordine:
asi,sid,hp,rid,name,domain,ext
ext sono specifici della piattaforma di scambio pubblicitario. Google Ad Manager non analizza questa proprietà.Esempi di come eseguire la serializzazione dell'oggetto SupplyChain
Di seguito sono riportati due esempi di metodi per serializzare l'oggetto SupplyChain riportato sopra:
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Esempi di utilizzo
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
Se il valore di asi fosse exchange,1, la serializzazione con caratteri di escape sarebbe la seguente:
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Requisiti e consigli
Sebbene questo parametro non sia necessario per pubblicare annunci per un tipo di implementazione o transazione specifico, è obbligatorio per i publisher che utilizzano intermediari di pagamento a monte della richiesta a Google Ad Manager. Sono inclusi i publisher che utilizzano la tecnologia ad server di terze parti.
Descrizione
Il parametro del correlatore stream (scor) accetta un valore variabile che deve essere un intero generato per ciascuno stream video.
Non è necessario che i parametri scor e correlator abbiano lo stesso valore intero. Tuttavia, devono mantenere i rispettivi valori durante la riproduzione di ogni stream video per identificare una sessione di visualizzazione unica.
Esempi di utilizzo
scor=17
Requisiti e consigli
Sebbene questo parametro non sia obbligatorio per pubblicare annunci per un'implementazione o un tipo di transazione specifici, è consigliato per la pubblicazione di annunci su web, app mobile, TV connesse a internet, audio e out of home digitale.
Questo parametro viene utilizzato per esclusioni competitive, quota limite e relative funzionalità quando un utente guarda più video nella stessa pagina.
Descrizione
Il parametro del framework dell'API SDK (sdk_apis) accetta un elenco separato da virgole di valori interi costanti che indicano tutti i framework dell'API supportati dal player.
Requisiti e consigli
Utilizzo dell'SDK
Questo parametro viene utilizzato dai publisher che utilizzano la libreria di accesso programmatico (PAL). Se provi a impostare valori per questo parametro durante l'utilizzo dell'SDK IMA, verrà eseguito l'override dei valori con quelli supportati dall'SDK IMA.
Descrizione
Il parametro della durata massima dell'annuncio ignorabile (sdmax) accetta un valore variabile che consente ai publisher di specificare la durata massima che preferiscono per gli annunci ignorabili.
Richiede una durata in millisecondi che rappresenta il limite massimo consentito per la durata delle creatività video/audio ignorabili per quella determinata richiesta di annuncio.
Utilizza sdmax in modo indipendente per gli annunci ignorabili o in combinazione con il parametro max_ad_duration esistente per fornire durate massime diverse per gli annunci ignorabili e non ignorabili.
Esempi di utilizzo
L'uso delle seguenti impostazioni:
max_ad_duration= 15.000 (15 secondi)sdmax= 45.000 (45 secondi)
Per le seguenti creatività:
- Creatività A: non ignorabile; 30 s
- Creatività B: ignorabile; 30 s
Produce i seguenti risultati:
- La Creatività A verrà filtrata perché non è ignorabile e la sua durata supera il limite massimo (non ignorabile).
- La Creatività B non verrà filtrata perché, anche se la sua durata supera il valore
max_ad_duration, è ignorabile e la sua durata non supera il limite massimo.
Descrizione
Il parametro relativo all'origine dello stitching lato server (ssss) accetta un valore costante che deve essere impostato su un valore riconosciuto e fornito da Google per il fornitore di tecnologia di stitching video.
I fornitori di tecnologia di stitching video che utilizzano le integrazioni server-server con Google ricevono questo valore da Google e sono in grado di fornirlo a te. Per eventuali domande sul valore da impostare per questo parametro, puoi contattare il tuo account manager Google.
Esempi di utilizzo
ssss=mystitcher
Requisiti e consigli
Sebbene questo parametro non sia necessario per pubblicare annunci per un tipo di implementazione o transazione specifico, è obbligatorio per utilizzare le implementazioni lato server.
Descrizione
Il parametro del trattamento per siti o servizi destinati ai minori (tfcd) accetta un valore costante che indica che la richiesta deve essere considerata rivolta ai minori.
Esempi di utilizzo
tfcd=1
Descrizione
Il parametro del tipo di traffico (trt) accetta un valore costante che serve a richiedere traffico organico o acquistato.
Esempi di utilizzo
Richiesta di traffico acquistato:
trt=1
Richiesta di traffico organico:
trt=2
Requisiti e consigli
Utilizzo dell'SDK
L'SDK IMA non inserisce un valore predefinito se in una richiesta manca il parametro del tipo di traffico. In questi casi, il server fornisce un valore predefinito di 0 (traffico non definito).
Descrizione
La stringaus_national è stata ritirata da IAB a favore della GPP. Tuttavia, Ad Manager continua a leggere e rispettare la stringa se viene passata per la compatibilità con le versioni precedenti. Consigliamo ai publisher di esaminare la GPP o altri controlli per la privacy ed eseguire la migrazione da us_national.
Descrizione
Il parametro del tipo di annuncio video (vad_type) accetta un valore costante che indica se restituire un annuncio lineare o non lineare.
Esempi di utilizzo
Per restituire un annuncio lineare:
vad_type=linear
Per restituire un annuncio non lineare:
vad_type=nonlinear
Descrizione
I parametri ID origine di contenuto (cmsid) e ID video (vid) accettano valori variabili.
Per indirizzare gli annunci a contenuti video, il tag video principale deve includere entrambi questi parametri.
cmsidè un numero univoco per ogni origine di contenuto. Per individuarlo in Google Ad Manager, fai clic su Video, poi su Origini di contenuto e poi sul nome dell'origine.vidè una stringa o un numero che identifica un particolare video. Questo ID viene assegnato dal CMS che ospita il tuo contenuto. Per individuarlo in Google Ad Manager, fai clic su Video, su Contenuti e poi sul contenuto video specifico.
Esempi di utilizzo
cmsid=[value]&vid=[value]
Se stai creando un tag per un video on demand con l'inserimento di annunci dinamici, dovresti utilizzare le macro che inseriscono in modo dinamico l'ID video e l'origine di contenuto corretti.
Ad esempio: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Requisiti e consigli
Sebbene questi parametri non siano necessari per pubblicare annunci in un tipo di implementazione o transazione specifico, sono obbligatori per utilizzare il targeting basato sui contenuti video.
Descrizione
Il parametro della playlist video in linea (vpi) accetta un valore costante che indica se pubblicare VMAP in linea (restituire VAST all'interno di VMAP).
Questo parametro può essere usato per ridurre la latenza e garantire quote limite ed esclusioni competitive in uno stream video.
Esempi di utilizzo
Per restituire VAST:
vpi=1
Per restituire reindirizzamenti:
vpi=0