Tracciare collegamenti personalizzati tracking-personalized-links

I collegamenti nel contenuto delle e-mail che contengono la personalizzazione devono essere tracciati con una sintassi specifica.

L’utilizzo di JavaScript nel contenuto delle e-mail (HTML o Testo) consente di generare e inviare contenuto dinamico ai destinatari, con due limitazioni:

  • Lo script non può accedere direttamente al database (funzioni SQL e API non disponibili),
  • Adobe Campaign deve essere in grado di rilevare gli URL in modo da poter tenere traccia dei collegamenti.

Istruzioni di pre-elaborazione pre-processing-instructions

Puoi aggiungere istruzioni di pre-elaborazione specifiche per scrivere lo script dell’URL e tracciarlo. Queste istruzioni devono essere scritte in JavaScript e iniziare con <%@.

Ad esempio:

<%@ value object="myObject" xpath="@myField" %>

Questa istruzione recupera il valore del campo myField dall'oggetto myObject.

Rilevamento URL url-detection

Per il rilevamento del tracciamento, Adobe Campaign incorpora Tidy per analizzare l'origine HTML e rilevare il modello. Elenca tutti gli URL del contenuto in modo che possano essere tracciati singolarmente. Adobe Campaign utilizza nuovamente Tidy per sostituire l'URL (http://myurl.com) con un URL che punta al server di reindirizzamento di Adobe Campaign.

Ad esempio, nel contenuto iniziale: http://myurl.com/a.php?name=<%=escapeUrl(recipient.lastName)%> è sostituito per un destinatario particolare con: http://emailing.customer.com/r/?id=h617791,71ffa3,71ffa8&p1=CustomerName

Dove:

  • "h" significa contenuto HTML (o "t" per contenuto di testo).
  • 617791 è l’ID del messaggio/broadLog ID (esadecimale).
  • 71ffa3 è l’ID NmsDelivery (esadecimale).
  • 71ffa8 è l’ID NmsTrackingUrl (esadecimale).
  • p1, p2 e così via sono tutti i parametri da sostituire nell'URL.

Esempio di non rilevamento non-detection-example

<%= getURL("http://mynewsletter.com") %> funziona e invia il contenuto effettivo della pagina Web tramite e-mail ai destinatari. Ma nessuno dei collegamenti viene tracciato. Il motivo è che l'MTA esegue "<%=getURL(..." per ogni e-mail prima dell'invio. Può essere diverso per ogni destinatario, pertanto Adobe Campaign non può conoscere gli URL per il tracciamento e assegnare loro un ID tag.

Quando la pagina da scaricare è la stessa per tutti i destinatari, la best practice è quella di utilizzare:

<%@ include url="http://mynewsletter.com" %>

In tal caso, la pagina viene scaricata durante l’analisi, prima del rilevamento del tracciamento. Consente ad Adobe Campaign di scoprire i collegamenti, assegnare un ID tag e tracciarli.

Dopo aver elaborato le istruzioni <%@, l'URL da tracciare deve avere la seguente sintassi:

<a href="http://myurl.com/a.php?param1=aaa&param2=<%=escapeUrl(recipient.xxx)%>&param3=<%=escapeUrl(recipient.xxx)%>">
IMPORTANT
Tutti gli altri modelli non sono supportati da Adobe e devono essere evitati per evitare potenziali lacune di sicurezza.

Parametri URL url-parameters

Per garantire che gli URL personalizzati vengano tracciati correttamente, è necessario utilizzare la funzione escapeUrl() o il metodo di codifica appropriato per i parametri degli URL.

Esempio:

<a href="http://myurl.com/a.php?name=<%=escapeUrl(recipient.lastName)%>">Click here</a>

In questo modo, il parametro personalizzato verrà codificato e tracciato correttamente da Adobe Campaign.

Ciclo con <%@ foreach %> foreach

L'istruzione <%@ foreach %> consente di eseguire iterazioni su array di oggetti caricati nella consegna per tenere traccia dei singoli collegamenti correlati agli oggetti.

Sintassi

<%@ foreach object="myObject" xpath="myLink" index="3" item="myItem" %>
  <!-- Content to repeat -->
<%@ end %>

Parametri:

  • object: nome dell'oggetto da cui iniziare (in genere un oggetto script aggiuntivo, ma può essere una consegna)
  • xpath (facoltativo): XPath della raccolta su cui eseguire il ciclo. Il valore predefinito è ".", ovvero l'oggetto corrisponde all'array su cui eseguire il ciclo
  • index (facoltativo): se xpath non è "." e l’oggetto è un array stesso, indice dell’oggetto (inizia da 0)
  • item (facoltativo): nome di un nuovo oggetto accessibile con <%@ value %> all'interno del ciclo foreach. Predefinito è il nome del collegamento nello schema

Esempio

Nelle proprietà/personalizzazione della consegna, carica un array di articoli e una tabella di relazione tra destinatario e articoli.

Puoi visualizzare i collegamenti a questi articoli con il tracciamento individuale:

<%@ foreach object="articleList" item="article" %>
  <a href="http://example.com/article.jsp?id=<%@ value object="article" xpath="@id" %>">
    <%@ value object="article" xpath="@title" %>
  </a>
<%@ end %>

Questo consente ad Adobe Campaign di tenere traccia dell’articolo specifico su cui ciascun destinatario ha fatto clic, anziché tenere semplicemente traccia del clic su un collegamento di articolo.

Best practice best-practices

  • Utilizza sempre la funzione escapeUrl() per i parametri URL dinamici
  • Usa <%@ foreach %> quando devi tenere traccia di singoli elementi nelle raccolte
  • Verifica il tracciamento prima di inviare la consegna per garantire il corretto funzionamento di tutti i collegamenti
  • Verifica che i collegamenti personalizzati siano formattati correttamente nel contenuto della consegna
  • Controlla i registri di tracciamento per verificare che i parametri personalizzati vengano acquisiti correttamente
recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b