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

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Visão geral overview

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

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

Por exemplo, quando um membro de um site da comunidade de ativação exibir um recurso de vídeo atribuído a ele, o reprodutor de recursos enviará eventos para o Analytics, incluindo dados de pulsação de vídeo. No site da comunidade, os administradores podem visualizar vários relatórios sobre a reprodução do vídeo.

Além disso, o analytics é necessário para:

  • No ambiente de publicação:

    • Relatórios sobre a comunidade tendências
    • Permitir que os visitantes do site classifiquem por "mais visualizados", "mais ativos", "mais curtidos"
    • Exibir contagens em listas UGC
  • No ambiente de criação:

    • Exibição dos dados de participação no console de gerenciamento de membros (visualizações, postagens, seguidores, curtidas)
    • Resumo de tendências, pulsação de vídeo e dispositivo de vídeo para ativar o recurso relatórios

Os recursos suportados das Comunidades 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 AEM
  2. Preparar uma Adobe Analytics conjunto de relatórios
  3. Criar um AEM Analytics serviço na nuvem e estrutura
  4. Ativar o Analytics para um site da comunidade
  5. Verificar Análise para mapeamento AEM variável
  6. Identificar editor principal
  7. Publicar o site da comunidade
  8. Configurar importação de dados de 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, devem estar disponíveis as seguintes informações:

  • Nome da empresa

    A empresa associada à conta da 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

  • Data Center do Analytics

    O URL do data center do Analytics para a conta

  • Conjunto de relatórios

    O nome do conjunto de relatórios do Analytics a ser usado

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

Usar o Gerenciador do 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 das Comunidades.

Ao fazer logon em Adobe Marketing 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 through evar11 ativado
    • Pode redefinir (renomear) evars existentes ou criar novas para usar nos recursos das Comunidades
  • 7 Eventos bem-sucedidos (events)

    • event1 through event7 ativado

    • Tipo Counter

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

  • Gerenciamento de vídeo

    • Console de relatórios de vídeo

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

      • Selecionar Use Solution Variables
      • Selecione Salvar

Se estiver usando um novo conjunto de relatórios, esteja ciente de que 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 Comunidades.

Se estiver usando um conjunto de relatórios existente, pode ser necessário modificar o mapeamento de variável antes de ativar a estrutura do Analytics para um site da comunidade. Entre em contato com o 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
Em seguida, antes de o site da comunidade ser publicado, é importante restaurar o mapeamento preexistente movendo as variáveis de 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 AEM variáveis para outras variáveis do Analytics, consulte a seção em Modificação do mapeamento de variável do Analytics.
Se isso não for feito, poderá ocorrer perda irrecuperável de dados.

Análise do Video Heartbeat video-heartbeat-analytics

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

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

O Marketing Cloud Org Id podem ser inseridas no momento da criação de site da comunidade ou mais tarde modificação as propriedades do site da comunidade. 🔗

chlimage_1-264

Quando a Análise do Video Heartbeat está ativada, o código Javascript (JS) do reprodutor de vídeo instancia o código da biblioteca do Video Heartbeat (também no JS), que lida com toda a lógica para enviar atualizações de status de vídeo aos servidores de rastreamento de vídeo do Analytics a cada 10 segundos (não configurável) e, eventualmente, enviar um relatório cumulativo da sessão de vídeo para os principais servidores do Analytics.

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

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

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

  • Na navegação global: Ferramentas > Implantação > Cloud Services
  • Role para baixo até Adobe Analytics
  • Selecione um Configurar agora ou Mostrar configurações

chlimage_1-265

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

  • Selecionar [+] ícone ao lado de Configurações disponíveis para criar uma nova configuração

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

chlimage_1-266

  • Título

    (Obrigatório) Um título de exibição para a configuração.

    Por exemplo, insira Ativar o Community Analytics

  • Nome

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

    Por exemplo, insira comunidades

  • Modelo

    Selecionar Adobe Analytics Configuration

  • Selecione Criar

    • Inicia a página de configuração e abre Analytics Settings 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 em 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 do representante da conta.

chlimage_1-267

  • Empresa

    A empresa associada à conta da 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)

    Deixe como padrão (marcado)

Para salvar as configurações:

  • Selecionar Conectar-se ao Analytics

    • Se não tiver êxito,

      • Verifique se as entradas não contêm espaços à esquerda
      • Tente um data center diferente
      • Entre em contato com seu representante de conta
  • Selecionar OK

