Configuração do Analytics para recursos das comunidades analytics-configuration-for-communities-features

Visão geral overview

O Adobe Analytics e o Adobe Experience Manager (AEM) são soluções da Adobe Experience Cloud.

O Adobe Analytics pode ser configurado para o AEM Communities de forma que, à medida que um membro interage com os recursos compatíveis do Communities, os eventos sejam enviados para o Adobe Analytics a partir do qual os relatórios são gerados.

Por exemplo, no site da comunidade, os administradores podem ver vários relatórios sobre a reprodução do vídeo.

Além disso, a análise é necessária para:

Os recursos compatíveis do Communities incluem:

Esta seção da documentação descreve como conectar um conjunto de relatórios do Analytics com recursos das Comunidades. As etapas básicas são:

Pré-requisitos prerequisites

Para configurar os recursos do Analytics for Communities, é necessário trabalhar com seu representante de conta para configurar uma conta da Adobe Analytics e um conjunto de relatórios. Uma vez estabelecidas, as seguintes informações devem estar disponíveis:

Conjunto de relatórios Adobe Analytics para relatórios de vídeo adobe-analytics-report-suite-for-video-reporting

Usando o Gerenciador de conjunto de relatórios da Adobe Experience Cloud, os conjuntos de relatórios do Analytics podem ser configurados para que um site da comunidade possa ser habilitado para fornecer relatórios para os recursos das Comunidades.

Ao entrar no Adobe Experience Cloud com Nome da Empresa e Nome de Usuário, é possível configurar um conjunto de relatórios novo ou existente para ter:

Se estiver usando um novo conjunto de relatórios, um novo conjunto de relatórios poderá ter apenas 4 evars e 6 variáveis de evento, enquanto 11 evars e 7 vars de evento serão necessários para as Comunidades.

Se estiver usando um conjunto de relatórios existente, talvez seja necessário modificar o mapeamento de variáveis antes de ativar a estrutura do Analytics para um site da comunidade.

Entre em contato com seu representante de conta para obter informações sobre as variáveis dedicadas às Comunidades.

Video Heartbeat Analytics video-heartbeat-analytics

Quando o Video Heartbeat Analytics é licenciado, um Marketing Cloud Org Id é atribuído.

Para habilitar os relatórios de Pulsação de vídeo após configurar o conjunto de relatórios do Analytics para relatórios de vídeo:

O Marketing Cloud Org Id pode ser inserido no momento da criação do site da comunidade ou posteriormente por modificação das propriedades do site da comunidade.

Quando o Video Heartbeat Analytics está ativado, o código do JavaScript (JS) para o reprodutor de vídeo instancia o código da biblioteca de heartbeat de vídeo (também em JS). O código lida com toda a lógica de envio de atualizações de status de vídeo aos servidores de rastreamento de vídeo do Analytics a cada 10 segundos (não configurável). Ele eventualmente envia um relatório cumulativo da sessão de vídeo para os principais servidores do Analytics.

Se não estiver ativado, o código de heartbeat de vídeo nunca será instanciado e somente o progresso do vídeo e o rastreamento da retomada da posição serão mantidos no SRP para os relatórios.

Configuração do serviço AEM Analytics Cloud aem-analytics-cloud-service-configuration

Para criar uma Integração do Analytics, que integra o Adobe Analytics ao site da comunidade AEM, usando a interface padrão na instância do autor:

Caixa de diálogo Criar configuração create-configuration-dialog

Na caixa de diálogo Criar configuração, os valores a serem inseridos identificam a configuração.

Caixa de diálogo Configurações do Analytics analytics-settings-dialog

A criação inicial de uma nova configuração do Analytics resulta na exibição da configuração e de uma nova caixa de diálogo para a entrada das Configurações do Analytics. Esta caixa de diálogo requer as informações de conta de pré-requisito obtidas do representante de conta.

Para salvar as configurações:

Criar estrutura create-framework

Após a configuração bem-sucedida da conexão básica com o Adobe Analytics, é necessário criar ou editar uma estrutura para o site da comunidade. A finalidade da estrutura é mapear variáveis de recurso das Comunidades (AEM) para variáveis do Analytics (conjunto de relatórios).

A criação da Estrutura do Analytics abre a estrutura para configuração.

Configuração de estrutura analítica do AEM aem-analytics-framework-configuration

