Pubblicità delle macro dell’DSP

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.

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 }.
Articoli correlati

In questa pagina