Show Menu
TÓPICOS×

Usar a camada de dados do cliente Adobe para integrar componentes principais e o Adobe Analytics

Este documento detalha como configurar uma configuração completa com base no AEM, na Adobe Client Data Layer, no Adobe Launch e no Adobe Analytics para rastrear:
  • A ID da página armazenada na Adobe Client Data Layer quando uma página é carregada
  • O caminho da imagem armazenado na Adobe Client Data Layer quando uma imagem é clicada
Isso usa os componentes principais como exemplo, mas pode ser usado para seus próprios componentes personalizados.

Etapa 1 - Criar o conjunto de relatórios no Adobe Analytics

Para agregação e análise de seus dados, primeiro é necessário criar um conjunto de relatórios.
  1. Ir para https://analytics.adobe.com .
  2. Faça logon usando sua Adobe ID.
  3. Clique no ícone Analytics .
  4. Vá para Admin -> Report Suites .
  5. Clique em Criar novo -> Conjunto de relatórios.
  6. Preencha o formulário:
    1. ID do Conjunto de relatórios : yourSuiteID
    2. Título do site: Your suite description
    3. Fuso horário : Conforme apropriado
    4. Data de ativação: data de hoje ou conforme apropriado
    5. Visualizações de página estimadas por dia : 100 ou, se for caso disso
  7. Clique em Criar conjunto de relatórios.
Se tiver êxito, você receberá a seguinte mensagem em verde: Report Suite <yourReportSuite> has been successfully created.

Etapa 2 - Tornar o conjunto de relatórios visível

Para usar o novo conjunto de relatórios, ele deve estar visível.
  1. Ir para https://adminconsole.adobe.com .
  2. Faça logon usando sua Adobe ID.
  3. Clique no cartão do Adobe Analytics - <site>
  4. Clique no link Adobe Analytics - <site>
  5. Select the Permissions tab
  6. Clique no botão Editar da linha Report Suites
  7. Clique no botão + do conjunto de relatórios criado na etapa 1 para adicioná-lo à categoria Itens de permissão incluídos.
  8. Clique em Salvar .

Etapa 3 - Integrar seu site do AEM ao Adobe Launch

O Launch deve ser integrado ao site do AEM para gerar dados.

Etapa 4 - Instalar e configurar o Adobe Analytics Extension no Adobe Launch

O Adobe Analytics Extension permite a integração do Analytics com o Launch.
  1. No Adobe Launch, selecione a propriedade recém-adicionada que você criou na etapa 3.
  2. Navegue até a guia Extensões e selecione Catálogo .
  3. Procure o Adobe Analytics .
  4. Clique em Instalar .
  5. Configure a extensão.
    1. Insira a ID do conjunto de relatórios do Analytics criada na etapa 1 para os ambientes apropriados
    2. Definir conjunto de caracteres como UTF-8
  6. Clique em Salvar

Etapa 5 - Criar um elemento de dados no Adobe Launch para a ID da página

Um elemento de dados é necessário no Launch para poder rastrear a ID da página.
  1. No Adobe Launch, selecione a propriedade criada na etapa 3.
  2. Selecione a guia Elementos de dados e clique em Adicionar elemento de dados:
    1. Nome : dl-page-id
    2. Extensão : Núcleo
    3. Tipo de elemento de dados: Código personalizado
  3. Clique em Abrir editor
  4. No editor, insira o código: return adobeDataLayer.getState().page.id;
  5. Clique em Salvar .
  6. Clique em Salvar para criar o elemento de dados.

Etapa 6 - Criar uma regra no Adobe Launch para rastrear a ID da página no Analytics

As regras permitem rastrear atributos de navegação como ID de página no Analytics.
Repita as etapas na Parte 5b da seção Uso da camada de dados do cliente Adobe para integrar os componentes principais e o documento do Adobe Launch para adicionar a seguinte regra no Adobe Launch:
  • Nome : track-dl-page-id
  • EVENTOS:
    • Extensão : Núcleo
    • Tipo de evento : Final da página
  • AÇÃO 1:
    • Extensão : Adobe Analytics
    • Tipo de ação: Definir variáveis
    • prop1 : %dl-page-id%
  • AÇÃO 2:
    • Extensão : Adobe Analytics
    • Tipo de ação: Enviar beacon
    • Verifique s.t(): Enviar dados para o Adobe Analytics e tratá-los como uma visualização de página