A finalidade da estrutura é mapear variáveis do AEM para variáveis do Analytics (eVars e eventos). As variáveis do Analytics disponíveis para mapeamento são definidas no conjunto de relatórios.

Selecionar conjunto de relatórios select-report-suite

Selecione o conjunto de relatórios que foi configurado para o relatório de vídeo.

Se um conjunto de relatórios ainda não tiver sido criado ou configurado incorretamente, consulte a seção anterior:
Conjunto de relatórios do Adobe Analytics para relatórios de vídeo

O Sidekick não é necessário e pode ser minimizado para que não obstrua o acesso às configurações dos Conjuntos de relatórios.

Caixa de diálogo Conjuntos de relatórios antes e depois de selecionar "Adicionar item" report-suites-dialog-before-and-after-selecting-add-item

O Analytics Cloud Service e a estrutura agora estão concluídos. Os Mapeamentos são definidos após a criação de um site da comunidade com este serviço do Analytics ativado.

Ativar o Analytics para um site da comunidade enable-analytics-for-a-community-site

Ativar para novo site da comunidade enable-for-new-community-site

Para adicionar o serviço Analytics Cloud ao criar um site da comunidade:

Ativar para site da comunidade existente enable-for-existing-community-site

Para adicionar o serviço Analytics Cloud a um site da comunidade existente:

Ativar para sites personalizados enable-for-customized-sites

Para que o rastreamento e a importação do Analytics funcionem corretamente para um site da comunidade, um elemento de página com a classe scf-js-site-title e os atributos href devem estar presentes. Apenas um desses elementos deve existir na página, como em um script sitepage.hbs não modificado para um site da comunidade. O valor de siteUrl é extraído e enviado para a Adobe Analytics como o caminho do site.

# present in default sitepage.hbs
# only one scf-js-site-title class should be included
# this example sets it to be hidden as it serves no visual purpose
<div
    class="navbar-brand scf-js-site-title"
    href="{{siteUrl}}.html"
    style="visibility: hidden;"
>
</div>

Para um site de comunidade personalizado que sobrepõe o script sitepage.hbs, verifique se o elemento está presente. A variável siteUrl é definida quando renderizada no servidor antes de servir ao cliente.

Para um site AEM genérico que inclui componentes das Comunidades, mas não é criado com o assistente de criação de sites, é necessário adicionar o elemento. O valor de href deve ser o caminho para o site. Por exemplo, se o caminho do site for /content/my/company/en, use:

<div
    class="navbar-brand scf-js-site-title"
    href="/content/my/company/en.html"
    style="visibility: hidden;"
>
</div>

Recursos do Analytics for Communities analytics-for-communities-features

O Analytics é usado automaticamente para vários recursos das Comunidades.

A configuração OSGi, AEM Communities Analytics Component Configuration do ambiente de autor fornece uma lista dos componentes que foram instrumentados para o Analytics. O mapeamento automático de variáveis é determinado pelos componentes listados.

Se novos componentes personalizados forem criados e instrumentados para o Analytics, eles deverão ser adicionados a esta lista de componentes configurados.

Configuração do componente component-configuration

Mapeamento do Analytics para variáveis AEM mapped-analytics-to-aem-variables

Depois que o site da comunidade é salvo, com o Analytics ativado e a estrutura de configuração da nuvem selecionada, as variáveis AEM são mapeadas automaticamente para as eVars e os eventos do Analytics. Ela começa com evar1 e event1, respectivamente, e é incrementada em 1.

Se estiver usando um conjunto de relatórios que mapeou qualquer uma das variáveis dentro da evar1 até a evar11 e de event1 até event7, será necessário remapear as variáveis de AEM e restaurar o mapeamento original.

Veja a seguir um exemplo de mapeamentos padrão:

Mapa de eVars enviados com cada evento map-of-evars-sent-with-each-event

Exemplos de valores de eVar:

Modificação do mapeamento de variáveis do Analytics modifying-analytics-variable-mapping

O mapeamento de eVars e eventos do Analytics para variáveis AEM é visível na configuração da estrutura depois que o Analytics é ativado para um site da comunidade.

Após a ativação do Analytics e antes da publicação do site da comunidade, o mapeamento pode ser alterado na estrutura. Basta arrastar a eVar ou o evento do Analytics desejado do painel esquerdo e soltá-lo na linha relevante na tabela de mapeamento.

