DocumentaçãoAEM 6.5Guia do usuário

Conexão com o Adobe Analytics e criação de estruturas connecting-to-adobe-analytics-and-creating-frameworks

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined

Para rastrear dados da Web de suas páginas AEM no Adobe Analytics, crie uma configuração do Adobe Analytics Cloud Services e uma estrutura do Adobe Analytics:

  • Configuração do Adobe Analytics: as informações sobre sua conta do Adobe Analytics. A configuração do Adobe Analytics permite que o AEM se conecte ao Adobe Analytics. Crie uma configuração do Adobe Analytics para cada conta que você usar.
  • Adobe Analytics Framework: um conjunto de mapeamentos entre as propriedades do conjunto de relatórios do Adobe Analytics e as variáveis CQ. Use uma estrutura para configurar como os dados do site preenchem os relatórios do Adobe Analytics. As estruturas são associadas a uma configuração do Adobe Analytics. É possível criar várias estruturas para cada configuração.

Quando você associa uma página da Web a uma estrutura, a estrutura executa o rastreamento para essa página e seus descendentes. As exibições de página podem ser recuperadas do Adobe Analytics e exibidas no console Sites.

Pré-requisitos prerequisites

Conta do Adobe Analytics adobe-analytics-account

Para rastrear dados do AEM no Adobe Analytics, é necessário ter uma conta válida do Adobe Experience Cloud Adobe Analytics.

A conta do Adobe Analytics deve:

  • Tem privilégios de Administrador
  • Ser atribuído ao grupo de usuários Acesso ao serviço da Web.
CAUTION
Fornecer privilégios de Administrador (no Adobe Analytics) não é suficiente para permitir que um usuário se conecte do AEM ao Adobe Analytics. A conta também deve ter privilégios de Acesso ao Serviço da Web.

chlimage_1-67

Antes de continuar, verifique se suas credenciais permitem fazer logon no Adobe Analytics. Por uma das seguintes formas:

Configuração do AEM para usar seus data centers da Adobe Analytics configuring-aem-to-use-your-adobe-analytics-data-centers

Os data centers da Adobe Analytics coletam, processam e armazenam dados associados ao conjunto de relatórios do Adobe Analytics. Configure o AEM para usar o data center que hospeda o conjunto de relatórios do Adobe Analytics. O data center é mencionado em seu contrato. Entre em contato com um administrador em sua organização para obter essas informações.

Se necessário, use o seguinte para ser roteado para o data center correto: https://api.omniture.com/.

Se sua empresa exigir a coleta ou a recuperação de dados de um data center específico, use o seguinte:

Centro de dados
URL
Londres
https://api3.omniture.com/
Singapura
https://api4.omniture.com/
Oregon
https://api5.omniture.com/

Use o Console da Web para configurar o pacote OSGi Cliente HTTP do Adobe AEM Analytics. Adicione a URL do data center para o data center que hospeda um conjunto de relatórios para o qual suas páginas AEM coletam dados.

