Introdução ao rastreamento de mensagens get-started-tracking

IMPORTANT
Para obter a orientação geral de rastreamento que se aplica ao Campaign Classic v7 e ao Campaign v8, consulte a documentação de rastreamento de mensagens do Campaign v8:
Esta página documenta apenas os recursos de rastreamento específicos do Campaign Classic v7, principalmente para implantações híbridas e locais.

Recursos de rastreamento

Configuração de rastreamento configure-tracking

Para o Campaign Classic v7 implantações híbridas/no local, é necessário configurar o rastreamento no nível da instância antes de usá-lo.

NOTE
Para o Campaign v8 Managed Cloud Services, a configuração de rastreamento é executada pela Adobe.

Princípio operacional

Antes de usar o rastreamento, é necessário configurá-lo para a sua instância. A configuração precisa ser executada no(s) servidor(es) de aplicativos e no(s) servidor(es) da Web do Adobe Campaign.

No Campaign, há dois tipos de rastreamento:

  • Rastreamento web: este modo permite rastrear visitas às páginas do seu site
  • Rastreamento de mensagens: esse modo permite rastrear as entregas de mensagens e o comportamento do destinatário

O modo de rastreamento é selecionado durante a instalação. Para instalações no local, a configuração de rastreamento deve ser definida no nível da instância. Saiba mais

Servidor de rastreamento

Para configurar o rastreamento, sua instância deve ser declarada e registrada nos servidores de rastreamento. O servidor de rastreamento é usado para registrar e recuperar informações sobre URLs clicados pelos recipients.

Para instalações no local, o servidor de rastreamento geralmente é um servidor Web que executa o aplicativo Web do Adobe Campaign. O URL do servidor de rastreamento deve ser definido na configuração da instância. Saiba mais

Salvar o rastreamento

Depois que o rastreamento é configurado e os URLs são preenchidos, o servidor de rastreamento deve ser registrado. O registro permite que o Adobe Campaign salve informações de rastreamento e forneça relatórios e estatísticas sobre atividades rastreadas.

Para instalações locais, as informações de rastreamento são armazenadas no banco de dados e recuperadas por meio de workflows técnicos. O fluxo de trabalho técnico Rastreamento processa e armazena os dados de rastreamento coletados do servidor de redirecionamento. Saiba mais

Rastreamento de aplicativo web web-application-tracking

{width="60px"}

NOTE
O rastreamento de aplicativos web é específico do Campaign Classic v7 e não está disponível no Campaign v8.

Rastreamento de uma aplicação web

Também é possível rastrear e medir visitas em páginas de aplicação web com tags de rastreamento. Essa funcionalidade pode ser usada para todos os tipos de aplicativo Web, como formulários e landing pages. Saiba mais

Recusar rastreamento da aplicação web

A opção de recusar o rastreamento de aplicações web permite que você interrompa o rastreamento dos comportamentos da Web de usuários finais que recusam o rastreamento comportamental. Você pode incluir a capacidade de exibir um banner em aplicações web ou landing pages para permitir que os usuários recusem. Saiba mais

Solução de problemas de rastreamento tracking-troubleshooting

{width="60px"}

As seguintes dicas de solução de problemas se aplicam a implantações híbridas/no local do Campaign Classic v7. Algumas informações também podem se aplicar às implantações locais do Campaign v8. Para obter ajuda com o Managed Cloud Services do Campaign v8, entre em contato com o representante da Adobe.

Para obter as etapas básicas de solução de problemas de rastreamento no Campaign v8, consulte a Documentação sobre solução de problemas de rastreamento no Campaign v8.

Verificações básicas basic-checks

Verifique se o processo trackinglogd está em execução

Esse processo lê a memória compartilhada do IIS/Servidor Web e grava os logs de redirecionamento.

Você pode acessá-la na Página inicial selecionando a guia Monitoramento na sua instância. Você também pode executar o seguinte comando na instância: <user>@<instance>:~$ nlserver pdump

Se o processo trackinglogd não aparecer na lista, inicie-o com o seguinte comando na instância: <user>@<instance>:~$ nlserver start trackinglogd

Verifique se o fluxo de trabalho técnico de Acompanhamento foi executado recentemente

Você pode localizar o fluxo de trabalho técnico de Rastreamento nas pastas de workflows técnicos da > Produção > de Administração.

Solução avançada de problemas advanced-troubleshooting

O fluxo de trabalho de rastreamento está falhando
note note
NOTE
Disponível somente para Windows

O arquivo de log de rastreamento corrompido …/nl6/var/<instance_name>/redir/log/0x0000 log pode interromper o fluxo de trabalho de rastreamento. Para detectar facilmente linhas corrompidas e removê-las para retomar o fluxo de trabalho de rastreamento, você pode usar os comandos abaixo.

Sei em qual arquivo a linha corrompida está

Nesse caso, linhas corrompidas podem ser encontradas no arquivo de log 0x00000000000A0000.log, mas o mesmo processo pode ser aplicado a um conjunto de arquivos, um por um.

code language-none
$ cd {install directory}/var/{instance name}/redir/log
$ cat 0x00000000000A0000.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'

Em seguida, você pode interromper o fluxo de trabalho de rastreamento, excluir as linhas corrompidas e reiniciar o fluxo de trabalho.

