Configuração do rastreamento de links para o Adobe Analytics configuring-link-tracking-for-adobe-analytics

Quando os usuários clicam em links nas páginas do seu site, você pode capturar informações relacionadas no Adobe Analytics. Por exemplo, use o rastreamento de link para saber como os usuários interagem com o seu site, rastreie downloads de arquivos e rastreie links de saída.

  1. Usando a Navegação, acesse Implantação, Cloud Service para a seção Adobe Analytics.

  2. Usando o Mostrar Configurações, abra a estrutura necessária do Adobe Analytics.

  3. Expanda a seção Configuração de Rastreamento de Link e configure conforme necessário (esta página fornece mais detalhes):

    Estrutura do Analytics

Rastreamento de downloads de arquivos tracking-file-downloads

Configure a estrutura do Adobe Analytics para que os arquivos baixados de páginas associadas sejam rastreados automaticamente como downloads no Adobe Analytics. Quando você habilita o rastreamento de downloads, somente os tipos de arquivo especificados são rastreados.

Os downloads dos seguintes tipos de arquivos são rastreados por padrão:

  • exe
  • zip
  • wav
  • mp3
  • mov
  • mpg
  • avi
  • wmv
  • doc
  • pdf
  • xls

Por exemplo, com o rastreamento de download habilitado para arquivos PDF, sempre que os usuários clicam em links para arquivos PDF, o download do PDF é rastreado.

As propriedades de rastreamento de download da estrutura são implementadas como código no arquivo analytics.sitecatalyst.js gerado para uma página. A amostra de código a seguir representa a configuração padrão de rastreamento de download:

s.trackDownloadLinks= true;
s.linkDownloadFileTypes= 'exe,zip,wav,mp3,mov,mpg,avi,wmv,doc,pdf,xls';

Para ativar o rastreamento de download para sua estrutura do Adobe Analytics:

  1. Abra a estrutura do Adobe Analytics e expanda a seção Configuração de Rastreamento de Link.
  2. Habilitar Rastrear Downloads.
  3. Na caixa Baixar Tipos de Arquivo, digite as extensões de nome de arquivo para os tipos de arquivos que deseja rastrear.

Você pode rastrear o clique em links externos (links de saída) nas suas páginas.

Para rastrear links externos para sua estrutura do Adobe Analytics:

  1. Abra a estrutura do Adobe Analytics e expanda a seção Configuração de Rastreamento de Link.
  2. Configure as propriedades a seguir de acordo com seus requisitos.

Propriedades para rastrear quando links externos são clicados:

  • Rastrear externo
    Ativa o rastreamento de links externos.

  • Filtros Externos
    (Opcional) Define filtros para corresponder aos URLs externos dos destinos de links. Quando os destinos do link correspondem ao filtro, o link é rastreado. Os filtros externos são úteis para rastrear apenas alguns dos links externos nas suas páginas.

    Para especificar os links externos a serem rastreados, digite todo o URL ou parte do destino do link. Separe vários filtros com uma vírgula. Coloque os literais de string entre aspas simples. Nenhum valor (o valor padrão de '', duas aspas simples) faz com que todos os links externos sejam rastreados.

  • Filtros Internos
    Define filtros para corresponder aos URLs de links internos. Quando o link é direcionado a URLs que correspondem a esse filtro, o link não é rastreado. O valor padrão é um comando javascript que retorna o nome do host do URL do endereço da janela atual.

    Para especificar os links internos que não são rastreados, digite todo o URL interno do destino do link ou parte dele. Separe vários filtros com uma vírgula. Coloque os literais de string entre aspas simples.

    O valor padrão é 'javascript:,'+window.location.hostname

  • Sair da cadeia de consulta
    Inclui parâmetros de URL ao avaliar correspondências com filtros internos e externos.

    Ative se quiser incluir parâmetros de URL ao avaliar URLs de destino de link em relação a filtros externos e internos.

As propriedades de rastreamento de link externo são implementadas como código no arquivo analytics.sitecatalyst.js gerado para uma página. O código de exemplo a seguir é gerado para uma página associada a uma estrutura que ativou o rastreamento de links externos com a seguinte configuração:

  • O filtro externo é 'google.com'
  • O filtro interno é o valor padrão de 'javascript:,'+window.location.hostname
  • As sequências de consulta não são incluídas ao avaliar o destino do link em relação aos filtros.
