Uscite macro di Studio

Obiettivo

Inserire informazioni/macro Studio nell'URL di uscita.

Soluzione

Esistono due modi per aggiungere informazioni di Studio (come un ID annuncio) a un annuncio:

• Utilizza le macro di Studio nell'URL di destinazione dell'interfaccia utente web di Studio.

• Utilizza l'API Studio per trovare informazioni di Studio, creando una stringa di query o un URL completo nel codice creatività, quindi utilizza Enabler.exitQueryString(id, queryString).

Quando utilizzi gli URL di uscita dinamici, potresti essere reindirizzato a un URL diverso dalla pagina di destinazione. Tale reindirizzamento viene controllato dal server della pagina di destinazione, non da Studio.

Configurazione

Prima di aggiungere macro di Studio alle uscite, consulta la tabella riportata di seguito per informazioni sulle macro disponibili e sulle chiamate alla API Studio. Se vuoi aggiungere i parametri Studio a un URL di uscita direttamente nel codice della creatività, verifica che esista un metodo dell'API Studio per farlo. Se non esiste un metodo dell'API Studio, non puoi importare le informazioni di Studio nell'URL di uscita.

Macro supportate da Studio

Macro	Metodo API Studio	Parametro dell'ad server di Studio
%eadv!	Enabler.getParameter("adv");	ID inserzionista
%eaid!	Enabler.getDartAdId();	ID annuncio
%ebuy!	Enabler.getParameter(“buy”);	ID campagna
%ecid!	Enabler.getDartCreativeId();	ID creatività
%epid!	Enabler.getDartPageId();	ID posizionamento
%erid!	Enabler.getDartRenderingId();	ID rendering
%esid!	Enabler.getDartSiteId();	ID sito
%n	Nessuna API disponibile	numero casuale
%p	Nessuna API disponibile	corrispondenza pattern
%s	Enabler.getDartSiteName();	nome del sito

 

Le informazioni di Studio sono disponibili solo quando la creatività viene pubblicata in un tag attivo. Le macro Studio restituiscono valori non completi o pari a 0 quando vengono visualizzate in anteprima in Studio. I metodi equivalenti dell'API Studio restituiscono 0, null o "" durante l'anteprima in Studio o il test in locale.

Se una creatività recupera gli URL di uscita da un'origine esterna (XML, JSON) e questi URL contengono valori di macro Studio, devi sostituire i valori delle macro degli annunci con i metodi corrispondenti dell'API Studio ricorrendo alla logica di sostituzione di stringhe nel codice creatività. Utilizza la tabella sopra per trovare le macro che corrispondono ai vari metodi dell'API Studio. Non impostare come hardcoded i valori della macro Studio nella creatività.

Se i valori delle macro Studio venissero impostati come hardcoded nella creatività, non potrebbero mai essere sostituiti con i corrispondenti parametri dell'ad server Studio nei tag attivi. Inoltre, se i valori delle macro Studio venissero impostati come hardcoded, molto probabilmente l'URL attiverebbe un blocco popup in Internet Explorer quando l'utente fa clic sulla creatività. Gli URL di uscita impostati come hardcoded nella creatività non possono essere sovrascritti nell'interfaccia utente di Studio o in DCM.

Esempi

Utilizza le macro Studio nell'URL di destinazione in Studio

Incolla l'URL pagina di destinazione che contiene i dati della macro Studio nel campo URL di destinazione all'interno della scheda Eventi > Uscite di Studio.

URL di reindirizzamento di terze parti di esempio
In questo esempio, le macro sono evidenziate in rosso.

http://yourdomain.com/clk?aAgencyId=01&aSource=adsrv&aTrackDataExt=
123456;%epid!;%eaid!;%ecid!&migRandom=%n&aTrackFmtExt=client;io;ad;crtv&
aUnencodedDest=http://yourdomain.com

Utilizza i parametri di Studio nel codice della creatività, quindi inserisci l'URL di base in Studio:

1. Invece di utilizzare il metodo Enabler.exit() nel codice, sostituisci l'uscita cui desideri aggiungere parametri con Enabler.exitQueryString(). Con questo metodo puoi impostare un URL di base in Studio cui potrai aggiungere i relativi parametri nel codice della creatività.
2. Aggiungi i metodi dell'API Studio che corrispondono a ciascuno dei parametri Studio nel secondo parametro del metodo exitQueryString. I metodi disponibili sono elencati nell'SDK HTML5 di Studio (cerca la pagina per "getDart" per accedere direttamente all'elenco). Di seguito è riportato un esempio di codice JavaScript per le creatività HTML5:

   
   var adIdVar = Enabler.getDartAdId();
   var siteIdVar = Enabler.getDartSiteId();
   
   function exitHandler() {
     Enabler.exitQueryString("my exit", "adid=" + adIdVar + "&siteid=" + siteIdVar);
   }
   
   exitBtn.addEventListener('click', exitHandler, false);

3. Aggiungi l'URL di base nel campo URL di destinazione nella scheda Eventi > Uscite.

   Ad esempio, utilizzando http://yourdomain.com/ come URL di base, l'URL risultante a cui conduce l'annuncio al clic ha il seguente aspetto quando l'annuncio si trova in un tag attivo:
   
   http://yourdomain.com/?adid=123456789&siteid=12345