Macro per l'inserimento di annunci dinamici

Leggi ulteriori informazioni sulle macro, incluso come funzionano con Ad Manager, oltre a un elenco completo di macro di rendering, monitoraggio e video.

Andare a una macro specifica dell'elenco

Macro di richiesta di annuncio _{Framework API APP bundle Chiave asset Durata massima dell'interruzione Posizione dell'interruzione Busting della cache Client-ID ID CMS DAI_PRE Dominio FW CAID GDPR Consenso GDPR}	_{Nonce del video in-stream di Google IFA Tipo IFA Limita il monitoraggio degli annunci MIME contenuti multimediali Annunci non personalizzati Partner OMID URL pagina Tipo di posizionamento Normative SCTE-35 Lato server ID stream}	_{TFCD TFUA Timestamp ID transazione US privacy User agent Indirizzo IP utente Durata video Durata video in secondi ID video Titolo video}
Macro di monitoraggio VAST _{Busting della cache Codice di errore}

Espandi tutto Comprimi tutto

Macro di richiesta di annuncio

Le macro di richiesta di annuncio mostrate qui possono essere utilizzate solo in un tag annuncio per l'inserimento di annunci dinamici (DAI) per un'origine di contenuto video on demand o in live streaming. Non funzionano nel contesto delle creatività VAST.

Le macro con parentesi quadre sono generalmente necessarie per superare la convalida delle macro di Ad Manager per i reindirizzamenti.

Framework API

Macro
`[APIFRAMEWORKS]`

Il parametro sdk_apis.

APP bundle

Macro
`[APPBUNDLE]`

Il parametro an.

Chiave asset

Macro
`%%ASSET_KEY%%`

Si espande nel codice evento del live streaming.

Posizione dell'interruzione

Macro
`[BREAKPOSITION]`

Macro VAST 4.1. Restituisce valori:

1: per pre-roll
2: per mid-roll
3: per post-roll
4: per annunci autonomi
0: per nessuno dei casi precedenti/altro

Durata massima dell'interruzione

Macro
`%%BREAK_DURATION%%`
`[BREAKMAXDURATION]`

Durata dell'interruzione pubblicitaria corrente, in secondi.

[BREAKMAXDURATION] deve essere utilizzato solo per i reindirizzamenti di Ad Manager dove non è consentito %%BREAK_DURATION%%.

Busting della cache

Macro
`[CACHEBUSTING]`

Un numero casuale.

Client-ID

Macro
`[CLIENTUA]`

L'ID del player e del client VAST utilizzati.

ID CMS

Macro
`%%CMS_ID%%`

Si espande nell'ID dell'origine di contenuto Ad Manager ("ID CMS") in fase di riproduzione. Questo valore non viene visualizzato nel feed MRSS, ma è visibile nell'interfaccia di Ad Manager.

DAI_PRE

Macro
`%%DAI_PRE%%`

Il valore predefinito è 0. Impostato su 1 quando la richiesta di annuncio viene effettuata nel contesto di una richiesta non bloccante o di una richiesta spalmata, ad esempio una "interruzione anticipata" o un "precaricamento". Questo indica agli ad server che potrebbe essere disponibile più tempo per l'elaborazione della richiesta di annuncio.

Applicabile solo al traffico lineare dal vivo.

Dominio

Macro
`[DOMAIN]`

Macro VAST 4.1. Dominio dell'URL referer per la creazione dello stream.

FW CAID

Macro
`%%FW_CAID%%`

Solo per VOD: ID asset FreeWheel personalizzato dal feed MRSS

Macro
`%%GDPR%%`

Il parametro gdpr.

Consenso GDPR

Macro
`[GDPRCONSENT]`

Il parametro gdpr_consent.

Nonce del video in-stream di Google

Macro
`[GOOGLE_INSTREAM_VIDEO_NONCE]`

Il parametro givn.

IFA

Macro
`[IFA]`

Un ID pubblicità reimpostabile recuperato dal parametro rdid. L'ID pubblicità viene passato solo alle richieste di annunci principali se consentito dai flag sulla privacy (come tfcd e is_lat).

Tipo IFA

Macro
`[IFATYPE]`

Il parametro DAI idtype. Il tipo di IFA viene passato solo alle richieste di annunci principali se consentito dai flag sulla privacy (come tfcd e is_lat).

Limita il monitoraggio degli annunci

Macro
`[LIMITADTRACKING]`

Il parametro ltd.

MIME contenuti multimediali

Macro
`[MEDIAMIME]`

Macro VAST 4.1: elenco delimitato da virgole dei media di tipo MIME supportati.

Annunci non personalizzati

Macro
`%%NPA%%`

Si espande nel valore 1 per taggare la richiesta come non personalizzata.

Questa macro viene utilizzata con le richieste di annuncio soggette al GDPR e solo in un tag annuncio per l'inserimento di annunci dinamici. Vedi altre macro per GDPR.

