Macro di Campaign Manager 360

Introduzione alle macro

Cosa sono le macro di Campaign Manager 360?

Le macro di Campaign Manager 360 sono comandi brevi che vengono espansi dall'ad server di Campaign Manager 360 nei valori corrispondenti, ad esempio parole chiave, nomi chiave di siti o URL. Alcune macro consentono di registrare le informazioni dei report, mentre altre macro determinano quale annuncio viene pubblicato o dove l'annuncio reindirizza gli utenti dopo un clic. La maggior parte delle macro ha solo pochi caratteri di lunghezza, il che le rende facili da inserire nei tag.

Puoi inserire le macro di Campaign Manager 360 in vari contesti, inclusi URL pagina di destinazione, tag click tracker, URL di reindirizzamento, HTML di una creatività, intestazione di un frame o tag Floodlight. La macro può espandersi durante la pubblicazione dell'annuncio o in seguito ad altri eventi, come una chiamata a Floodlight. Può anche espandersi in modo dinamico (con informazioni specifiche dell'utente). Questo dipende dalla macro utilizzata e da dove è stata inserita.

Non tutte le macro funzionano in ogni contesto. Se inserisci una macro in una origine non supportata, l'ad server di Campaign Manager 360 potrebbe non espanderla correttamente. Utilizza la tabella riportata di seguito per abbinare le macro alle origini corrette. Ad esempio, gli ad server di Campaign Manager 360 espandono la macro %g se la inserisci negli URL pagina di destinazione, ma non la espandono se la inserisci in un tag tracker dei clic.

Informazioni generali

• Le macro di Campaign Manager 360 fanno distinzione tra maiuscole e minuscole. Digitale sempre utilizzando le minuscole. Ad esempio, %c è una macro valida, mentre %C non lo è.

• Puoi utilizzare separatori tra le macro, ma non è necessario. In caso tu voglia usarli, i separatori consigliati sono la virgola (,) e la barra verticale (|). Se non sei un trafficker con esperienza, evita di utilizzare altri separatori, poiché alcuni possono provocare problemi se utilizzati nel contesto sbagliato.

• Per modificare le macro negli URL di monitoraggio del fornitore, utilizza i tag evento. Ecco la procedura di base:

  • Innanzitutto, crea un tag evento in Campaign Manager 360. Quindi, aggiungi al tag evento l'URL di monitoraggio del fornitore, che può essere un URL di monitoraggio dei clic, un pixel di impressione o un URL sondaggio. Puoi facilmente aggiungere o rimuovere le macro dall'URL di monitoraggio nelle proprietà del tag evento in Campaign Manager 360 .

  • Quando il tag evento è pronto, puoi applicarlo ai tuoi annunci. Da questo momento, quando vengono pubblicati, i tuoi annunci utilizzeranno l'URL di monitoraggio nel tag evento. Campaign Manager 360 semplifica l'applicazione del tag evento a più annunci contemporaneamente. Ad esempio, puoi impostare il tag evento in modo che venga applicato automaticamente a tutti gli annunci della campagna. Per iniziare, segui la procedura illustrata nella guida ai tag evento.

• L'unica versione della macro di espansione che funziona nei tag Floodlight è %ers!. Ulteriori informazioni

Tipi di macro

Macro clickstring %c

La macro %c si espande nella stringa di clic di Campaign Manager 360 all'interno dell'URL pagina di destinazione della creatività. Una stringa di clic è la parte di un URL pagina di destinazione che indirizza il browser agli ad server di Campaign Manager 360.

Usa %c_esc invece di %c se devi utilizzare una versione della clickstring con escape in una creatività personalizzata. Le clickstring di Campaign Manager 360 utilizzano e commerciali (&) che potrebbero causare problemi se collabori con server di terze parti.

Tieni presente che la macro %c non si espanderà per includere i tag evento di clic per le creatività display personalizzate. 

Come funzionano le clickstring: quando un utente fa clic su una creatività, il browser punta all'URL pagina di destinazione. La clickstring reindirizza il browser agli ad server di Campaign Manager 360 prima di inviarlo alla pagina di destinazione dell'inserzionista. Campaign Manager 360 aggiunge automaticamente la clickstring all'URL di click-through appena si verifica un'impressione.