s.trackExternalLinks= false;
s.linkExternalFilters= 'google.com';
s.linkInternalFilters= 'javascript:,'+window.location.hostname;
s.linkLeaveQueryString= false;

Você pode configurar o AEM para enviar dados de eventos e variáveis para o Adobe Analytics quando um usuário clicar em um link. As propriedades da Configuração de Rastreamento de Link permitem que você especifique os eventos e as variáveis do Adobe Analytics a serem rastreados quando ocorrerem cliques em links.

Os mapeamentos da estrutura determinam o evento e os valores da variável. Você pode mapear variáveis do Adobe Analytics para as variáveis dos componentes de conteúdo que armazenam os dados que você deseja rastrear quando os links são clicados.

Para enviar dados variáveis com cliques em links:

  1. Abra a estrutura do Adobe Analytics e expanda a seção Configuração de Rastreamento de Link.
  2. Configure as propriedades a seguir de acordo com seus requisitos.

Propriedades para enviar dados variáveis com cliques em links:

  • Vincular Eventos de Rastreamento
    Insira as variáveis de evento do Adobe Analytics que deseja usar para contar cliques em links.

    Separe vários nomes de variáveis com uma vírgula.

    O valor padrão de None não causa nenhum rastreamento de evento.

  • Vars de rastreamento de link
    Insira as variáveis do Adobe Analytics que você deseja enviar para o Adobe Analytics quando os links forem clicados. Separe vários nomes de variáveis com uma vírgula.

    O valor padrão de None faz com que nenhum dado variável seja enviado.

Quando você especifica os eventos e as variáveis a serem enviados, a configuração é implementada como código no arquivo analytics.sitecatalyst.js gerado para uma página. O código de exemplo a seguir é gerado para uma página quando a estrutura rastreia o evento event10 e a propriedade prop4:

s.linkTrackEvents= 'event10';
s.linkTrackVars= 'prop4';

Execute os procedimentos a seguir para explorar o comportamento de rastreamento de link da integração do Adobe Analytics. Os procedimentos mostram resultados do Adobe Marketing Cloud Debugger.

Configuração geral general-configuration

Este exemplo ilustra como o mapeamento funciona no contexto do rastreamento e do depurador:

  1. Abra a estrutura que foi associada a uma página da Web.

  2. Arraste o componente Página para a área de mapeamentos da estrutura. O componente Página pertence ao grupo de componentes Geral no Sidekick.

    note note
    NOTE
    O componente que você deve usar em um cenário da vida real depende do componente herdado de (se for o caso).
    Caso contrário, você deve ter seu próprio componente exposto lá (definindo um subnó do Analytics em seu componente de página).

    Configure o mapeamento de acordo com a tabela a seguir, arrastando a variável do Analytics (SiteCatalyst) do painel lateral esquerdo:

Variável CQ
Entrada no Navegador de Variáveis
Variável do Adobe Analytics
pagedata.title
EVar Personalizado 1 (eVar 1)
EVAR 1
eventdata.events.pageView
Personalizado 1 (event1)
event1
  1. Arraste o componente Pesquisa para a área mapeamentos da estrutura. O componente de Pesquisa pertence ao grupo de componentes Geral no Sidekick. Configure o mapeamento de acordo com a tabela a seguir, arrastando a variável do Analytics (SiteCatalyst) do painel lateral esquerdo:
Variável CQ
Entrada no navegador de variáveis
Variável do Adobe Analytics
eventdata.keyword
EVar personalizado 2 (eVar 2)
EVAR 2
eventdata.results
EVar Personalizado 3 (eVar 3)
EVAR 3
eventdata.events.search
Personalizado 2 (event2)
event2
  1. Em sua estrutura, expanda a área Configuração de rastreamento de link.

  2. Desmarque Rastrear downloads.

  3. Selecione Rastrear externo.

  4. Desmarque Deixar Cadeia de Consulta.

  5. Use o seguinte valor para a lista Filtros Externos para identificá-la como uma URL externa:

    'yahoo.com'

  6. Adicione o seguinte valor ao campo Eventos de rastreamento de link:

    code language-none
        event1,event2
    
  7. Adicione o seguinte valor ao campo Vincular vars de rastreamento:

    code language-none
        eVar1,eVar2
    
  8. Na página associada à estrutura, adicione um componente Texto. Dentro do componente Texto, adicione um hiperlink apontando para o seguinte endereço:

    https://search.yahoo.com/?p=this

  9. Alterne para o Modo de visualização e clique no link.

