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:

  • No ambiente de publicação:

    • Relatórios sobre a comunidade tendências
    • Permitir que visitantes do site classifiquem por "mais visualizados", "mais ativos", "mais curtidos"
    • Exibir contagens em listas UGC (Conteúdo gerado pelo usuário)
  • No ambiente de criação:

    • Exibição dos dados de participação no console de gerenciamento de membros (visualizações, publicações, seguidores, curtidas)
    • Resumo de tendências, heartbeat de vídeo e dispositivo de vídeo para obter recursos de ativação relatórios

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:

  1. Replicar a chave de criptografia para garantir que a criptografia/descriptografia ocorra corretamente em todas as instâncias do AEM

  2. Preparar uma Adobe Analytics conjunto de relatórios

  3. Criar uma análise de AEM Cloud Service e estrutura

  4. Ativar o Analytics para um site da comunidade

  5. Verificar Mapeamento de variáveis do Analytics para o AEM

  6. Identificar editor principal

  7. Publish o site da comunidade

  8. Configurar importação de dados do relatório do Adobe Analytics para o site da comunidade

Pré-requisitos prerequisites

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

  • Nome da empresa

    A empresa associada à conta do Adobe Analytics.

  • Nome de usuário

    O nome de usuário de logon do usuário autorizado a gerenciar a conta do Analytics (deve incluir privilégios de Acesso ao serviço da Web).

  • Senha

    A senha de logon do usuário autorizado.

  • Centro de dados do Analytics

    A URL do data center do Analytics para a conta.

  • Conjunto de relatórios

    O nome do conjunto de relatórios do Analytics que será usado.

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

Uso do Adobe Experience Cloud Gerenciador de conjunto de relatórios, 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 do Communities.

Ao fazer logon 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:

  • 11 Variáveis de conversão (eVars)

    • evar1 até evar11 habilitado

    • Pode redefinir (renomear) eVars existentes ou criar outras para usar nos recursos das comunidades

  • 7 eventos bem-sucedidos (eventos)

    • event1 até event7 habilitado

    • tipo Counter

      • não Counter (no subrelations)
    • Pode redefinir (renomear) eventos existentes ou criar eventos para usar nos recursos das Comunidades

  • Gerenciamento de vídeo

    • Console de relatório de vídeo

      • Ativar Video Core
      • Selecione Salvar
    • Console de medição do vídeo principal

      • Selecione Use Solution Variables
      • Selecione Salvar

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

Se estiver usando um conjunto de relatórios existente, pode ser 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.

CAUTION
Se estiver usando um conjunto de relatórios existente que já usa variáveis no
  • evar1 a evar11

  • event1 a event7

Antes de o site da comunidade ser publicado, é importante restaurar o mapeamento pré-existente movendo as variáveis do AEM que foram mapeadas automaticamente para as variáveis do Analytics quando o Analytics foi ativado para um site da comunidade.
Para restaurar o mapeamento pré-existente e mover variáveis de AEM para outras variáveis do Analytics, consulte a seção sobre Modificação do mapeamento de variáveis do Analytics.
Se isso não for feito, poderá ocorrer perda irrecuperável de dados.

Video Heartbeat Analytics video-heartbeat-analytics

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

Para ativar os relatórios do Video Heartbeat após configuração do conjunto de relatórios do Analytics para relatórios de vídeo:

A variável Marketing Cloud Org Id pode ser inscrito no momento da criação de site da comunidade ou posteriormente por modificação as propriedades do site da comunidade.

marketing-org-id

Quando o Video Heartbeat Analytics está ativado, o código JavaScript (JS) do 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:

  • Na navegação global: Ferramentas > Implantação > Cloud Service
  • Role para baixo até Adobe Analytics
  • Selecionar Configurar agora ou Exibir configurações

cloud-config

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

  • Selecionar [+] ícone ao lado de Configurações disponíveis para que você possa criar uma configuração.

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

create-cloud-config

  • Título

    (Obrigatório) Um título de exibição para a configuração.
    Por exemplo, insira Análise da comunidade

  • Nome

    (Opcional) Se não for especificado, o nome assumirá como padrão um nome de nó válido derivado do título.
    Por exemplo, insira comunidades

  • Modelo

    Selecione Adobe Analytics Configuration

  • Selecione Criar

    • Inicia a página de configuração e abre Analytics Settings caixa de diálogo

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. Essa caixa de diálogo requer o informações da conta de pré-requisito obtido junto do representante de conta.

