Mapeamento de dados do componente com propriedades do Adobe Analytics mapping-component-data-with-adobe-analytics-properties

Adicione componentes à estrutura que coletam os dados para enviar ao Adobe Analytics. Componentes projetados para coletar dados de análise armazenam os dados na instância Variável CQ. Quando você adiciona esse componente a uma estrutura, ela exibe a lista de variáveis CQ para que cada uma delas possa ser direcionada às Variável do Analytics.

aa-11

Quando a variável Visualização do AEM é aberto as variáveis do Analytics aparecem no localizador de conteúdo.

aa-12

É possível mapear várias variáveis do Analytics com a mesma Variável CQ.

chlimage_1-68

Os dados mapeados são enviados para o Adobe Analytics quando a página é carregada e as seguintes condições são atendidas:

  • A página está associada à estrutura.
  • A página usa os componentes adicionados à estrutura.

Use o procedimento a seguir para mapear variáveis de componente CQ com propriedades de relatório do Adobe Analytics.

  1. No Visualização do AEM, arraste um componente de rastreamento do sidekick para a estrutura. Por exemplo, arraste o Página componente do Geral categoria.

    aa-13

    Há vários grupos de componentes padrão: Geral, Commerce, Communities, e Outro. A instância do AEM pode ser configurada para exibir grupos e componentes diferentes.

  2. Para mapear variáveis do Adobe Analytics com variáveis definidas no componente, arraste uma Variável do Analytics do localizador de conteúdo para um campo no componente de rastreamento. Por exemplo, arrastar Page Name (pageName) para pagedata.title.

    aa-14

    note note
    NOTE
    A ID do conjunto de relatórios (RSID) selecionada para a estrutura determina as variáveis do Adobe Analytics que aparecem no localizador de conteúdo.
  3. Repita as duas etapas anteriores para outros componentes e variáveis.

    note note
    NOTE
    É possível mapear várias variáveis do Analytics (por exemplo, props, eVars, events) para a mesma variável do CQ (por exemplo, pagedata.title)
    note caution
    CAUTION
    É altamente recomendável que:
    • eVars e props são mapeados para variáveis CQ começando com um pagedata.X ou eventdata.X
    • considerando que os eventos devem ser mapeados para variáveis que começam com eventdata.events.X
  4. Para disponibilizar a estrutura na instância de publicação do site, abra Página do sidekick e clique em Ativar Framework.

O AEM usa uma convenção para nomear variáveis e eventos relacionados a produtos que devem ser mapeados para propriedades relacionadas a produtos do Adobe Analytics:

Variável CQ
Variável do Analytics
Descrição
product.category
product.category (variável de conversão)
A categoria do produto.
product.sku
product.sku (variável de conversão)
O SKU do produto.
product.quantity
product.quantity (variável de conversão)
O número de produtos sendo comprados.
product.price
product.price (variável de conversão)
O preço do produto.
product.events.<eventName>
Os eventos bem-sucedidos a serem associados ao produto em seu relatório.
product.events é o prefixo de eventos nomeados eventName
product.evars.<eVarName>
As variáveis de conversão ( eVar) para associar ao produto.
product.evars é o prefixo das variáveis de eVar denominadas eVarName.

Vários componentes do AEM Commerce usam esses nomes de variáveis.

NOTE
Não mapeie a propriedade Produtos do Adobe Analytics para uma variável do CQ. Configurar mapeamentos relacionados ao produto conforme descrito na tabela é efetivamente equivalente a mapear a variável Products.

Verificação de relatórios no Adobe Analytics checking-reports-on-adobe-analytics

  1. Faça logon no site da Adobe Analytics usando as mesmas credenciais fornecidas para o AEM.

  2. Certifique-se de que a RSID selecionada é a utilizada nas etapas anteriores.

  3. Entrada Relatórios (no lado esquerdo da página), selecione Conversão personalizada, depois Conversão personalizada 1-10 e selecione a variável correspondente a eVar7

  4. Dependendo da versão do Adobe Analytics que você está usando, é necessário aguardar em média 45 minutos para que o relatório seja atualizado com o termo de pesquisa usado; por exemplo, berinjela no exemplo