chlimage_1-268

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 as variáveis de recurso (AEM) das Comunidades para variáveis do Analytics (conjunto de relatórios).

  • Selecionar [+] ícone ao lado de Estruturas disponíveis para criar uma nova estrutura

chlimage_1-269

  • Título

    (Obrigatório) Um título de exibição para a estrutura

    Por exemplo, insira Ativação do quadro comunitário

  • Nome

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

    Por exemplo, insira comunidades

  • Modelo

    Selecionar Adobe Analytics Framework

  • Selecione Criar

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

Configuração da estrutura do AEM Analytics aem-analytics-framework-configuration

A finalidade da estrutura é mapear variáveis 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.

chlimage_1-270

Selecionar Conjunto de relatórios select-report-suite

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

Se um conjunto de relatórios ainda não tiver sido criado ou não tiver sido configurado corretamente, consulte a seção anterior:
Relatório do Conjunto de relatórios do Adobe Analytics para 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

chlimage_1-271

  1. Selecionar Adicionar Item + duas caixas suspensas são exibidas
  2. Escolha um Report suite os conjuntos de relatórios associados à conta Empresa devem estar disponíveis para seleção
  3. Selecionar Sim na caixa de diálogo que é aberta: 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
    Choose publicar

chlimage_1-272

O serviço e a estrutura de nuvem do Analytics estão concluídos. Os Mapeamentos serão definidos assim que um site da comunidade for criado 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 de nuvem do Analytics ao criação de um novo site da comunidade:

  • Na etapa 3

  • Em Guia ANALYTICS:

    • Verifique a Ativar o Analytics caixa de seleção
    • Escolha a estrutura na caixa suspensa
  • Como opção, retorne à configuração da estrutura do Analytics para ajustar os mapeamentos de variáveis.

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

Para adicionar o serviço de nuvem do Analytics a um site da comunidade existente:

  • Navegue até o Comunidades > Sites console

  • Selecione o ícone Editar Site do site da comunidade

  • Selecione as CONFIGURAÇÕES

  • Na seção Analytics :

    • Verifique a Ativar o Analytics caixa de seleção
    • Escolha a estrutura na caixa suspensa
  • Como opção, retorne à configuração da estrutura do Analytics para ajustar os mapeamentos de variáveis.

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 variável scf-js-site-title os atributos class e href devem estar presentes. Somente um desses elementos deve existir na página, como ocorre em um elemento não modificado sitepage.hbs script para um site da comunidade. O valor de siteUrl é extraída e enviada para a Adobe Analytics como a variável caminho do site.

# present in default sitepage.hbs

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/br/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=pt-BR).
# only one scf-js-site-title class should be included

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/br/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=pt-BR).
# this example sets it to be hidden as it serves no visual purpose

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/br/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=pt-BR).
<div
    class="navbar-brand scf-js-site-title"
    href="{{siteUrl}}.html"
    style="visibility: hidden;"
>
</div>

Para um site personalizado da comunidade que sobrepõe a variável sitepage.hbs verifique se o elemento está presente. O siteUrlserá definida quando renderizada no servidor antes de servir ao cliente.

Para um site de AEM genérico que inclui componentes do Communities, mas não é criado com o assistente de criação de sites, é necessário adicionar o elemento . O valor da href deve ser o caminho para o site. Por exemplo, se o caminho do site for /content/my/company/en, em seguida 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 do 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 forem criados novos componentes personalizados instrumentados para o Analytics, eles deverão ser adicionados a esta lista de componentes configurados.

Configuração do componente component-configuration

chlimage_1-273

Observação: o journal são usados para implementar o recurso de blog.

Análise mapeada para variáveis de AEM mapped-analytics-to-aem-variables

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

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

Veja a seguir um exemplo de mapeamentos padrão após seguir o tutorial de introdução:

chlimage_1-274

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

Ativar Tipo de Recurso
Título do Site
Tipo de função
Título do grupo
Caminho do grupo
Tipo de UGC
Título do UGC
Usuário (Membro)
Caminho UGC
Caminho do site
eVar1
eVar2
eVar3
eVar4
eVar5
eVar6
eVar7
eVar8
eVar9
eVar10
event1Resource Play
(a)
-
-
-
-
-
-
-
i)
-
event2SCFView
(a)
(b)
©
(d)
e)
f)
g)
(h)
i)
j)
event3SCFCreate (Post)
-
(b)
©
(d)
e)
f)
g)
(h)
i)
j)
event4SCFFollow
-
(b)
©
(d)
e)
f)
g)
(h)
i)
j)
event5SCFVoteUp
-
(b)
©
(d)
e)
f)
g)
(h)
i)
j)
event6SCFVoteDown
-
(b)
©
(d)
e)
f)
g)
(h)
i)
j)
event7SCFRate
-
(b)
©
(d)
e)
f)
g)
(h)
i)
j)