Se aggiungi manualmente un URL pagina di destinazione all'HTML di una creatività personalizzata, probabilmente dovrai aggiungere la macro %c per garantire che i clic eseguano il reindirizzamento agli ad server di Campaign Manager 360. Puoi anche aggiungere %u (la macro pagina di destinazione) se vuoi espandere sia la clickstring che l'URL pagina di destinazione: %c%u si espande in un URL pagina di destinazione completo.

Passaggi da implementare. Di seguito viene riportato un esempio di clickstring:

Per aggiungere una clickstring all'URL pagina di destinazione di una creatività personalizzata, posiziona la macro %c all'inizio dell'URL pagina di destinazione nel codice creatività come illustrato nel seguente URL di click-through:

Quando un ad server pubblica una creatività, la macro %c si espande nella clickstring. Ecco un esempio dell'aspetto che potrebbe avere l'URL pagina di destinazione indicato in precedenza dopo l'espansione della macro %c:

Puoi notare che la macro %c si è espansa nella clickstring all'inizio dell'URL pagina di destinazione, formando un URL della creatività completo.

Per inserire l'intero URL della creatività in una sola volta, unisci la macro %c (clickstring) alla macro %u (URL pagina di destinazione): <a href="%c%u">. Le due macro si espandono in un URL della creatività completo.

Ad esempio, se inserisci <a href="%c%u"> nel codice HTML, potrebbe espandersi in:

Quando la macro %u si espande nell'URL pagina di destinazione, verrà espansa automaticamente anche qualsiasi altra macro presente nell'URL pagina di destinazione, inclusa la macro %c.

Macro di espansione %e

La macro %e si espande nel numero ID per diverse proprietà di una creatività. Inserisci una funzione di accesso dopo la macro per determinare in quale numero ID si espande la macro, nonché la proprietà della creatività da monitorare. Consulta l'elenco delle funzioni di accesso riportato di seguito:

Puoi utilizzare le tabelle delle corrispondenze per stabilire questi numeri ID e associarli alle proprietà della creatività: i numeri ID sono collegati alle descrizioni in Campaign Manager 360 e nel database di backend. Questi numeri ID possono aiutarti a tracciare diverse proprietà delle creatività attraverso gli ad server di Campaign Manager 360.

I tag Floodlight supportano solo una versione della macro di espansione: %ers!. Non supportano nessun altro tipo di macro %e. Tieni presente che %ers! funziona ovunque viene supportata la macro di espansione (vedi la tabella in alto).

Se utilizzi annunci di monitoraggio nell'inventario per app per dispositivi mobili con una pagina di destinazione statica, la macro %e non si espanderà correttamente.

Non esiste un limite al numero di macro %e che un URL pagina di destinazione può contenere. Ecco un esempio di URL pagina di destinazione con tre macro %e:

Macro di dati geografici %g

La macro %g fornisce informazioni geografiche correlate a una richiesta di annuncio. Può essere utilizzata per riflettere in modo dinamico la posizione degli utenti nelle creatività standard, personalizzate e rich media. La macro %g si espande con una stringa di coppie chiave-valore relativi a informazioni come l'abbreviazione di paese e stato, la città, il codice postale, la Designated Market Area^® e la larghezza di banda della connessione a internet. Queste informazioni vengono restituite tramite gli ad server di Campaign Manager 360.

Ad esempio, la macro %g potrebbe espandersi come segue per un utente che si trova a New York:

Macro server della creatività %h

La macro %h si espande nel nome host del server che pubblica una creatività. In questo modo non è più necessario inserire il nome host nel tag eseguendone l'hard-coding. Il nome host varia e la macro si espande in modo dinamico per ogni creatività.

Aggiungi la macro %h all'inizio dell'URL nel tag, come nel seguente tag immagine, dove "123456" è il segnaposto per l'ID inserzionista:

Macro impressione %i

La macro %i si espande in una stringa di impressioni, che consente all'ad server di Campaign Manager 360 di monitorare le impressioni per un annuncio interstitial al momento dell'impressione.

Aggiungi la macro %i all'inizio dell'URL nel tag, come riportato nel seguente esempio:

La macro %i deve essere utilizzata in tutti gli annunci interstitial, poiché consente all'ad server di Campaign Manager 360 di monitorare quando un'impressione interstitial viene effettivamente pubblicata.

Macro parola chiave %k