Etapa 7 - Criar uma regra no Adobe Launch para registrar o Evento Image Click

As regras permitem rastrear atributos de navegação como eventos de clique no Analytics.
Repita as etapas na Parte 5b da seção Uso da camada de dados do cliente Adobe para integrar os componentes principais e o documento do Adobe Launch para adicionar a seguinte regra no Adobe Launch:
  • Nome : register-dl-image-click
  • EVENTOS:
    • Extensão : Núcleo
    • Tipo de evento : Final da página
  • AÇÃO 1:
    • Extensão : Núcleo
    • Tipo de ação: Código personalizado
    • Editor: Digite o seguinte código
      var myListener = function(event) {
        _satellite.track('dlImageClicked', event.info.path);
      };
      adobeDataLayer.addEventListener('image clicked', myListener());
      
      

Etapa 8 - Criar uma regra no Adobe Launch para rastrear o Evento Image Click no Analytics

As regras permitem rastrear atributos de navegação como eventos de clique no Analytics.
Repita as etapas na Parte 5b da seção Uso da camada de dados do cliente Adobe para integrar os componentes principais e o documento do Adobe Launch para adicionar a seguinte regra no Adobe Launch:
  • Nome : track-dl-image-click
  • EVENTOS:
    • Extensão : Núcleo
    • Tipo de evento : Chamada direta
    • Identificador : dlImageClicked
  • AÇÃO 1:
    • Extensão : Adobe Analytics
    • Tipo de ação: Definir variáveis
    • prop2 : Definir como %event.detail%
  • AÇÃO 2:
    • Extensão : Adobe Analytics
    • Tipo de ação: Enviar beacon
    • Verifique s.t(): Enviar dados para o Adobe Analytics e tratá-los como uma visualização de página

Etapa 9 - Publicar o código de inicialização em seu site

Para ativar o rastreamento dessas regras e propriedades no Launch, o código deve ser publicado.
  1. Na guia Adobe Launch , selecione a guia Publicação .
  2. Clique em Adicionar nova biblioteca .
  3. Como Nome , insira: data-layer-analytics-1 .
  4. Como Ambiente , selecione Desenvolvimento (desenvolvimento) .
  5. Clique em Adicionar todos os recursos alterados.
  6. Para cada uma das três regras ( track-dl-page-id , register-dl-image-click e track-dl-image-click ):
  7. Selecione Regras -> regra -> Mais recente e clique em Selecionar e criar uma nova revisão .
  8. Clique em Salvar e criar para desenvolvimento .

Etapa 10 - Acione sua página para enviar informações ao Adobe Analytics

Nesta etapa, você instalará o Chrome extension Launch e o DTM Switch . Com essa extensão, você só precisa criar e implantar o código do Launch no ambiente de desenvolvimento. Não há necessidade de implantar os ambientes de armazenamento temporário e de produção.
  1. Instale o Chrome extension Launch e o DTM Switch da Discovery.
  2. Clique no ícone Iniciar Switch e defina a Depuração como ON .
  3. Recarregar página http://<host>:<port>/content/core-components-examples/library/image.html .
  4. Abra o console do navegador e você deve ver algo semelhante ao seguinte.
Você também pode instalar a extensão do Experience Cloud Debugger para Chrome para visualização de informações específicas do Adobe Launch e Analytics sobre a página.

Etapa 11 - Visualização das informações rastreadas no Adobe Analytics

Agora você pode visualização os eventos acionados no Adobe Analytics.
  1. Ir para https://analytics.adobe.com .
  2. Faça logon usando sua Adobe ID.
  3. Clique no ícone Analytics .
  4. Select the Reports tab.
  5. Na lista suspensa na parte superior direita, selecione o conjunto de relatórios criado na etapa 1.
  6. Na primeira coluna, selecione Tráfego personalizado -> Tráfego personalizado 1-10 -> Insight personalizado 1 para visualização das IDs de página rastreadas (caminhos) armazenadas na Camada de dados. Deve ser semelhante ao seguinte.
  7. Acesse o Custom Insight 2 para visualização dos caminhos de imagem rastreados armazenados na Camada de dados. Deve ser semelhante ao seguinte.