aa-07

  1. Abra o console Web no navegador da Web. (https://localhost:4502/system/console/configMgr)

  2. Para acessar o console, digite suas credenciais.

    note note
    NOTE
    Para saber se você tem acesso a esse console, entre em contato com o administrador do site.

  3. Selecione o item de Configuração denominado Adobe AEM Analytics HTTP Client.

  4. Para adicionar a URL de um data center, pressione o botão + ao lado da lista URLs do data center e digite a URL na caixa.

  5. Para remover um URL da lista, clique no botão - ao lado do URL.

  6. Clique em Salvar.

Configuração da conexão com o Adobe Analytics configuring-the-connection-to-adobe-analytics

CAUTION
Devido a alterações de segurança na API do Adobe Analytics, não é mais possível usar a versão do Activity Map incluída no AEM.
O plug-in ActivityMap fornecido pelo Adobe Analytics agora deve ser usado.

Configuração do para o Activity Map configuring-for-the-activity-map

CAUTION
Devido a alterações de segurança na API do Adobe Analytics, não é mais possível usar a versão do Activity Map incluída no AEM.
O plug-in ActivityMap fornecido pelo Adobe Analytics agora deve ser usado.

Criação de uma estrutura do Adobe Analytics creating-a-adobe-analytics-framework

Para a ID do conjunto de relatórios (RSID) que você está usando, é possível controlar quais instâncias do servidor (autor, publicação ou ambas) contribuem com dados para o conjunto de relatórios:

  • Todos: as informações do autor e da instância de publicação preenchem o Conjunto de relatórios.
  • Autor: somente as informações da instância do autor preenchem o Conjunto de relatórios.
  • Publish: somente as informações da instância de publicação preenchem o Conjunto de relatórios.
NOTE
A seleção do tipo de instância do servidor não restringe chamadas para o Adobe Analytics, apenas controla quais chamadas incluem o RSID.
Por exemplo, uma estrutura está configurada para usar o conjunto de relatórios diweretail e o autor é a instância de servidor selecionada. Quando as páginas são publicadas junto com a estrutura, as chamadas ainda são feitas para o Adobe Analytics, no entanto, essas chamadas não contêm a RSID. Somente as chamadas da instância do autor incluem a RSID.

  1. Usando a Navegação, selecione Ferramentas, Cloud Service e Cloud Service herdados.

  2. Role até Adobe Analytics e selecione Mostrar configurações.

  3. Clique no link [+] ao lado da sua configuração do Adobe Analytics.

  4. Na caixa de diálogo Criar Estrutura:

    • Especifica um Título.
    • Opcionalmente, você pode especificar o Nome para o nó que armazena os detalhes da estrutura no repositório.
    • Selecione o Adobe Analytics Framework

    E clique em Criar.

    A estrutura é aberta para edição.

  5. Na seção Conjuntos de relatórios do pod lateral (lado direito do painel principal), clique em Adicionar item. Em seguida, use o menu suspenso para selecionar a ID do conjunto de relatórios (por exemplo, geometrixxauth) com a qual a estrutura interage.

    note note
    NOTE
    O localizador de conteúdo à esquerda é preenchido com variáveis do Adobe Analytics (Variáveis do SiteCatalyst) ao selecionar uma ID de conjunto de relatórios.

  6. Para selecionar as instâncias do servidor para enviar informações ao Conjunto de relatórios, use o menu suspenso Modo de execução (ao lado da ID do Conjunto de relatórios).

    aa-framework-01

  7. Para disponibilizar a estrutura na instância de publicação do seu site, na guia Página do sidekick, clique em Ativar Estrutura.

Definição das configurações de servidor para o Adobe Analytics configuring-server-settings-for-adobe-analytics

O sistema de estrutura permite alterar as configurações do servidor em cada estrutura do Adobe Analytics.

CAUTION
Essas configurações determinam para onde seus dados são enviados e como, portanto, é fundamental que você não altere essas configurações e permita que seu representante da Adobe Analytics as configure.

Comece abrindo o painel. Pressione a seta para baixo ao lado de Servidores:

servidor_001

  • Servidor de Acompanhamento

    • contém o URL usado para enviar chamadas do Adobe Analytics

      • cname - o padrão é o Nome da empresa da conta da Adobe Analytics
      • d1 - corresponde ao data center para o qual as informações são enviadas (d1, d2 ou d3)
      • sc.omtrdc.net - nome de domínio

  • Servidor de Rastreamento Seguro

    • Tem os mesmos segmentos que o servidor de rastreamento
    • Usado para enviar dados de páginas seguras (https://)

  • Namespace do visitante

    • O namespace determina a primeira parte do URL de rastreamento.
    • Por exemplo, alterar o namespace para CNAME faz com que as chamadas feitas para o Adobe Analytics se pareçam com CNAME.d1.omtrdc.net em vez do padrão.

Associar uma página a uma estrutura do Adobe Analytics associating-a-page-with-a-adobe-analytics-framework

Quando uma página é associada a uma estrutura do Adobe Analytics, a página envia dados para o Adobe Analytics quando a página é carregada. As variáveis que a página preenche são mapeadas e recuperadas das variáveis do Adobe Analytics na estrutura. Por exemplo, as exibições de página são recuperadas do Adobe Analytics.

Os descendentes da página herdam a associação com a estrutura. Por exemplo, ao associar a página raiz do site a uma estrutura, todas as páginas do site são associadas à estrutura.

  1. No console Sites, selecione a página que deseja configurar com rastreamento.

  2. Abra as Propriedades da Página, diretamente do console ou do editor de páginas.

  3. Abra a guia ​ Cloud Service.

  4. Use o menu suspenso Adicionar configuração para selecionar Adobe Analytics entre as opções disponíveis. Se a herança for colocada, desative-a antes que o seletor fique disponível.

  5. O seletor suspenso de Adobe Analytics está anexado às opções disponíveis. Selecione a configuração de estrutura necessária.

  6. Selecione Salvar e fechar.

  7. Para ativar a página e quaisquer configurações/arquivos conectados, Publish a página.

  8. A etapa final é visitar a página na instância de publicação e procurar uma palavra-chave (por exemplo, berinjela) usando o componente Pesquisa.

  9. Você pode verificar as chamadas feitas ao Adobe Analytics usando uma ferramenta apropriada; por exemplo, Adobe Experience Cloud Debugger.

  10. Usando o exemplo fornecido, a chamada deve conter o valor inserido (ou seja, berinjela) em eVar7 e a lista de eventos deve conter event3.

Visualizações de página page-views

Quando uma página é associada a uma estrutura do Adobe Analytics, o número de exibições de página pode ser mostrado na exibição em Lista do console Sites.

Consulte Vendo dados de análise da página para obter mais detalhes.

Configuração do intervalo de importação configuring-the-import-interval

Configure a instância apropriada do serviço Adobe AEM Analytics Report Sling Importer:

  • Tentativas de busca:
    Número de tentativas de buscar um relatório na fila.
    O padrão é 6.

  • Atraso de busca:
    O número de milissegundos entre tentativas de buscar um relatório na fila.
    O padrão é 10000. Como está em milissegundos, corresponde a 10 segundos.

  • Frequência de busca:
    Uma expressão cron para determinar a frequência de busca do Relatório do Analytics.
    O padrão é 0 0 0/12 * * ?; isso corresponde a 12 buscas a cada hora.

Para configurar esse serviço OSGi, você pode usar o Console da Web ou um nó osgiConfig no repositório (o PID do serviço é com.day.cq.analytics.sitecatalyst.impl.importer.ReportImporterScheduler).

Editar configurações e/ou estruturas do Adobe Analytics editing-adobe-analytics-configurations-and-or-frameworks

Como ocorre ao criar uma configuração ou estrutura do Adobe Analytics, navegue até a tela Cloud Service (herdada). Selecione Mostrar configurações e clique no link da configuração específica que deseja atualizar.

Ao editar uma configuração do Adobe Analytics, pressione Editar quando estiver na própria página de configuração para abrir a caixa de diálogo Editar Componente.

Exclusão de estruturas Adobe Analytics deleting-adobe-analytics-frameworks

Para excluir uma estrutura Adobe Analytics, primeiro abra-a para edição.

Em seguida, selecione Excluir Framework na guia Page do sidekick.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2