Exemplos de valores de eVar:

  • Tipo MIME: video/mp4
  • Título do site da comunidade: Comunidades Geometrixx
  • Nome da função da comunidade: Fórum
  • Nome do grupo da comunidade: Caminho
  • Caminho para o conteúdo do grupo da comunidade: /content/sites/communities/en/groups/trilha
  • Tipo de recurso do componente UGC: social/fórum/componentes/hbs/tópico
  • Título do componente UGC: Tópicos de rastreamento
  • Logon (ID autorizável): aaron.mcdonald@mailinator.com
  • Caminho SRP para UGC: /content/usergenerated/asi/…/forum/jmtz-topic3 ou caminho do componente a seguir: /content/sites/communities/en/jcr:content/content/primary/forum
  • Caminho para o conteúdo do site da comunidade: /content/sites/community/en

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

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

Depois que o Analytics for ativado e antes que o site da comunidade seja publicado, o mapeamento poderá ser alterado na estrutura, arrastando a eVar ou o evento do Analytics desejado do painel esquerdo e soltando-o na linha relevante na tabela de mapeamento.

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

Se as evars e os eventos do Communities substituírem os mapeamentos que existiam anteriormente no conjunto de relatórios, para evitar perda de dados, atribua as variáveis de AEM para os recursos do Communities a outras evars e/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 da Etapa 1: Arrastar a evar14 do Analytics para a tabela de mapeamento example-step-dragging-analytics-evar-into-mapping-table

chlimage_1-275

Exemplo da Etapa 2: Selecionar 'x' para remover evar11 substituído example-step-selecting-x-to-remove-replaced-evar

chlimage_1-276

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

chlimage_1-277

Publicar o site da comunidade publishing-the-community-site

Verifique o Analytics para AEM o mapeamento de variáveis verify-analytics-to-aem-variable-mapping

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

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
Em seguida, antes de o site da comunidade ser publicado, é importante restaurar o mapeamento preexistente e mover as variáveis de AEM Comunidades que foram mapeadas automaticamente (quando o Analytics foi ativado 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 principal primary-publisher

Quando a implantação escolhida é uma publicar farm, uma instância de publicação de AEM deve ser identificada como o editor principal para a pesquisa do Adobe Analytics para os dados do relatório para gravação em SRP.

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

Portanto, é necessário editar a configuração em todas as instâncias de publicação secundárias para desmarcar a variável Editor principal 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 são criptografadas. Para facilitar a replicação ou a transmissão de credenciais de análise criptografadas entre o autor e os editores, todas as instâncias AEM devem compartilhar a mesma chave de criptografia primária.

Para fazer isso, siga as instruções em Replicar a chave de criptografia.

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

Quando o serviço em nuvem do Analytics tiver sido ativado para um site da comunidade e, se necessário, a variável O mapeamento do Analytics para variáveis de AEM foi ajustado, é necessário replicar a configuração para o ambiente de publicação por (re)publicar o site da comunidade.

Obter relatórios do Analytics obtaining-reports-from-analytics

Gerenciamento de relatórios report-management

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

No autor, as consultas são para relatórios em tempo real.

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

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

Importador de relatórios report-importer

Depois que um site da comunidade habilitado para o Analytics for publicado, o Configuração do OSGi, AEM Communities Analytics Report Importer, pode ser configurado para definir o intervalo de pesquisa padrão para as configurações que não estão configuradas individualmente no CRXDE.

O intervalo de sondagem controla a frequência das solicitações ao Adobe Analytics para que os dados sejam obtidos e salvos em SRP.

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

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

chlimage_1-278

Personalização de relatórios de componentes component-report-customization

Atualmente, para personalizar as métricas para rastrear, os nós são criados no repositório que definem períodos de tempo para os quais gerar um relatório sobre essa métrica.

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

  • No editor principal

  • Fazer logon com privilégios administrativos

  • Navegar para CRXDE Lite

  • Em jcr:content nó da raiz do 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 que total

    • Modificação do interval substituirá o intervalo do Importador de relatórios
    • O valor é em segundos e é definido como 4 horas (14400 segundos)

chlimage_1-279

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
5d37d7b0-a330-461b-814d-068612705ff6