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.
Schema consigliato recommended-pattern
Dopo aver elaborato le istruzioni <%@, l'URL da tracciare deve avere la seguente sintassi:
<a href="http://myurl.com/a.php?param1=aaa¶m2=<%=escapeUrl(recipient.xxx)%>¶m3=<%=escapeUrl(recipient.xxx)%>">
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 cicloindex(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