Para evitar mapeamentos duplicados, remova a evar ou o evento do Analytics substituído da linha, passando o mouse sobre ela e selecionando o "X" que aparece à direita do elemento de variável do Analytics.

Se as eVars e os eventos do Communities substituírem os mapeamentos pré-existentes no conjunto de relatórios, para evitar perda de dados, atribua as variáveis AEM dos recursos Communities a outras eVars ou eventos do Analytics e restaure os mapeamentos originais.

Exemplo Etapa 1: arrastar a evar14 do Analytics para a tabela de mapeamento example-step-dragging-analytics-evar-into-mapping-table

Exemplo Etapa 2: seleção de "x" para remover a evar11 substituída example-step-selecting-x-to-remove-replaced-evar

Exemplo: AEM var eventdata.siteId remapeado para Analytics evar14 example-step-aem-var-eventdata-siteid-remapped-to-analytics-evar

Publicação do site da comunidade publishing-the-community-site

Verificar mapeamento de variável do Analytics para o AEM verify-analytics-to-aem-variable-mapping

É recomendável verificar o mapeamento da variável antes de publicar o site da comunidade, que também publica o serviço e a estrutura do Analytics Cloud.

Consulte as seções:

Editor primário primary-publisher

Quando a implantação escolhida for um farm de publicação, uma instância de publicação AEM deverá ser identificada como o publicador principal para sondagem de dados de relatório no Adobe Analytics para gravação em SRP.

Por padrão, a configuração OSGi AEM Communities Publisher Configuration identifica sua instância de publicação como o publicador principal, de modo que todas as instâncias de publicação em um farm de publicação se autoidentificariam como primárias.

Portanto, é necessário editar a configuração em todas as instâncias de publicação secundárias para desmarcar a caixa de seleção Editor primário.

Para obter instruções específicas, consulte a seção do editor principal de Implantando comunidades.

Replicar a chave de criptografia replicate-the-crypto-key

As credenciais do Adobe Analytics estão criptografadas. Para facilitar a replicação ou transmissão de credenciais de análise criptografadas entre o autor e os editores, todas as instâncias de AEM devem compartilhar a mesma chave de criptografia principal.

Para fazer isso, siga as instruções em Replicar a Chave de Criptografia.

Site da comunidade Publish e serviço da Analytics Cloud publish-community-site-and-analytics-cloud-service

Depois que o serviço Analytics Cloud for habilitado para um site da comunidade e, se necessário, o mapeamento do Analytics para variáveis AEM for ajustado, replique a configuração para o ambiente de publicação (re)publicando o site da comunidade.

Obtenção de relatórios do Analytics obtaining-reports-from-analytics

Gerenciamento de Relatórios report-management

A configuração OSGi, AEM Communities Analytics Report Management do autor e do editor principal é usada para consultar o Analytics.

Na criação, as consultas são para relatórios em tempo real.

No editor principal, as consultas são usadas para fornecer informações de preparação para a importação de dados analíticos do Importador de relatórios.

O padrão do intervalo de consulta é de 10 segundos.

Importador de relatórios report-importer

Depois que um site de comunidade habilitado para o Analytics for publicado, a configuração OSGi, AEM Communities Analytics Report Importer, do editor principal poderá ser configurada para definir o intervalo de sondagem padrão para as configurações que não são configuradas individualmente no CRXDE.

O intervalo de sondagem controla a frequência de solicitações à Adobe Analytics para que os dados sejam extraídos e salvos em SRP.

Quando os dados podem ser categorizados como "grandes volumes de dados", as pesquisas mais frequentes podem colocar uma grande carga no site da comunidade.

O Intervalo de importação da sondagem padrão está definido como 12 horas.

Personalização do relatório do componente component-report-customization

Atualmente, para personalizar as métricas a serem rastreadas, são criados nós no repositório que definem períodos para os quais será gerado um relatório sobre essa métrica.

O tópico do fórum é atualmente o único exemplo dessa personalização:

Gerenciar dados do usuário no Analytics manage-user-data-in-analytics

O Adobe Analytics fornece APIs que permitem acessar, exportar e excluir dados do usuário. Para obter mais informações, consulte Enviar solicitações de acesso e exclusão.

Recursos resources