Não sei em qual arquivo está a linha corrompida

  1. use a seguinte linha de comando para fazer verificar em todos os arquivos de rastreamento.

    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'
    
  2. O comando lista todas as linhas corrompidas. Por exemplo:

    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.64
    
    note note
    NOTE
    Um retorno de carro foi adicionado antes do Agente do Usuário para permitir melhor leitura e não reflete a renderização real.
  3. Execute um comando grep para localizar o arquivo correspondente.

    code language-none
    $ grep -Rn <Log Id>
    # for example:
    $ grep -Rn 50x000000000FD7EC86
    
  4. Localize o log com falha com o nome do arquivo e o número da linha. Por exemplo:

    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.64
    
    note note
    NOTE
    Um retorno de carro foi adicionado antes do Agente do Usuário para permitir melhor leitura e não reflete a renderização real.

Em seguida, você pode interromper o fluxo de trabalho de rastreamento, excluir as linhas corrompidas e reiniciar o fluxo de trabalho.

Os links de rastreamento falham intermitentemente

Quando você tenta acessar os links de rastreamento, a seguinte mensagem é exibida:

Requested URL '/r/ id=h787bc0,281a4d8,281a4da&p1=1' cannot be found

  1. Acesse a URL <redirection_server>/r/test e verifique se o número da compilação e o host local foram retornados pela solicitação.

  2. Verifique a configuração spareServer no arquivo serverConf.xml do servidor de rastreamento. Essa configuração deve estar no modo de redirecionamento.

    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>
    
  3. Verifique manualmente se o arquivo <deliveryID>.xml existe no computador no diretório …/nl6/var/<instance_name>/redir/url/<YYYY> (YYYY representa o ano da entrega).

  4. Verifique manualmente se <trackingUrlId> pode ser encontrado no arquivo <deliveryID>.xml.

  5. Verifique manualmente a existência de broadlogID na entrega deliveryID relacionado.

  6. Verifique as permissões dos arquivos <deliveryID>.xml no diretório …/nl6/var/<instance_name>/redir/url/year.

    Deve haver pelo menos 644 permissões para que o Apache possa ler urls de rastreamento a fim de redirecionar o link solicitado.

Atualização da opção NmsTracking_Pointer

Siga estas etapas ao atualizar a opção NmsTracking_Pointer:

  1. Interrompa o fluxo de trabalho de rastreamento.

  2. Interrompa o serviço trackinglogd.

  3. Atualize a opção NmsTracking_Pointer para o valor desejado.

  4. Reinicie o serviço trackinglogd.

  5. Reinicie o fluxo de trabalho de rastreamento.

O rastreamento não funciona com algum WebMail

Você pode personalizar a fórmula de rastreamento de cliques e especificar uma fórmula de rastreamento do Adobe Analytics personalizada.

Esse tipo de personalização precisa ser feito com cautela para evitar a adição de caracteres de avanço de linha. Todos os caracteres de avanço de linha presentes fora da expressão JavaScript estarão presentes na fórmula final.

Esse tipo de caractere extra de avanço de linha no URL de rastreamento levará a problemas em algum WebMail (AOL, GMail etc.).

Primeiro exemplo:

  • Sintaxe incorreta

    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() %><% } %>
    
  • Sintaxe correta

    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() %><% } %>
    

Para entender onde está o avanço de linha extra, é possível substituir a expressão JavaScript por uma STRING fixa.

code language-none
// Incorrect
STRING1
&cid=STRING2&bid=STRING3

// Correct
STRING1&cid=STRING2&bid=STRING3

Segundo exemplo

  • Sintaxe incorreta

    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 %><% }
    
    %>
    
  • Sintaxe correta

    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 %><% }
    
    %>
    

Para entender onde está o avanço de linha extra, é possível substituir a expressão JavaScript por uma STRING fixa.

code language-none
// Incorrect
STRING1&cid=STRING2&bid=STRING3&SHPID=STRING4

// Correct
STRING1&cid=STRING2&bid=STRING3&SHPID=STRING4
A recuperação de logs de rastreamento é muito lenta

Quando a instância não recupera logs de rastreamento diretamente, mas de um servidor Adobe Campaign Classic distante, os logs são recuperados por meio da chamada SOAP GetTrackingLogs definida no esquema remoteTracking.

Uma opção no arquivo serverConf.xml permite que você defina o número de logs recuperados simultaneamente por meio deste método: logCountPerRequest.

O valor padrão de logCountPerRequest igual a 1000 pode ser muito pequeno em alguns casos. Os valores aceitos devem estar entre 0 e 10.000.

Não foi possível vincular logs de rastreamento a destinatários

No Adobe Campaign Classic, um target mapping deve ser único em termos de esquema de destinatário versus esquemas broadlog/trackinglog.

Não é possível usar vários esquemas de direcionamento com o mesmo esquema trackinglog, pois o fluxo de trabalho de rastreamento não conseguirá reconciliar os dados com a id de direcionamento.

Se você não quiser usar o target mapping pronto para uso com nms:recipient, recomendamos as seguintes abordagens:

  • Se você quiser usar o targeting dimension personalizado, será necessário criar o esquema broadLog/trackingLog personalizado usando nms:broadlog como modelo (por exemplo, nms:broadLogRcp, nms:broadLogSvc etc.).

  • Se você quiser usar OOB trackingLogRcp/broadLogRcp, o targeting dimension precisará ser nms:recipient e a dimensão de filtragem poderá ser um esquema personalizado.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1