Uso do Localizador de conteúdo (cf#) com estruturas Adobe Analytics using-the-content-finder-cf-with-adobe-analytics-frameworks

Inicialmente, ao abrir uma estrutura do Adobe Analytics, o localizador de conteúdo contém variáveis predefinidas do Analytics em:

  • Tráfego
  • Conversão
  • Eventos

Quando uma RSID é selecionada, todas as variáveis pertencentes a essa RSID são adicionadas à lista.
A variável cf# é necessário mapear variáveis do Analytics para as variáveis do CQ presentes nos diferentes componentes de rastreamento. Consulte Configuração de uma estrutura para rastreamento básico.

Dependendo da exibição selecionada para a estrutura, o localizador de conteúdo será preenchido pelas variáveis do Analytics (na exibição AEM) ou pelas variáveis CQ (na exibição do Analytics).

A lista pode ser manipulada das seguintes maneiras:

  1. Quando em Visualização do AEM, a lista pode ser filtrada dependendo do tipo de variável selecionado com os três botões de filtro:

    • Se nenhum botão for selecionada, a lista mostrará a lista completa.
    • Se a variável Tráfego for selecionada, a lista exibirá somente as variáveis pertencentes à seção Tráfego.
    • Se a variável Conversão for selecionada, a lista exibirá somente as variáveis pertencentes à seção Conversion.
    • Se a variável Eventos for selecionada, a lista mostrará somente as variáveis pertencentes à seção Eventos.
    note note
    NOTE
    Somente um botão de filtro pode estar ativo de uma vez.
    1. A lista também tem um recurso de pesquisa, que filtra os elementos de acordo com o texto inserido no campo de pesquisa.
    2. Se uma opção de filtro estiver ativada ao procurar elementos na lista, os resultados exibidos também serão filtrados de acordo com o botão ativo.
    3. A lista pode ser recarregada a qualquer momento usando o botão de setas giratórias.
    4. Se várias RSIDs forem selecionadas na estrutura, todas as variáveis na lista serão exibidas usando todos os rótulos usados nas RSIDs selecionadas.
  2. Quando estiver na exibição do Adobe Analytics, o Localizador de conteúdo exibe todas as variáveis CQ pertencentes aos componentes de rastreamento arrastados na exibição do CQ.

    • Por exemplo, caso a variável Baixar componente é o somente um arrastado na visualização CQ (que tem duas variáveis mapeáveis) eventdata.downloadLink e eventdata.events.startDownload), o Localizador de conteúdo terá esta aparência ao alternar para a exibição do Adobe Analytics:

    aa-22

    • As variáveis podem ser arrastadas e soltas em qualquer variável do Adobe Analytics que pertença a uma das três seções de variáveis (Tráfego, Conversão e Eventos).

    • Ao arrastar um novo componente de rastreamento para a estrutura na exibição do CQ, as variáveis do CQ pertencentes ao componente são adicionadas automaticamente ao Localizador de conteúdo (cf#) na exibição do Adobe Analytics.

    note note
    NOTE
    Somente uma variável do CQ pode ser mapeada para uma variável do Adobe Analytics em um determinado momento.

Uso da visualização do AEM e do Analytics using-aem-view-and-analytics-view

A qualquer momento, os usuários podem alternar entre duas maneiras de visualizar os mapeamentos do Adobe Analytics em uma página de estrutura. As duas visualizações fornecem uma melhor visão geral dos mapeamentos dentro da estrutura, a partir de duas perspectivas distintas.

Visualização AEM aem-view

aa-23

Tomando a imagem acima como exemplo, a variável Visualização do AEM tem as seguintes propriedades:

  1. Essa é a exibição padrão quando a estrutura é aberta.

  2. Lado esquerdo: o localizador de conteúdo (cf#) é preenchido pelas variáveis do Adobe Analytics com base nas RSID(s) selecionadas.

  3. Cabeçalhos de guias (Visualização do AEM e Exibição do Analytics): use-os para alternar entre as duas exibições.

  4. Visualização do AEM:

    1. Se a estrutura tiver componentes herdados de seu pai, eles serão listados aqui, juntamente com as variáveis mapeadas para os componentes.

      1. Os componentes herdados estão bloqueados.
      2. Para desbloquear um componente herdado, clique duas vezes no cadeado ao lado do nome do componente
      3. Para reverter a herança, exclua o componente desbloqueado; depois disso, ele recuperará o status de bloqueado.
    2. Arraste componentes aqui para incluí-los no framework de análise: os componentes podem ser arrastados do Sidekick e soltos aqui.

    3. Você pode encontrar todos os componentes incluídos atualmente na estrutura de análise:

      1. Para adicionar um componente, arraste um da guia Componentes do sidekick
      2. Para excluir um componente e todos os seus mapeamentos, selecione Excluir no menu de contexto do componente e aceite a exclusão na caixa de diálogo de confirmação.
      3. Lembre-se de que um componente só pode ser excluído da estrutura em que foi criado e não pode ser excluído de estruturas secundárias no sentido tradicional (eles só podem ser substituídos).

Exibição do Analytics analytics-view

aa-24

  1. Essa visualização pode ser acessada alternando para o Exibição do Analytics no framework.

  2. Lado esquerdo: Localizador de conteúdo (cf#) preenchido por variáveis do CQ com base nos componentes arrastados para a estrutura na exibição do CQ.

  3. Cabeçalhos de guias (Visualização do AEM e Exibição do Analytics): use-os para alternar entre as duas exibições.

  4. As três tabelas (Tráfego, Conversão, Evento) listam todas as variáveis do Adobe Analytics disponíveis. pertencentes às RSIDs selecionadas. Os mapeamentos mostrados aqui devem ser os mesmos da exibição AEM:

    • Tráfego:

      • Variável de tráfego ( prop1) mapeado para uma variável do CQ ( eventdata.downloadLink)

      • Quando o componente tem um Cadeado ao lado dele, significa que é herdado de uma estrutura principal e, portanto, não pode ser editado

    • Conversão:

      • Variável de conversão ( eVar1) mapeado para uma variável do CQ ( pagedata.title)

      • Variável de conversão ( eVar3) mapeado para uma expressão JavaScript adicionada em linha clicando duas vezes no campo de variável CQ e inserindo o código manualmente

    • Evento:

      • Variável de evento ( event1) mapeado para um evento CQ ( eventdata.events.pageView)
NOTE
A coluna da variável CQ de qualquer tabela também pode ser preenchida em linha, clicando duas vezes no campo e adicionando texto a ele. Esses campos aceitam JavaScript como uma entrada.
Por exemplo, ao lado de prop3 você pode adicionar:
     '* Adobe:'+pagedata.title+':'+pagedata.sitesection
para enviar o título de uma página concatenada com seu sitesection usar : (dois pontos) e com prefixo Adobe as prop3
CAUTION
Somente uma variável do CQ pode ser mapeada para uma variável do Adobe Analytics em um determinado momento.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2