La macro %k si espande in una sottostringa nel tag annuncio (più precisamente, nell'URL di richiesta). Puoi utilizzare questa macro per esaminare le parole chiave inserite dall'utente nelle creatività.

Questa macro è inoltre utile per più acquisti di parole chiave: si espande in qualsiasi parola chiave per la stessa creatività, a seconda di quella inserita dall'utente. Ad esempio, prova a considerare l'utilità della macro %k per un inserzionista che ha acquistato le parole chiave assicurazione auto e finanziamenti auto. Quando un utente effettua una ricerca per assicurazione auto, nella creatività con quella macro verrà visualizzato Fai clic qui per l'assicurazione auto. Quando un utente cerca finanziamenti auto, nella stessa creatività verrà visualizzato Fai clic qui per finanziamenti auto.

Utilizza una coppia chiave-valore per stabilire in quale sottostringa si espande la macro. Una coppia chiave-valore è composta da una chiave (start_key_string) e da un valore corrispondente (end_character).

Inserisci la macro e la coppia chiave-valore nel seguente ordine: macro, primo valore, punto esclamativo (!) e, infine, secondo valore. Il formato ha il seguente aspetto:

La macro %k acquisisce una sottostringa indicata da questi parametri. Individua la parola chiave specificata ed espande la macro. Puoi inserire la coppia chiave-valore in un tag ad o jump di Campaign Manager 360.

La macro %k può inoltre essere utilizzata per eliminare la sequenza di escape che precede i caratteri. Quando la macro trasmette una sottostringa all'HTML di una creatività, tutti i caratteri preceduti da una sequenza di escape nella stringa acquisita vengono convertiti automaticamente nei set di caratteri originali. Ad esempio:

Affinché nella creatività venga visualizzato car insurance, devi decodificare il carattere di escape +. Così l'inserzionista incorpora %k nel codice della creatività L'ad server acquisisce la sottostringa kw=car+insurance, decodifica il carattere + e la presenta come car insurance all'interno della creatività.

Ora il codice ha un aspetto simile al seguente:

Nota relativa alle macro %k e %p: le due macro sono simili in quanto entrambe acquisiscono una sottostringa indicata da start_key_string, ma si differenziano nel metodo utilizzato per trasmetterla. Mentre la macro %k trasmette la sottostringa all'HTML di una creatività, la macro %p la trasmette all'URL. A differenza della macro %p, la macro %k funziona solo all'interno di un codice HTML della creatività.

Macro codice di corrispondenza %m

La macro %m si espande nel valore del cookie DoubleClick di un utente se le impostazioni del browser rendono i cookie disponibili quando l'utente fa clic sulla creatività. Questa macro può essere utilizzata per generare un elenco di ID utente e quindi effettuare un retargeting degli utenti che hanno reagito alla creatività in precedenza. L'ID utente è criptato con la chiave della crittografia ID inserzionista. Ulteriori informazioni sulla crittografia ID utente nel tuo account Campaign Manager 360.

Puoi inserire la macro nell'URL pagina di destinazione, nell'URL di reindirizzamento, nel codice creatività o in un click tracker hardcoded come ad.doubleclick.net/clk. Il valore del cookie DoubleClick è un numero intero a 64 bit composto da massimo 20 caratteri.

Gli ad server espandono la macro %m nella stringa di clic a seguito di un evento clic e non in una creatività.

• Se un utente ha disabilitato i cookie nel browser o se ha eseguito la procedura di disattivazione per i cookie, l'ad server espande %m in 0.
• Nel codice creatività, la macro %m non ha effetto per i browser che si trovano dietro a un proxy. Anche in questo caso l'ad server espande %m in 0.

Macro numero casuale %n

La macro %n si espande in un numero casuale. I numeri casuali impediscono ai browser di memorizzare nella cache un URL. Quando l'annuncio viene pubblicato, gli ad server generano dinamicamente un numero casuale e lo aggiungono all'URL al posto di %n. Poiché l'URL contiene un numero casuale diverso ogni volta che l'annuncio viene pubblicato, il browser non può caricare una versione dell'annuncio memorizzata nella cache. Quando impedisci la memorizzazione nella cache, eviti che i server di terze parti eseguano un conteggio incompleto delle impressioni.

La macro %n viene usata spesso sul lato del publisher quando Campaign Manager 360 deve eseguire un reindirizzamento a terze parti per pubblicare una creatività. Di solito i fornitori di terze parti utilizzano una propria sintassi per il numero casuale, simile a ord=[random_number]? di Campaign Manager 360.

La macro %n consente inoltre alle terze parti di monitorare i clic. Poiché ogni clic dell'utente espande un numero casuale univoco al posto della macro %n, le terze parti possono tracciare i clic separatamente. I trafficker devono verificare che le terze parti supportino la stringa di caratteri aggiuntiva in cui si espande la macro.

Macro corrispondenza di schema %p

La macro %p si espande in una sottostringa presente nell'URL della richiesta dei tuoi tag annuncio: quando l'annuncio viene pubblicato, la macro si espande in qualsiasi elemento compreso tra la stringa di inizio specificata e il carattere finale.

Come designare la sottostringa. Utilizza un valore-chiave per definire l'inizio e la fine del tipo di sottostringa che vuoi venga cercata dal server. Una coppia chiave-valore è composta da due coppie chiave-valore, un valore start_key_string e un valore end_character.

• [start_key_string]. è la parte relativa alla chiave di una coppia chiave-valore che deve essere inclusa nei tag annuncio. È sensibile alle maiuscole e non include le parentesi segnaposto.

• [end_character]. Il carattere utilizzato per indicare la fine di un valore-chiave. Se il carattere finale non è indicato e la stringa di inizio è l'ultimo valore-chiave del tag, l'ad server copia l'intera stringa. Puoi inserire ogni valore come qualsiasi stringa di valori ASCII. Il valore deve contenere almeno due caratteri e non includere le parentesi segnaposto.

Ecco il formato di base:

Generalmente, la macro %p viene utilizzata per espandersi in una parola chiave che aiuta a tenere traccia delle informazioni sui rapporti. Ad esempio, se vuoi inserire il nome di un modello di auto, devi inserire una macro %p nel tag annuncio, assieme alla stringa iniziale (model=) e il carattere finale scelto (in questo caso, un punto e virgola). Anche in questo caso, tieni presente che le parentesi segnaposto non sono incluse:

Quando l'annuncio viene pubblicato, Campaign Manager 360 cerca model= nei tag annuncio e acquisisce tutto ciò che è compreso tra model= e il carattere finale (;). 

Alcuni utilizzi comuni della macro %p includono i seguenti:

• Gli inserzionisti possono trasmettere valori o variabili dai tag Floodlight ai tag publisher.

• I publisher possono trasmettere i valori in modo dinamico negli URL pagina di destinazione.

Macro nome chiave del sito %s

La macro %s si espande in maniera diversa a seconda che venga aggiunta a tag annuncio o a tag Floodlight.

• I tag annuncio si espandono nel nome chiave del sito di Campaign Manager 360. Se un utente fa clic su un annuncio pubblicato da Campaign Manager 360, questa macro si espande nel nome chiave del sito in cui è stato pubblicato tale annuncio. Questo nome chiave deve corrispondere a quello riportato nella scheda Proprietà del sito in Campaign Manager 360 (Amministratore > Siti).

  Ad esempio, prendi in considerazione questo URL che include una macro %s alla fine:

  http://www.advertiser.com/cgi.bin/?%s

  Se l'URL è incluso in un annuncio pubblicato nell'ambito di un sito il cui nome chiave è N255.010101.sandwiches, la macro si espande in N255.010101.sandwiches quando l'utente fa clic sull'annuncio:

  http://www.advertiser.com/cgi.bin/?N255.010101.sandwiches

  Se le informazioni relative al sito non sono disponibili in tempo reale, %s può espandersi in una stringa vuota.

• I tag Floodlight si espandono nell'ID di un sito di Campaign Manager 360: quando un tag Floodlight viene attivato in un sito, la macro %s si espande all'interno dell'ID del sito stesso. Questo è l'ID utilizzato da Campaign Manager 360 per identificare il sito.

Macro URL pagina di destinazione %u

La macro %u si espande nell'URL pagina di destinazione della creatività. Ad esempio, <a href="%u"> potrebbe espandersi nel seguente URL pagina di destinazione:

Per inserire l'intero URL della creatività in una sola volta, combina la macro %u con la macro %c. Le due macro si espandono in tutto l'URL: %c (clickstring) + %u (URL pagina di destinazione) = URL completo della creatività.

Ad esempio, se inserisci <a href="%c%u"> nel codice HTML, potrebbe espandersi in:

http://ad.doubleclick.net/click;361119;0-8388608;2;321977;1-468|60;0|0|0;;?http%3A%2F%2Fwww.doubleclick.com%2Fpath%2Fpage.html