Configuração do rastreamento de links para 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 seu site, rastrear downloads de arquivos e links de saída.

  1. Usando a Navegação, vá pela Implantação, Cloud Services para a seção Adobe Analytics .

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

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

    aa-08

Acompanhamento de downloads de arquivos

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

Por padrão, os downloads dos seguintes tipos de arquivo são rastreados:

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

Por exemplo, com o rastreamento de download ativado 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çãoConfiguração de rastreamento de link.
  2. Ative Rastrear downloads.
  3. Na caixa Download de tipos de arquivo, digite as extensões de nome de arquivo para os tipos de arquivos que você deseja rastrear.

Você pode rastrear os cliques de links externos (links de saída) em 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 seguintes propriedades de acordo com seus requisitos.

Propriedades para rastreamento quando links externos são clicados:

  • Rastrear externo Permite o rastreamento de links externos.

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

    Para especificar os links externos a serem rastreados, digite todo o URL ou parte do URL do público alvo do link. Separe vários filtros com uma vírgula. Inclua 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 internosDefine filtros para corresponder aos URLs de links internos. Quando o link público alvo 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 para o endereço da janela atual.

    Para especificar os links internos que não são rastreados, digite parte ou a totalidade do URL interno do público alvo do link. Separe vários filtros com uma vírgula. Inclua literais de string entre aspas simples.

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

  • Deixar cadeia de caracteres Inclui parâmetros de URL ao avaliar correspondências com filtros internos e externos.

    Permita a inclusão de parâmetros de URL ao avaliar URLs de públicos alvos de links em relação a filtros externos e internos.

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

  • O filtro externo é 'google.com'
  • O filtro interno é o valor padrão de 'javascript:,'+window.location.hostname
  • As strings de Query não são incluídas ao avaliar o público alvo 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 AEM para enviar dados de eventos e variáveis à Adobe Analytics quando um usuário clicar em um link. As propriedades de Configuração de rastreamento de link permitem que você especifique os eventos e as variáveis do Adobe Analytics para rastrear quando ocorrerem cliques em links.

Os mapeamentos de estrutura determinam os valores de evento e variável. Você pode mapear variáveis do Adobe Analytics para as variáveis dos componentes de conteúdo que armazenam os dados que 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çãoConfiguração de rastreamento de link.
  2. Configure as seguintes propriedades de acordo com seus requisitos.

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

  • EventosRastreamento de link Digite as variáveis do evento Adobe Analytics que você deseja usar para contar cliques em links.

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

    O valor padrão de não None causa rastreamento de eventos.

  • Link Track Vars 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 não None faz com que dados variáveis sejam enviados.

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

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

Execute os seguintes procedimentos para explorar o comportamento de rastreamento de link da integração com o Adobe Analytics. Os procedimentos mostram os resultados do Adobe Experience Cloud Debugger.

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 até a área de mapeamentos da estrutura. O componente Página pertence ao grupo de componentes Geral no Sidekick.

    Observação

    O componente que você deve usar em um cenário real depende do componente herdado (se for o caso).

    Caso contrário, você deve ter seu próprio componente exposto ali (definindo um subnó de análise 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:

CQ Variable
Entrada no navegador de variáveis
Variável Adobe Analytics
pagedata.title eVar personalizado 1 (eVar 1) eVar1
eventdata.events.pageView Personalizado 1 (evento 1) event1
  1. Arraste o componente de Pesquisa para a área de 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:
CQ Variable
Entrada no navegador de variáveis Variável Adobe Analytics
eventdata.keyword eVar personalizado 2 (eVar 2) eVar2
eventdata.results eVar personalizado 3 (eVar 3) eVar3
eventdata.events.search Personalizado 2 (evento 2) event2
  1. Em sua estrutura, expanda a área Configuração de rastreamento de link.

  2. Desmarque Rastrear downloads.

  3. Selecione Rastrear externo.

  4. Desmarque Sair da sequência de Query.

  5. Use o seguinte valor para a lista Filtros ​externos para identificá-la como um URL externo:

    ‘yahoo.com’

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

        event1,event2
    
  7. Adicione o seguinte valor ao campo Vars de rastreamento de link:

        eVar1,eVar2
    
  8. Na página que está associada à estrutura, adicione um componente de Texto . No componente de Texto , adicione um hiperlink que aponte para o seguinte endereço:

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

  9. Alterne para o modo de Pré-visualização e clique no link.

A chamada feita terá a seguinte aparência quando exibida com o Adobe Marketing Cloud Debugger:

aa-leavequerysearch-blank

Observação

O URL não contém a string de Query: ?p=this

Incluir o parâmetro de URL

  1. Na estrutura, expanda a área Configuração de rastreamento de link.
  2. Ative a sequência de caracteres de Query Leave.
  3. Recarregue a pré-visualização da página e clique no link.

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

aa-leavequerysearch-ative

Observação

Desta vez, o URL contém a string do Query: ?p=this

O rastreamento de link ad-hoc permite que 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 links de URLs.

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

Para ativar o rastreamento de links 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.

    Observação

    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.

Observação

A configuração do XSS Antisamy está agora no SLING no caminho /libs/sling/xss.config.xml e as seguintes regras precisam ser adicionadas para que a vinculação ad-hoc funcione:

Extensão da regra de tag âncora

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

Antes de configurar o rastreamento de link ad-hoc para os próprios componentes de Texto , as seguintes configurações já devem ter sido implementadas:

Use o seguinte procedimento para configurar o rastreamento de link 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.

  3. Adicione o URL do público alvo na caixa Link para e expanda a área Rastreamento de link.

    Observação

    O rastreamento de link personalizado é visível como uma ação separada, ao lado da ação Vincular/Desvincular (Ícone do Analytics).

    Ela só será ativada quando você tiver selecionado um Link válido no RTE.

    aa-17

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

  5. (Opcional) Para rastrear eventos com o clique no link, 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 variáveis com o clique do link, adicione variáveis Adobe Analytics no campo Incluir variáveis 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.

Nesta página