A chamada feita terá esta aparência quando visualizada com o Adobe Marketing Cloud Debugger:

Adobe Marketing Cloud Debugger

NOTE
A URL não contém a sequência de consulta: ?p=this

Incluir o parâmetro de URL include-the-url-parameter

  1. Na estrutura, expanda a área Configuração de rastreamento de link.
  2. Habilitar Sair da Cadeia de Consulta.
  3. Recarregue a visualização da página e clique no link.

Os detalhes da chamada exibidos no Adobe Marketing Cloud Debugger são semelhantes ao seguinte exemplo:

Adobe Marketing Cloud Debugger novamente

NOTE
Desta vez, a URL não contém a sequência de consulta: ?p=this

O rastreamento de link ad-hoc permite que os autores de conteúdo configurem o rastreamento de link para um componente. A configuração do componente substitui a Configuração de Rastreamento de Link da estrutura. Portanto, nas páginas associadas à estrutura, os componentes de Texto podem ser configurados para rastreamento de link de URLs.

O rastreamento de link ad-hoc permite rastrear links de download, links externos, juntamente com dados de evento e variáveis.

Para habilitar o rastreamento de link ad-hoc, é necessário:

Configure sua estrutura do Adobe Analytics para ativar o rastreamento de links ad-hoc.

  1. Abra a estrutura do Adobe Analytics e expanda a seção Configuração de rastreamento de link.

  2. Habilitar Rastreamento de Link Ad-hoc.

    note note
    NOTE
    Nem todos os tipos de usuários têm acesso a essa caixa de seleção. Entre em contato com o administrador do site se precisar de acesso.
NOTE
A configuração do XSS Antisamy agora está no SLING no caminho /libs/sling/xss.config.xml e as seguintes regras precisam ser adicionadas ao ad-hoc para que a vinculação funcione:

Extensão de regra de tag de âncora anchor-tag-rule-extension

<attribute name="onclick">
    <literal-list>
        <literal value="CQ_Analytics.Sitecatalyst.customTrack(this)"/>
    </literal-list>
</attribute>
<attribute name="adhocenable">
    <literal-list>
        <literal value="true"/>
        <literal value="false"/>
    </literal-list>
</attribute>
<attribute name="adhocevents">
    <regexp-list>
        <regexp name="anything"/>
    </regexp-list>
</attribute>
<attribute name="adhocevars">
    <regexp-list>
        <regexp name="anything"/>
    </regexp-list>
</attribute>

Para que você possa configurar o rastreamento de links ad-hoc para os próprios componentes Texto, as seguintes configurações já devem ter sido implementadas:

Use o procedimento a seguir para configurar o rastreamento de links para um componente de Texto:

  1. Abra a página no modo de edição e edite o componente Texto.

  2. Selecione o texto que deseja usar como hipertexto e clique no botão Hiperlink.

    Ícone de link

  3. Adicione o URL de destino na caixa Link para e expanda a área Rastreamento de link.

    note note
    NOTE
    O rastreamento de link personalizado está visível como uma ação separada, ao lado da ação Vincular/Desvincular (ícone do Analytics).
    Ele só será ativado quando você selecionar um link válido no RTE.

    Habilitando o rastreamento de links

  4. Habilite o Rastreamento de link personalizado para substituir a configuração de rastreamento de link da estrutura do Adobe Analytics e habilitar o rastreamento de link para o link atual.

  5. (Opcional) Para rastrear eventos com o clique em links, adicione nomes de eventos Adobe Analytics no campo Incluir variáveis Adobe Analytics. Separe o nome de vários eventos com vírgulas, por exemplo

    event1, event22.

  6. (Opcional) Para rastrear dados de variáveis com o clique em links, adicione variáveis do Adobe Analytics no campo Incluir variáveis do Adobe Analytics. Use um dos seguintes formatos:

    • <Variable-name>: <Dynamic Value>
    • <Variable-name>: 'CONSTANT'

    Os exemplos a seguir ilustram cada formato:

    • eVar10:pagedata.title
    • prop1: 'Aubergine'

    Separe vários valores com uma vírgula.

  7. Selecione OK.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2