Pubblicità delle macro dell’DSP

Last update: Fri May 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
DSP Ads

Creato per:

User

Una macro è un comando breve o una scorciatoia per un'istruzione e in genere segue il formato ${MACRO_NAME}. Le macro incluse nel codice creativo o negli URL di click-through si espandono in una stringa di codice più lunga che il server dell’annuncio può comprendere. Il server di annunci DSP esegue le macro quando l’annuncio viene distribuito o su cui si fa clic.

Le macro del server di annunci sono utili per trasmettere informazioni importanti all’DSP o a server di annunci di terze parti. Le macro sono più comunemente utilizzate durante il traffico di codice creativo o metadati di terze parti e personalizzati (come i pixel di terze parti).

È possibile inserire manualmente una macro in qualsiasi punto, ad esempio in un tag VAST, in qualsiasi URL oppure in un DSP o in un pixel evento di terze parti. Tuttavia, ogni client e partner DSP ha un formato di tag annuncio diverso e le macro devono essere inserite in punti diversi del tag di conseguenza. Ogni volta che si lavora con un nuovo cliente o partner, chiedere loro la documentazione su dove inserire le macro nei loro tag pubblicitari che vengono trafficate da DSP.

Macro di tracciamento generali

Utilizza le macro di tracciamento generali per tutti i tipi di annunci e tag per restituire dati specifici, in base alle esigenze.

Macro

Descrizione sostituzione

Tipo

${TM_ACCOUNT_ID}

L’ID account.

numero intero

${TM_AD_ID}

Chiave annuncio (adKey).

stringa

${TM_AD_ID_NUM}

L’ID dell’annuncio.

numero intero

${TM_ADVERTISER_ID}

ID inserzionista.

numero intero

${TM_CAMPAIGN_ID}

Chiave della campagna.

stringa

${TM_CAMPAIGN_ID_NUM}

ID della campagna.

numero intero

${TM_CLICK_URL}

L’URL di reindirizzamento, che consente ai server di annunci di tenere traccia e contare i clic degli annunci. Quando l’annuncio viene distribuito, se l’utente fa clic su di esso, la macro viene attivata e il clic viene registrato e conteggiato a scopo di reporting.

stringa

${TM_CLICK_URL_URLENC}

L’URL di reindirizzamento codificato, che consente ai server di annunci di tenere traccia e contare i clic degli annunci. Quando l’annuncio viene distribuito, se l’utente fa clic su di esso, la macro viene attivata e il clic viene registrato e conteggiato a scopo di reporting. Non utilizzare questa macro a meno che non si creino annunci di terze parti e il fornitore non richieda la codifica URL.

stringa

${TM_FEED_ID}

Chiave per il posizionamento dei contenuti multimediali (feedKey).

stringa

${TM_FEED_ID_NUM}

ID del posizionamento multimediale.

numero intero

