Show Menu
TÓPICOS×

Recursos da configuração Analytics para comunidades

Visão geral

O Adobe Analytics e o Adobe Experience Manager (AEM) são ambas soluções de Adobe Marketing Cloud.
O Adobe Analytics pode ser configurado para AEM Communities para que, à medida que um membro interage com os recursos das Comunidades compatíveis, 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 visualização um recurso de vídeo atribuído a ele, o player de recursos enviará eventos para a Analytics, incluindo dados de pulsação de vídeo. No site da comunidade, os administradores podem ver vários relatórios relacionados à reprodução do vídeo.
Além disso, a análise é necessária para:
  • No ambiente publish:
    • Permitir que os visitantes do site classifiquem por "mais visualizados", "mais ativos", "mais curtidos"
    • Contagem de Visualizações em listas UGC
  • No ambiente do autor:
    • Exibição de dados de participação no console de gerenciamento de membros (visualização, publicações, seguidores, curtidas)
    • Resumo de tendências, pulsação de vídeo e dispositivo de vídeo para ativar relatórios de recursos
Os recursos das Comunidades suportadas incluem:
Esta seção da documentação descreve como conectar um conjunto de relatórios da Analytics com os 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 um conjunto de relatórios da Adobe Analytics
  3. Criar um serviço e uma estrutura de nuvem do AEM Analytics
  4. Habilitar Analytics para um site da comunidade
  5. Verificar o mapeamento de variável do Analytics para o AEM
  6. Identificar editor principal
  7. Publicar o site da comunidade
  8. Configurar a importação de dados de relatório do Adobe Analytics para o site da comunidade

Pré-requisitos

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 estabelecida, devem estar disponíveis as seguintes informações:
  • 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 Analytics
    O URL do centro de dados da Analytics para a conta
  • Conjunto de relatórios
    O nome do conjunto de relatórios da Analytics a ser usado

Adobe Analytics Report Suite para Relatórios de vídeo

Usando o Adobe Marketing Cloud, os conjuntos de relatórios do Analytics Report Suite Manager podem ser configurados para que um site da comunidade seja habilitado para fornecer relatórios sobre os recursos das Comunidades.
Ao fazer logon no Adobe Marketing Cloud com o Nome da Empresa e o Nome do usuário , é possível configurar um conjunto de relatórios novo ou existente para que tenha:
  • 11 Variáveis de conversão (evars)
    • evar1 por meio evar11 ativado
    • Pode reaproveitar (renomear) evars existentes ou criar novas para usar nos recursos das Comunidades
  • 7 Eventos bem-sucedidos (eventos)
    • event1 por meio event7 ativado
    • Tipo Counter
      • not Counter (no subrelations)
    • Pode alterar a finalidade (renomear) dos eventos existentes ou criar novos para usar nos recursos das Comunidades
    • Console de Relatórios de vídeo
      • Ativar Video Core
      • Selecione Salvar
    • Console de avaliação do Video Core
      • 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 e 6 variáveis de evento, enquanto 11 e 7 eventos de vars são necessários para Comunidades.
Se estiver usando um conjunto de relatórios existente, talvez seja necessário modificar o mapeamento de variável 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 quaisquer preocupações relacionadas às variáveis dedicadas às Comunidades.
Se estiver usando um conjunto de relatórios existente que já usa variáveis em
  • evar1 a evar11
  • event1 a event7
Depois, antes de o site da comunidade ser publicado, é importante restaurar o mapeamento preexistente movendo as variáveis AEM que foram mapeadas automaticamente para variáveis Analytics quando o Analytics foi habilitado para um site da comunidade.
Para restaurar o mapeamento pré-existente e mover variáveis 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.

Analytics Video Heartbeat