analytics-settings

  • Empresa

    A empresa associada à conta do Adobe Analytics.

  • Nome de usuário

    O nome de usuário de logon do usuário autorizado a gerenciar a conta do Analytics.

  • Senha

    A senha de logon do usuário autorizado.

  • Centro de dados

    Selecione o data center do Analytics que hospeda o conjunto de relatórios.

  • Não adicionar a tag de rastreamento à página

    Deixar como padrão (desmarcado).

  • Usar AppMeasurement

    Deixar como padrão (desmarcado).

  • Não realizar importações de impressões de página todas as noites (autor)

    Deixar como padrão (desmarcado).

  • Não realizar importações de impressões de página todas as noites (publicar)

    Deixar como padrão (desmarcado).

Para salvar as configurações:

  • Selecionar Conectar-se ao Analytics

    • Se não for bem-sucedido,

      • Verifique se as entradas não contêm espaços à esquerda.
      • Experimente um data center diferente.
  • Selecionar OK.

    analytics-settings

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).

  • Selecionar [+] ícone ao lado de Estruturas disponíveis para que você possa criar uma estrutura.

    analytics-framework

  • Título

    (Obrigatório) Um título de exibição para a estrutura. Por exemplo, insira Quadro comunitário.

  • Nome

    (Opcional) Se não for especificado, o nome assumirá como padrão um nome de nó válido derivado do título.
    Por exemplo, insira comunidades.

  • Modelo

    Selecione Adobe Analytics Framework.

  • Selecione Criar.

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 definido no conjunto de relatórios.

analytics-framework

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 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

report-suite

  1. Selecionar Adicionar item +.

    Duas caixas suspensas são exibidas.

  2. Escolha um Report suite.

    Os conjuntos de relatórios associados à Conta da empresa estão disponíveis para seleção.

  3. Selecionar Sim na caixa de diálogo que é aberta:

    code language-none
    Load default server settings?
     Do you want to load the default server settings and overwrite current values in the Server section?
    
  4. Escolha um Run Mode.

  5. Selecionar Publish.

analytics-framework2

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 enquanto criação de um site da comunidade:

  • Na etapa 3, sob o Guia ANALYTICS:

    • Selecione o Ativar o Analytics caixa de seleção
    • Selecione a estrutura na caixa suspensa.
  • Opcionalmente, retorne à configuração da estrutura do Analytics para ajustar os mapeamentos da variável.

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

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

  • Navegue até a Comunidades > Sites console.

  • Selecione o ícone Editar site da comunidade.

  • Selecione as CONFIGURAÇÕES.

  • Na seção Analytics:

    • Selecione o Ativar o Analytics caixa de seleção
    • Escolha a estrutura na caixa suspensa.
  • Opcionalmente, retorne à configuração da estrutura do Analytics para ajustar os mapeamentos da variável.

Ativar para sites personalizados enable-for-customized-sites

Para que o rastreamento e a importação do Analytics funcionem corretamente em um site da comunidade, um elemento de página com a scf-js-site-title os atributos class e href devem estar presentes. Apenas um desses elementos deve existir na página, como ocorre em um sitepage.hbs script para um site da comunidade. O valor de siteUrl é extraído e enviado para o Adobe Analytics como a 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 personalizado da comunidade que se sobrepõe ao 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 genérico de AEM que inclui componentes do Communities, mas não é criada com o assistente de criação de site, é 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.

O ambiente do autor Configuração OSGi, AEM Communities Analytics Component Configuration, 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

component-configuration1

NOTE
Os componentes do journal são usados para implementar o recurso de blog.

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 existente que mapeou qualquer uma das variáveis de evar1 a evar11 e de event1 a event7, será necessário remapear as variáveis AEM e restaure o mapeamento original.

Veja a seguir um exemplo de mapeamentos padrão:

map-analytics

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