${TM_MACRO_PLACEMENT_SITE_KEY

Chiave del sito per il posizionamento. Obbligatorio per AppsFlyer fai clic su tracker per gli annunci per l’installazione di app mobili.

stringa

${TM_PLACEMENT_ID}

La chiave di posizionamento (cpKey).

stringa

${TM_PLACEMENT_ID_NUM}

ID del posizionamento.

numero intero

${TM_RANDOM}

Cachebuster: un numero casuale compreso tra 1 e 1000000.

long

${TM_SESSION_ID}

L’ID della sessione, che corrisponde a un singolo recupero del tag dell’annuncio.

stringa

${TM_SITE_DOMAIN_URLENC}

Il sottodominio della pagina analizzato dall’URL nella richiesta di offerta; codificato in URL. Non supportato per annunci in banner e click-to-play.

stringa

${TM_SITE_NAME}

Il nome del sito per il posizionamento.

stringa

${TM_SITE_URL_URLENC}

URL passato nella richiesta di offerta; codifica URL. Non supportato per annunci in banner e click-to-play.

stringa

${TM_SITE_ID_NUM}

ID del sito per il posizionamento.

numero intero

${TM_TIMESTAMP}

La marca temporale Unix che indica il numero di secondi trascorsi dalla mezzanotte (00:00 UTC) del 1° gennaio 1970.

long

${TM_VIDEO_DURATION}

La durata del video dell’annuncio in secondi.

numero intero

Macro specifiche per dispositivi mobili

Macro

Descrizione sostituzione

Tipo

${CS_PLATFORM_ID}

(ComScore) L'ID piattaforma, che corrisponde al sistema operativo del dispositivo:

ios = Apple iOS
android = Google Android
windows = Windows Mobile
blackberry = Blackberry
other quando la piattaforma non è nessuna delle precedenti

varchar(50)

${CS_DEVICE_MODEL}

(ComScorea) Il nome del modello del dispositivo, con codifica URL.

stringa

${CS_IMPLEMENTATION_TYPE}

(ComScore) Ambiente in cui è stato distribuito l’annuncio:

a = app mobile
b = sito Web mobile

stringa (a o b)

${NS_PLATFORM_ID}

(Nielsen) L'ID piattaforma, che corrisponde al sistema operativo del dispositivo:

ios= Apple iOS
android = Google Android
windows = Windows Mobile
blackberry = Blackberry
other quando la piattaforma non è nessuna delle precedenti

stringa

${NS_DEVICE_GROUPING}

(Nielsen) Il tipo di dispositivo su cui l’annuncio era visualizzatore:

TAB = tablet
PHN = mobile
computer = computer

stringa

${UOO}

(Nielsen) Se l’utente ha rinunciato o meno al tracciamento degli annunci:

1 (Flag DNT = 1) = l’utente ha rinunciato al tracciamento degli annunci
0 (Flag DNT = 0) = l’utente ha acconsentito al tracciamento degli annunci

numero intero (0 o 1)

${TM_BUNDLE}

Il iOS o Android ID del bundle dell’app store. Esempi: com.zynga.wwf2.free o id804379658

stringa

gdpr=${GDPR_ENFORCED}&gdpr_consent=${GDPR_CONSENT}

gdpr=${GDPR_ENFORCED} indica se l’offerente determina che la richiesta di offerta proviene dall’Unione Europea e richiede l’applicazione del RGPD:

1 = il RGPD deve essere applicato
0 = il RGPD non deve essere applicato

gdpr_consent=${GDPR_CONSENT} è il valore di consenso passato dal partner di fornitura nella richiesta di offerta in entrata:

Nella maggior parte dei casi, si tratta di una stringa di consenso con codifica base64url, o daisybit (ad esempio: BN5lERiOMYEdiAKAWXEND1HoSBE6CAFAApAMgBkIDIgM0AgOJxAnQA)
0 = nessun consenso
1 = consenso

daisybit o numero intero

Fare clic su Macro per gli annunci visualizzati di terze parti

Per tenere traccia con precisione dei clic per gli annunci che utilizzano tag di visualizzazione di terze parti, l’DSP richiede una macro di clic di visualizzazione. È necessaria una sola versione della macro; la macro pertinente dipende dal tipo di tag.

Macro

Descrizione sostituzione

Tipo

${TM_CLICK_URL}

L’URL di reindirizzamento che consente ai server di annunci di tenere traccia e contare i clic degli annunci nella piattaforma.

stringa

${TM_CLICK_URL_URLENC}

L’URL di reindirizzamento che abilita i server di annunci che richiedono la codifica URL per tenere traccia e contare i clic degli annunci nella piattaforma.

stringa

DSP inserisce automaticamente le macro di clic di visualizzazione in un tag di visualizzazione di terze parti quando:

Esportare i tag annuncio da un partner di ad server
Caricamento in blocco Flashtalking o Google DoubleClick for Advertisers tag pubblicitari direttamente nell’DSP

DSP Se durante la creazione di un annuncio pubblicitario non viene visualizzata una macro di clic, viene visualizzato un messaggio di avviso che richiede di inserire manualmente la macro di clic di visualizzazione appropriata nell'area corretta del tag.

Analytics for Advertising Macro

Per ulteriori macro disponibili in modo specifico per Analytics for Advertising clienti, consulta "Aggiungi Analytics for Advertising Macro per Flashtalking Tag annuncio" e "Aggiungi Analytics for Advertising Macro per Google Campaign Manager 360 Tag annuncio."

Risoluzione dei problemi relativi agli errori delle macro

Quando si aggiungono macro al codice, assicurarsi di utilizzare la sintassi esatta della macro. Durante la convalida delle macro, DSP verifica che la macro corrisponda esattamente a una delle macro valide.

Se all'inizio o alla fine del nome della macro mancano dei caratteri, vengono generati errori. Ad esempio, viene visualizzato un messaggio di errore se:

Si dimenticano uno o più caratteri all'inizio del nome della macro, ad esempio ${. Se non si include la sintassi completa, la voce non verrà riconosciuta come macro valida.
La macro non termina con un set di caratteri valido, ad esempio }.

recommendation-more-help

9ff4800f-94be-45f0-a5bf-09d0d7e96baa