Quando o Video Heartbeat Analytics está licenciado, um Marketing Cloud Org Id é atribuído.
Para ativar o relatórios Video Heartbeat após configurar o conjunto de relatórios da Analytics para o relatórios de vídeo:
O Marketing Cloud Org Id pode ser inserido no momento da criação do site da comunidade ou posteriormente, modificando as propriedades do site da comunidade. Configuração do Cloud Service do AEM Analytics
Quando o Video Heartbeat Analytics está ativado, o código Javascript (JS) para o player de vídeo instancia o código da biblioteca de pulsação de vídeo (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 da Analytics a cada 10 segundos (não configurável) e, eventualmente, envia um relatório cumulativo da sessão de vídeo aos servidores Analytics principais.
Se não estiver ativado, o código de pulsação de vídeo nunca será instanciado e somente o andamento do vídeo e o rastreamento de posição de retomada serão mantidos no SRP para o relatórios.

Configuração do Cloud Service do AEM Analytics

Para criar uma nova integração do Analytics, que integra o Adobe Analytics ao site da comunidade do AEM, use a interface padrão na instância do autor:
  • Da navegação global: Ferramentas > Implantação > Cloud Service
  • Role para baixo até Adobe Analytics
  • Selecione Configurar agora ou Mostrar configurações

Criar caixa de diálogo de configuração

  • Selecione [+] o í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.
  • Título
    (Obrigatório) Um título de exibição para a configuração.
    Por exemplo, insira a Enablement Community Analytics
  • Nome
    (Opcional) Se não for especificado, o nome assumirá como padrão um nome de nó válido derivado do título.
    For example, enter communities
  • Modelo
    Selecionar Adobe Analytics Configuration
  • Selecione Criar
    • Inicia a página de configuração e abre a caixa de diálogo Analytics Settings

Caixa de diálogo Configurações do Analytics

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 exige as informações de conta de pré-requisito obtidas do representante da conta.
  • 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 centro de dados da 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 (marcado)
Para salvar as configurações:
  • Selecione Conectar ao Analytics
    • Se não for bem-sucedido,
      • 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

Criar estrutura

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 Comunidades (AEM) para variáveis do Analytics (conjunto de relatórios).
  • Selecione [+] o ícone ao lado de Estruturas ​disponíveis para criar uma nova estrutura
  • Título
    (Obrigatório) Um título de exibição para a estrutura
    Por exemplo, digite Ativação da estrutura 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.
    For example, enter communities
  • Modelo
    Selecionar Adobe Analytics Framework
  • Selecione Criar
A criação do Analytics Framework abre a estrutura para configuração.

Configuração do AEM Analytics Framework

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

Selecionar conjunto de relatórios

Selecione o conjunto de relatórios que foi configurado para o relatórios de vídeo.
Se um conjunto de relatórios ainda não foi criado ou não foi configurado corretamente, consulte a seção anterior: Adobe Analytics Report Suite 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 Report Suites.

Caixa de diálogo Conjuntos de relatórios antes e depois de selecionar 'Adicionar item'

  1. Selecione Adicionar item + duas caixas suspensas
  2. Escolha um conjunto de relatórios associado Report suite à conta de Empresa que deve estar disponível para seleção
  3. Selecione 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. Choose a Run Mode Escolher publicar
O serviço e a estrutura da nuvem do Analytics estão concluídos. Os Mapeamentos serão definidos assim que um site da comunidade for criado com este serviço Analytics ativado.

Habilitar Analytics para um site da comunidade

Ativar para Novo Site da Comunidade

Para adicionar o serviço de nuvem da Analytics ao criar um novo site da comunidade:
  • Na etapa 3
  • Na guia ANALYTICS :
    • Marque a caixa de seleção Ativar Analytics
    • 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

Para adicionar o serviço de nuvem da Analytics a um site da comunidade existente:
  • Navegue até o console Comunidades > Sites
  • Selecione o ícone Editar site do site da comunidade
  • Selecione as CONFIGURAÇÕES
  • Na seção Analytics:
    • Marque a caixa de seleção Ativar Analytics
    • 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

Para que o rastreamento e a importação do Analytics funcionem corretamente para um site da comunidade, um elemento de página com os atributos scf-js-site-title class e href deve estar presente. Somente um elemento desse tipo deve existir na página, como ocorre em um script não modificado para um site da comunidade. sitepage.hbs 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 da comunidade personalizado que sobrepõe o sitepage.hbs script, verifique se o elemento está presente. A siteUrl variável será definida quando renderizada no servidor antes de servir ao cliente.
Para um site AEM genérico que inclui componentes de Comunidades, mas não é criado com o assistente de criação de site, é necessário adicionar o elemento. O valor do 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

O Analytics é usado automaticamente para vários recursos das Comunidades.
A configuração OSGi do ambiente autor 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 essa lista de componentes configurados.

Configuração do componente

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

Variáveis mapeadas do Analytics para o AEM

Depois que o site da comunidade for salvo com o Analytics ativado e a estrutura de configuração da nuvem selecionada, as variáveis do AEM serão mapeadas automaticamente para as eVars e eventos do Analytics começando com evar1 e evento1, respectivamente, e aumentando em 1.
Se estiver usando um conjunto de relatórios existente que mapeou qualquer uma das variáveis dentro de evar1 até evar11 e evento1 até evento7, será necessário remapear as variáveis do AEM e restaurar o mapeamento original.
Veja a seguir um exemplo de mapeamentos padrão após seguir o tutorial de introdução:

Mapa de eVars enviadas com cada evento

Tipo de recurso de ativação
Título do site
Tipo de função
Título do grupo
Caminho do grupo
Tipo UGC
Título UGC
Usuário (Membro)
Caminho UGC
Caminho do site
eVar1
eVar2
eVar3
eVar4
eVar5
eVar6
eVar7
eVar8
eVar9
eVar10
evento1Reprodução de recursos
(uma sessão gerenciada no quadro branco)
-
-
-
-
-
-
-
i)
-
event2SCFView
(uma sessão gerenciada no quadro branco)
b)
c)
(d)
(e)
(f)
(g)
(h)
i)
j)
evento3SCFCreate (Post)
-
b)
c)
(d)
(e)
(f)
(g)
(h)
i)
j)
event4SCFFollow
-
b)
c)
(d)
(e)
(f)
(g)
(h)
i)
j)
event5SCFVoteUp
-
b)
c)
(d)
(e)
(f)
(g)
(h)
i)
j)
event6SCFVoteDown
-
b)
c)
(d)
(e)
(f)
(g)
(h)
i)
j)
event7SCFRate
-
b)
c)
(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/hiking
  • ResourceType do componente UGC: social/fórum/componentes/hbs/tópico
  • Título do componente UGC: Tópicos de rastreamento
  • Logon (ID de autorização): aaron.mcdonald@mailinator.com
  • Caminho SRP para UGC: /content/usergenerate/asi/.../forum/jmtz-topics3 ou caminho do componente a ser seguido : /content/sites/Communities/en/jcr:content/content/Primary/forum
  • Caminho para o conteúdo do site da comunidade: /content/sites/community/br

Modificando o mapeamento de variáveis do Analytics

O mapeamento de evars e eventos do Analytics para variáveis do AEM é visível na configuração da estrutura depois que o Analytics é habilitado 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 de duplicado, 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 das Comunidades substituírem os mapeamentos que existiam no conjunto de relatórios, para evitar perda de dados, atribua as variáveis do AEM para os recursos das Comunidades a outras evars e/ou eventos do Analytics e restaure os mapeamentos originais.
É importante remapear antes que o site da comunidade seja publicado com a Analytics ativada, caso contrário, há risco de perda de dados.

Exemplo Etapa 1: Arrastar a Analytics evar14 para a tabela de mapeamento

Exemplo Etapa 2: Selecionar 'x' para remover evar11 substituído

Exemplo Etapa 3: AEM var eventdata.siteId remapeado para Analytics evar14

Publicar o site da comunidade

Verificar o mapeamento de variáveis Analytics para AEM

É aconselhável verificar o mapeamento de variável antes de publicar o site da comunidade, que também publica o serviço e a estrutura de nuvem da Analytics.
Consulte as seções:
Se estiver usando um conjunto de relatórios existente que já usa variáveis em
  • evar1 a evar11
  • event1 a event7
Depois, antes de o site da comunidade ser publicado, é importante restaurar o mapeamento preexistente e mover as variáveis AEM das Comunidades que foram automaticamente mapeadas (quando o Analytics foi ativado para o site da comunidade) para outras variáveis do Analytics. Esse novo mapeamento deve ser consistente em todos os componentes das Comunidades.
Se isso não for feito, poderá ocorrer perda irrecuperável de dados.

Editor principal

Quando a implantação escolhida é um farm de publicação, uma instância de publicação do AEM deve ser identificada como o editor principal para sondar o Adobe Analytics para que os dados do relatório sejam gravados no SRP .
Por padrão, a configuração do AEM Communities Publisher Configuration OSGi identifica sua 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 o principal.
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 principal do editor de Implantação de comunidades .
É importante que o editor principal seja configurado para impedir a pesquisa de várias instâncias de publicação.

Replicar a chave de criptografia

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 do 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 Cloud Service Analytics

Depois que o serviço em nuvem da Analytics for ativado para um site da comunidade e, se necessário, o mapeamento das variáveis do Analytics para o AEM for ajustado , será necessário replicar a configuração para o ambiente de publicação (re)publicando o site da comunidade.

Obtenção de relatórios da Analytics

Gerenciamento de relatórios

A configuração OSGi do autor e do editor principal, AEM Communities Analytics Report Management , é usada para query da Analytics.
No autor, os query são para relatórios em tempo real.
No editor principal, os query são usados para fornecer informações em preparação para a importação de dados analíticos do Importador de relatórios.
O padrão do intervalo de query é 10 segundos.

Importador de relatórios

Depois que um site da comunidade habilitado pela Analytics for publicado, a configuração OSGi do editor principal, AEM Communities Analytics Report Importer , poderá ser configurada 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 de solicitações à Adobe Analytics para que os dados sejam obtidos e salvos no SRP .
Quando os dados podem ser classificados como "grandes dados", pesquisas mais frequentes podem colocar uma grande carga no site da comunidade.
O intervalo padrão de importação de sondagem é definido como 12 horas.

Personalização do relatório do componente

Atualmente, para personalizar as métricas a serem rastreadas, os nós são criados no repositório que define 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
  • Navegue até CRXDE Lite
  • No jcr:content nó da raiz do idioma
    • Por exemplo, /content/sites/engage/en/jcr:content
  • Navegue até o componente configurado para o Analytics relatórios
    • Por exemplo, analytics/reportConfigs/social_forum_components_hbs_topic
  • Observe os períodos de tempo criados
    • last30Days
    • last90Days
    • thisYear
  • Observe o total
    • Modificar a interval propriedade substituirá o intervalo do Importador de relatórios
    • O valor está em segundos e é definido como 4 horas (14400 segundos)

Gerenciar dados do usuário no Analytics

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