Partner OMID

Macro
`[OMIDPARTNER]`

Macro VAST 4.1: il parametro omid_p.

URL pagina

Macro
`[PAGEURL]`

Macro VAST 4.1: l'URL referer per la creazione dello stream.

Tipo di posizionamento

Macro
`[PLACEMENTTYPE]`

Macro VAST 4.1: per DAI il valore sarà sempre 1 (in-stream).

Guarda il video AdCOM Placement Subtypes.

Normative

Macro
`[REGULATIONS]`

Macro VAST 4.1: elenco separato da virgole di normative applicabili, in base ai parametri. La presenza di tfcd=1 aggiungerà "coppa", gdpr=1 aggiungerà "gdpr".

Lato server

Macro
`[SERVERSIDE]`

Macro VAST 4.1: sempre 1.

SCTE-35

Macro
`%%SPLICE_INSERT_EVENT_ID%%`
`%%SPLICE_INSERT_UPID%%`
`%%TIME_SIGNAL_EVENT_ID%%`
`%%TIME_SIGNAL_UPID%%`
`%%TIME_SIGNAL_UPID_RAW%%`
`%%AFMM_CBC%%`

Si espande in segnali SCTE-35.

ID streaming

Macro
`%%STREAM_ID%%`

Si espande nell'ID sessione streaming per l'origine di contenuto attualmente in riproduzione.

TFCD

Macro
`%%TFCD%%`

Si espande nel valore del parametro tfcd.

TFUA

Macro
`%%TFUA%%`

Il parametro tfua.

Timestamp

Macro
`[TIMESTAMP]`

Macro VAST 4.0: timestamp corrente nel formato ISO 8601.

ID transazione

Macro
`[TRANSACTIONID]`

Macro VAST 4.1: un identificatore utilizzato per correlare una catena di richieste di annunci dall'origine.

US privacy

Macro
`%%US_PRIVACY%%`

Si espande nel valore del parametro us_privacy.

User agent

Macro
`%%USER_AGENT%%`
`[DEVICEUA]`

User agent del dispositivo che esegue il rendering dell'annuncio all'utente finale.

Nel caso dei reindirizzamenti VAST, solo la macro [DEVICEUA] fornirà la funzionalità prevista.

Indirizzo IP utente

Macro
`%%USER_IP%%`
`[DEVICEIP]`
`[IP_ADDRESS]`

Si espande nell'indirizzo IP dell'utente.

[IP_ADDRESS] deve essere utilizzato solo per i reindirizzamenti di Ad Manager dove non è consentito %%USER_IP%%.

Durata video

Macro
`%%VIDEO_DURATION%%`

Solo VOD.: durata del video in millisecondi, dal feed MRSS.

Durata del video, espressa in secondi

Macro
`%%VIDEO_DURATION_SEC%%`

Si espande nella durata del video espressa in secondi.

ID video

Macro
`%%VIDEO_ID%%`

Solo VOD: ID contenuti CMS proveniente dal feed MRSS.

Titolo video

Macro
`%%VIDEO_TITLE%%`

Solo VOD: titolo video dal feed MRSS.

Macro di monitoraggio VAST

Entrambe le macro [CACHEBUSTING] ed [ERRORCODE] sono conformi alla specifica VAST 4.0 (vedi la sezione "2.3.7 Macro").

Busting della cache

Macro
`[CACHEBUSTING]`

Si espande in un numero casuale di 8 cifre.

Codice di errore

Macro
`[ERRORCODE]`

Si espande nel codice di errore VAST.

Per eventuali problemi relativi alla risoluzione dei problemi o a interruzioni del servizio DAI, contatta l'assistenza per i publisher.

Macro nelle stringhe con codifica URL

Se devi utilizzare una macro in una sezione del tag annuncio che deve avere una codifica URL, la macro stessa non deve essere codificata in URL per garantire il corretto funzionamento della sostituzione della macro.

Esempio

Utilizzo della macro Google in-stream video nonce in un parametro di query che deve essere codificato in URL:

Corretto
http://www.some-adtag.com?encoded_param=[GOOGLE_INSTREAM_VIDEO_NONCE]%3D5

Non corretto
http://www.some-adtag.com?encoded_param=%5BGOOGLE_INSTREAM_VIDEO_NONCE%5D%3D5

Questa pagina potrebbe includere contenuti tradotti usando la tecnologia AI. Le traduzioni con l'AI potrebbero contenere errori.

È stato utile?

Come possiamo migliorare l'articolo?

Macro per l'inserimento di annunci dinamici

Andare a una macro specifica dell'elenco

Macro di richiesta di annuncio

Macro di monitoraggio VAST

Macro nelle stringhe con codifica URL

È stato utile?

Hai bisogno di ulteriore assistenza?

Prova i passaggi successivi indicati di seguito: