Show Menu
TOPICS×

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.