Introduzione al tracciamento dei messaggi get-started-tracking
Funzioni di tracciamento
Configurazione di tracciamento configure-tracking
Per le distribuzioni ibride/on-premise di Campaign Classic v7, è necessario configurare il tracciamento a livello di istanza prima di utilizzarlo.
Principio di funzionamento
Prima di utilizzare il tracciamento, devi configurarlo per la tua istanza. La configurazione deve essere eseguita sui server applicazioni Adobe Campaign e sui server web.
In Campaign sono disponibili due tipi di tracciamento:
- Tracciamento web: questa modalità ti consente di tenere traccia delle visite alle pagine del tuo sito web
- Tracciamento messaggi: questa modalità consente di tenere traccia delle consegne dei messaggi e del comportamento dei destinatari
La modalità di tracciamento viene selezionata durante l’installazione. Per le installazioni on-premise, la configurazione del tracciamento deve essere definita a livello di istanza. Ulteriori informazioni
Server di monitoraggio
Per configurare il tracciamento, l’istanza deve essere dichiarata e registrata con i server di tracciamento. Il server di tracciamento viene utilizzato per registrare e recuperare informazioni sugli URL su cui i destinatari hanno fatto clic.
Per le installazioni on-premise, il server di tracciamento è in genere un server web che esegue l’applicazione web Adobe Campaign. L’URL del server di tracciamento deve essere definito nella configurazione dell’istanza. Ulteriori informazioni
Salvataggio del tracciamento
Una volta configurato il tracciamento e popolati gli URL, è necessario registrare il server di tracciamento. La registrazione consente ad Adobe Campaign di salvare le informazioni di tracciamento e di fornire rapporti e statistiche sulle attività tracciate.
Per le installazioni on-premise, le informazioni di tracciamento vengono memorizzate nel database e recuperate tramite flussi di lavoro tecnici. Il flusso di lavoro tecnico Tracking elabora e memorizza i dati di tracciamento raccolti dal server di reindirizzamento. Ulteriori informazioni
Tracciamento delle applicazioni web web-application-tracking
Tracking di un’applicazione web
È inoltre possibile monitorare e misurare le visite sulle pagine delle applicazioni web con i tag di tracciamento. Questa funzionalità può essere utilizzata per tutti i tipi di applicazioni Web, ad esempio moduli e pagine di destinazione. Ulteriori informazioni
Rinuncia al tracking delle applicazioni web
La rinuncia al tracciamento delle applicazioni web consente di interrompere il tracciamento dei comportamenti web degli utenti finali che rinunciano al tracciamento comportamentale. Puoi includere la possibilità di visualizzare un banner nelle applicazioni web o nelle pagine di destinazione per consentire agli utenti di rinunciare. Ulteriori informazioni
Risoluzione dei problemi di tracciamento tracking-troubleshooting
I seguenti suggerimenti per la risoluzione dei problemi si applicano alle distribuzioni ibride/on-premise di Campaign Classic v7. Alcune informazioni possono essere applicate anche alle distribuzioni on-premise di Campaign v8. Per Campaign v8 Managed Cloud Services, contatta il rappresentante Adobe per assistenza.
Per i passaggi di base per la risoluzione dei problemi di tracking in Campaign v8, consulta Risoluzione dei problemi di tracking nella documentazione di Campaign v8.
Controlli di base basic-checks
Verificare che il processo trackinglogd sia in esecuzione
Questo processo legge dalla memoria condivisa IIS/server Web e scrive i registri di reindirizzamento.
Puoi accedervi dalla homepage selezionando la scheda Monitoraggio nella tua istanza. È inoltre possibile eseguire il comando seguente sull'istanza: <user>@<instance>:~$ nlserver pdump
Se il processo trackinglogd non viene visualizzato nell'elenco, avviarlo con il comando seguente nell'istanza: <user>@<instance>:~$ nlserver start trackinglogd
Verificare che il flusso di lavoro tecnico di tracciamento sia stato eseguito di recente
Puoi individuare il flusso di lavoro tecnico Tracciamento nelle cartelle Amministrazione > Produzione > Flussi di lavoro tecnici.
Risoluzione avanzata dei problemi advanced-troubleshooting
| note note |
|---|
| NOTE |
| Disponibile solo per Windows |
Il file di registro di tracciamento danneggiato …/nl6/var/<nome_istanza>/redir/log/0x0000 log può arrestare il flusso di lavoro di tracciamento. Per rilevare facilmente le righe danneggiate e rimuoverle per riprendere il flusso di lavoro di tracciamento, puoi utilizzare i comandi seguenti.
So in quale file si trova la riga danneggiata
In questo caso, le righe danneggiate si trovano nel file 0x00000000000A0000.log, ma lo stesso processo può essere applicato a un set di file - uno per uno.
| code language-none |
|---|
|
Puoi quindi interrompere il flusso di lavoro di tracciamento, eliminare le righe danneggiate e riavviare il flusso di lavoro.
Non so in quale file si trovi la riga danneggiata
-
utilizzare la riga di comando seguente per archiviare tutti i file di tracciamento.
code language-none $ cd {install directory}/var/{instance name}/redir/log $ cat *.log | sed -nE '/^[[:alnum:]]{2}x[[:alnum:]]*\t[0-9T:\.-]*\t[0-9a-fA-F]*\t[0-9a-fA-F]*\t[0-9a-fA-F]*\t[[:alnum:]]*\t[[:alnum:]-]*\t[[:print:]]*\t[[:print:]]*\t[[:print:]]*\t([0-9a-fA-F\.:]*|[0-9a-fA-F\.:]*\t[[:print:]]*|[0-9a-fA-F\.:]*,[[:print:]]*)$/!p' -
Il comando elenca tutte le righe danneggiate. Ad esempio:
code language-none 50x000000000FD7EC86 2017-06-24T21:00:50.96 1f506d71 1aeab4b6 1af77020 0 e5155671-4ab7-4ce4-a763-3b82dda6d881 h Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.95 Safari/537.36 52.46.20.64note note NOTE Il ritorno a capo è stato aggiunto prima dell’agente utente per consentire una migliore lettura e non riflette l’efficacia del rendering. -
Esegui un comando grep per trovare il file corrispondente.
code language-none $ grep -Rn <Log Id> # for example: $ grep -Rn 50x000000000FD7EC86 -
Individuare il registro con il nome del file e il numero di riga. Ad esempio:
code language-none ./0x000000000FD7E000.log:3207:50x000000000FD7EC86 2017-06-24T21:00:50.96 1f506d71 1aeab4b6 1af77020 0 e5155671-4ab7-4ce4-a763-3b82dda6d881 h Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.95 Safari/537.36 52.46.20.64note note NOTE È stato aggiunto un ritorno a capo prima dell’agente utente per consentire una migliore lettura e non riflette l’efficacia del rendering.
Puoi quindi interrompere il flusso di lavoro di tracciamento, eliminare le righe danneggiate e riavviare il flusso di lavoro.
Quando tenti di accedere ai collegamenti di tracciamento, viene visualizzato il seguente messaggio:
Requested URL '/r/ id=h787bc0,281a4d8,281a4da&p1=1' cannot be found
-
Accedi all’URL di <redirection_server>/r/test e verifica se il numero di build e localhost sono stati restituiti dalla richiesta.
-
Verificare la configurazione spareServer nel file serverConf.xml per il server di tracciamento. Questa configurazione deve essere in modalità di reindirizzamento.
code language-none <redirection> <spareServer _operation="update" enabledIf="$(hostname)!='test-rt1'" id="1" url="http://test-rt1:8080"/> <spareServer _operation="insert" enabledIf="$(hostname)!='test-rt4'" id="4" url="http://test-rt4:8080"/> <spareServer _operation="insert" enabledIf="$(hostname)!='test-rt3'" id="3" url="http://test-rt3:8080"/> <spareServer _operation="insert" enabledIf="$(hostname)!=test-rt2'" id="2" url="http://test-rt2:8080"/> </redirection> -
Verifica manualmente se il file <deliveryID>.xml esiste nel computer nella directory …/nl6/var/<nome_istanza>/redir/url/<AAAA> (AAAA rappresenta l’anno di consegna).
-
Verifica manualmente se <trackingUrlId> è disponibile nel file <deliveryID>.xml.
-
Verifica manualmente l’esistenza di broadlogID nella consegna deliveryID correlata.
-
Controlla le autorizzazioni dei file <deliveryID>.xml nella directory …/nl6/var/<nome_istanza>/redir/url/year.
Devono disporre di almeno 644 autorizzazioni in modo che Apache possa leggere gli URL di tracciamento per reindirizzare il collegamento richiesto.
Per aggiornare l'opzione NmsTracking_Pointer, effettuare le seguenti operazioni:
-
Interrompi il flusso di lavoro di tracciamento.
-
Arresta il servizio trackinglogd.
-
Aggiornare l'opzione NmsTracking_Pointer al valore desiderato.
-
Riavviare il servizio trackinglogd.
-
Riavvia il flusso di lavoro di tracciamento.
Puoi personalizzare la formula di tracciamento dei clic e specificare una formula di tracciamento Adobe Analytics personalizzata.
Questo tipo di personalizzazione deve essere fatto con cautela per evitare di aggiungere caratteri di avanzamento riga aggiuntivi. Tutti i caratteri di avanzamento riga presenti al di fuori dell’espressione JavaScript saranno presenti nella formula finale.
Questo tipo di carattere di avanzamento riga aggiuntivo nell’URL di tracciamento causerà un problema in alcuni webMail (AOL, GMail, ecc.).
Primo esempio:
-
Sintassi errata
code language-none <%@ include option='NmsTracking_ClickFormula' %><% // Parameters expected by Adobe Analytics var pattern = new RegExp("(nl611\.test15|google\.com)", 'i') if( $(urlstring).match(pattern) && delivery.FCP == false ) { %> &cid=<%= message.delivery.internalName %>&bid=<%= message.id.toString().toLowerCase() %><% } %> -
Sintassi corretta
code language-none <%@ include option='NmsTracking_ClickFormula' %><% // Parameters expected by Adobe Analytics var pattern = new RegExp("(nl611\.test15|google\.com)", 'i') if( $(urlstring).match(pattern) && delivery.FCP == false ) { %>&cid=<%= message.delivery.internalName %>&bid=<%= message.id.toString().toLowerCase() %><% } %>
Per capire dove si trova l’avanzamento di riga aggiuntivo, puoi sostituire l’espressione JavaScript con una stringa fissa STRING.
| code language-none |
|---|
|
Secondo esempio
-
Sintassi errata
code language-none <%@ include option='NmsTracking_ClickFormula' %> <% // Parameters expected by Adobe Analytics var pattern = new RegExp("(vistaprint|entryUrl)", 'i') if( $(urlstring).match(pattern) && delivery.FCP == false ) {%>&cid=<%= message.delivery.internalName%>&bid=<%= message.id.toString().toLowerCase()%>&SHPID=<%= message.recipient.factShopper.shopper_id %><% } %> -
Sintassi corretta
code language-none <%@ include option='NmsTracking_ClickFormula' %><% // Parameters expected by Adobe Analytics var pattern = new RegExp("(vistaprint|entryUrl)", 'i') if( $(urlstring).match(pattern) && delivery.FCP == false ) {%>&cid=<%= message.delivery.internalName%>&bid=<%= message.id.toString().toLowerCase()%>&SHPID=<%= message.recipient.factShopper.shopper_id %><% } %>
Per capire dove si trova l’avanzamento di riga aggiuntivo, puoi sostituire l’espressione JavaScript con una stringa fissa STRING.
| code language-none |
|---|
|
Quando l’istanza non recupera i registri di tracciamento direttamente ma da un server Adobe Campaign Classic lontano, i registri vengono recuperati tramite la chiamata SOAP GetTrackingLogs definita nello schema remoteTracking.
Un'opzione nel file serverConf.xml consente di impostare il numero di registri recuperati contemporaneamente tramite questo metodo: logCountPerRequest.
Il valore predefinito di logCountPerRequest è 1000 e in alcuni casi potrebbe essere troppo piccolo. I valori accettati devono essere compresi tra 0 e 10.000.
In Adobe Campaign Classic, una mappatura di destinazione dovrebbe essere univoca in termini di schema del destinatario rispetto agli schemi broadlog/trackinglog.
Non è possibile utilizzare più schemi di targeting con lo stesso schema di registro di tracciamento, poiché il flusso di lavoro di tracciamento non sarà in grado di riconciliare i dati con l’ID di targeting.
Se non desideri utilizzare la mappatura di destinazione predefinita con nms:recipient, ti consigliamo i seguenti approcci:
-
Se si desidera utilizzare una dimensione di targeting personalizzata, è necessario creare lo schema broadLog/trackingLog personalizzato utilizzando come modello nms:broadlog (ad esempio nms:broadLogRcp, nms:broadLogSvc e così via).
-
Se si desidera utilizzare OOB trackingLogRcp/broadLogRcp, la dimensione di targeting deve essere nms:recipient e la dimensione di filtro potrebbe essere uno schema personalizzato.