Ativação
Recurso
Tipo
Site
Título
Função
Tipo
Grupo
Título
Grupo
Caminho
UGC
Tipo
UGC
Título
Usuário
(Membro)
UGC
Caminho
Site
Caminho
eVar1
eVar2
eVar3
eVar4
eVar5
eVar6
eVar7
eVar8
eVar9
eVar10
event1
Reprodução do recurso
(a)
-
-
-
-
-
-
-
i)
-
event2
SCFView
(a)
(b)
(c)
(d)
(e)
f)
(g)
(h)
i)
j)
event3
SCFCreate (Pós)
-
(b)
(c)
(d)
(e)
f)
(g)
(h)
i)
j)
event4
SCFFollow
-
(b)
(c)
(d)
(e)
f)
(g)
(h)
i)
j)
event5
SCFVoteUp
-
(b)
(c)
(d)
(e)
f)
(g)
(h)
i)
j)
evento6
SCFVoteDown
-
(b)
(c)
(d)
(e)
f)
(g)
(h)
i)
j)
event7
SCFRate
-
(b)
(c)
(d)
(e)
f)
(g)
(h)
i)
j)

Exemplos para valores de eVar:

  • Tipo MIME: video/mp4

  • título do site da comunidade: Comunidades do Geometrixx

  • nome da função da comunidade: Fórum

  • nome do grupo da comunidade: Caminhada

  • caminho para o conteúdo do grupo da comunidade: /content/sites/<site name>/en/groups/hiking

  • ResourceType do componente UGC: social/forum/components/hbs/topic

  • Título do componente UGC: Tópicos sobre caminhada

  • logon (authorizableId): aaron.mcdonald@mailinator.com

  • Caminho SRP para UGC: /content/usergenerated/asi/.../forum/jmtz-topic3
    ou caminho do componente a seguir: /content/sites/<site name>/en/jcr:content/content/primary/forum

  • caminho para o conteúdo do site da comunidade: /content/sites/<site name>/en

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.

CAUTION
É importante remapear antes que o site da comunidade seja publicado com o Analytics ativado, há o risco de perda de dados.

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

analytics-mapping-evar

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

analytics-mapping-evar1

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

analytics-mapping-evar2

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:

CAUTION
Se estiver usando um conjunto de relatórios existente que já usa variáveis no
  • evar1 a evar11

  • event1 a event7

Antes de o site da comunidade ser publicado, restaure o mapeamento pré-existente. Mova as variáveis AEM das comunidades que foram mapeadas automaticamente (quando o Analytics foi habilitado para o site da comunidade) para outras variáveis do Analytics. Esse remapeamento deve ser consistente em todos os componentes das Comunidades.
Se isso não for feito, poderá ocorrer perda irrecuperável de dados.

Editor primário primary-publisher

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

Por padrão, a variável AEM Communities Publisher Configuration A configuração OSGi 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 o principal.

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

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

CAUTION
É importante que o editor principal seja configurado para impedir a pesquisa de várias instâncias de publicação.

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.

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

Depois que o serviço do Analytics Cloud for ativado para um site da comunidade e, se necessário, o O mapeamento do Analytics para variáveis AEM é ajustado, replicar a configuração no ambiente de publicação utilizando (re)publicar o site da comunidade.

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

Gerenciamento de Relatórios report-management

O autor e o editor principal Configuração OSGi, AEM Communities Analytics Report Management, é usado 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 da comunidade habilitado para o Analytics for publicado, o editor principal Configuração OSGi, AEM Communities Analytics Report Importer, pode ser configurado para definir o intervalo de pesquisa padrão para as configurações que não são configuradas individualmente no CRXDE.

O intervalo de pesquisa controla a frequência de solicitações à Adobe Analytics para que os dados sejam obtidos 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.

A pesquisa padrão Intervalo de importação está definido como 12 horas.

importador de relatórios

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:

  • No editor principal, faça logon com privilégios administrativos.

  • Navegue até CRXDE Lite. Por exemplo, https://localhost:4503/crx/de.

  • No jcr:content nó da raiz de idioma (por exemplo, /content/sites/engage/en/jcr:content), navegue até o componente configurado para os relatórios do Analytics.
    Por exemplo, analytics/reportConfigs/social_forum_components_hbs_topic

  • Observe os períodos de tempo criados:

    • last30Days
    • last90Days
    • thisYear
  • Observe a totalnó.

    • Modificação da interval A propriedade substitui o intervalo do Importador de relatórios.
    • O valor é em segundos e é definido como quatro horas (14400 segundos).

component-report

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 de exclusão.

Recursos resources

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791