Macro di Advertising DSP

Ultimo aggiornamento: 11 febbraio 2025

Creato per:

  • Utente

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.

MacroDescrizione sostituzioneTipo
${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_KEYChiave del sito per il posizionamento. Obbligatorio per AppsFlyer tracker di clic per annunci di installazione 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

MacroDescrizione sostituzioneTipo
${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 è tra quelle sopra indicate
varchar(50)
${CS_DEVICE_MODEL}(ComScore) 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 è tra quelle sopra indicate
stringa
${NS_DEVICE_GROUPING}

(Nielsen) Tipo di dispositivo su cui l'annuncio era visualizzatore:

  • TAB = tablet
  • PHN = dispositivo mobile
  • computer = computer
stringa
${UOO}

(Nielsen) Indica 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}ID del bundle dell'app store iOS o Android. Esempi: com.zynga.wwf2.free o id804379658stringa
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 = RGPD deve essere applicato
  • 0 = 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