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

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

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, rastreia downloads de arquivo e rastreia links de saída.

  1. Usando Navegação, acessar Implantação, Cloud Services para Adobe Analytics seção.

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

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

    aa-08

Rastreamento de downloads de arquivo tracking-file-downloads

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

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

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

Assim, 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 analytics.sitecatalyst.js arquivo que é 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. No Fazer download de tipos de arquivo digite as extensões do nome do arquivo para os tipos de arquivos que você deseja rastrear.

Você pode rastrear o clique 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 Configuração de rastreamento de link seção.
  2. Configure as seguintes propriedades de acordo com suas necessidades.

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 destinos de links. Quando os destinos do link correspondem ao filtro, o link é rastreado. Filtros externos são úteis para rastrear apenas alguns dos links externos em suas páginas.

    Para especificar os links externos a serem rastreados, digite a totalidade ou parte do URL do destino do link. Separe vários filtros com uma vírgula. Inserir 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 direciona os 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 parte ou todo o URL interno do destino do link. Separe vários filtros com uma vírgula. Inserir literais de string entre aspas simples.

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

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

    Ative para incluir parâmetros de URL ao avaliar URLs de direcionamento de link em filtros externos e internos.

As propriedades de rastreamento de link externo são implementadas como código no analytics.sitecatalyst.js arquivo que é 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 sequências de consulta não são incluídas ao avaliar o direcionamento 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 evento e variável ao Adobe Analytics quando um usuário clicar em um link. O Configuração de rastreamento de link As propriedades permitem que você especifique os eventos e variáveis do Adobe Analytics a serem rastreados 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 seus 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ção Configuração de rastreamento de link ..
  2. Configure as seguintes propriedades de acordo com suas necessidades.

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

  • Eventos de rastreamento de link
    Insira as variáveis de evento do 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 None não causa 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 para enviar, a configuração é implementada como código na analytics.sitecatalyst.js arquivo que é gerado para uma página. O código de exemplo a seguir é gerado para uma página quando a estrutura rastreia a variável event10 e o prop4 propriedade:

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

Execute os seguintes procedimentos para explorar o comportamento de rastreamento de link da integração do Adobe Analytics. Os procedimentos mostram resultados de Adobe Experience 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 Página para a área de mapeamentos da estrutura. O Página pertence ao Geral grupo de componentes no Sidekick.

    note note
    NOTE
    O componente que você deve usar em um cenário real depende do componente herdado de (se houver).
    Caso contrário, você deve ter seu próprio componente exposto lá (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 Analytics (SiteCatalyst) do painel lateral esquerdo:

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

  2. Desmarcar Rastrear downloads.

  3. Selecionar Rastrear externo.

  4. Desmarcar Deixar cadeia de consulta.

  5. Use o seguinte valor para a variável Filtros externos para identificá-la como uma URL externa:

    ‘yahoo.com’

  6. Adicione o seguinte valor à variável Eventos de rastreamento de link campo :

    code language-none
        event1,event2
    
  7. Adicione o seguinte valor à variável Vars de rastreamento de link campo :

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

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

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

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

aa-leavequerysearch-blank

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

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

  1. Na estrutura, expanda a variável Configuração de rastreamento de link área.
  2. Habilitar Deixar 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:

aa-leavequerysearch-ative

NOTE
Desta vez, o URL 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 variável Configuração de rastreamento de link da estrutura, assim, nas páginas associadas à estrutura, Texto componentes 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 ativar o rastreamento de link ad-hoc, é necessário:

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

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

  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 Analytics agora está 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 de regra de tag â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>

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

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

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

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

  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 é visível como uma ação separada, ao lado da ação Vincular/Desvincular (ícone do Analytics).
    Ele só será ativado quando você tiver selecionado um Link válido no RTE.

    aa-17

  4. Habilitar 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 em links, adicione nomes de eventos do Adobe Analytics na Incluir variáveis do Adobe Analytics campo. Separe vários nomes de evento com vírgulas, por exemplo

    event1, event22.

  6. (Opcional) Para rastrear dados variáveis com o clique em links, adicione variáveis Adobe Analytics na função Incluir variáveis do Adobe Analytics campo. Use qualquer 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. Selecionar OK.

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8