A Adobe Analytics e a Adobe Experience Manager (AEM) são ambas soluções da Adobe Marketing Cloud.
A Adobe Analytics pode ser configurada para AEM Communities para que, à medida que um membro interage com os recursos das Comunidades compatíveis, eventos sejam enviados para a Adobe Analytics a partir da 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 ao 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:
No ambiente do autor:
Os recursos das Comunidades suportadas incluem:
Esta seção da documentação descreve como conectar um conjunto de relatórios do Analytics com os recursos das Comunidades. As etapas básicas são:
Replicar a chave de criptografia para garantir que a criptografia/descriptografia ocorra corretamente em todas as instâncias AEM
Preparar um conjunto de relatórios Adobe Analytics
Criar um serviço em nuvem do AEM Analytics e framework
Ativar o Analytics para um site da comunidade
VerifyAnalytics para mapeamento AEM variável
Identifique editor principal
Configurar importação de dados de relatório da Adobe Analytics para o site da comunidade
Para configurar os recursos do Analytics para Comunidades, é necessário trabalhar com seu representante de conta para configurar uma conta da Adobe Analytics e 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 para o 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 centro de dados do Analytics para a conta.
Conjunto de relatórios
O nome do conjunto de relatórios do Analytics a ser usado.
Usando o Gerenciador de conjunto de relatórios da Adobe Marketing Cloud, os conjuntos de relatórios do Analytics podem ser configurados para que um site da comunidade possa ser habilitado para fornecer relatórios sobre os recursos das Comunidades.
Ao fazer logon em Adobe Experience Cloud com Nome da Empresa e Nome do usuário, é possível configurar um conjunto de relatórios novo ou existente para ter:
11 Variáveis de conversão (eVars)
evar1
por meio evar11
ativado
Pode alterar a finalidade (renomear) das eVars existentes ou criar novas para usar nos recursos das Comunidades
7 Eventos bem-sucedidos (eventos)
event1
por meio event7
ativado
tipo Counter
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
Video Core
Console de avaliação do Video Core
Use Solution Variables
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, 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 as variáveis do Analytics quando o Analytics foi ativado para um site da comunidade.
Para restaurar o mapeamento preexistente e mover variáveis AEM para outras variáveis do Analytics, consulte a seção Modificando o mapeamento de variáveis do Analytics.
Se isso não for feito, pode resultar em perda irrecuperável de dados.
Quando a Análise do Video Heartbeat está licenciada, um Marketing Cloud Org Id
é atribuído.
Para ativar o relatórios Video Heartbeat após configurar o conjunto de relatórios do Analytics para o relatórios de vídeo:
Marketing Cloud Org Id
ao site da comunidadeO Marketing Cloud Org Id
pode ser inserido no momento de criação do site da comunidade ou posterior por modificação das propriedades do site da comunidade.
Quando a Análise do Video Heartbeat está ativada, o código JavaScript (JS) do player de vídeo instancia o código da biblioteca do Video Heartbeat (também em 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 aos principais servidores do Analytics.
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.
Para criar uma nova Integração do Analytics, que integra o Adobe Analytics ao site da comunidade AEM, usando a interface padrão na instância do autor:
[+]
ao lado de Configurações disponíveis para criar uma nova configuraçãoNa 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, digite Habilitar o 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.
Por exemplo, digite Communities
Modelo
Selecionar Adobe Analytics Configuration
Selecione Criar
Analytics Settings
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 para o 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 do Analytics que hospeda o conjunto de relatórios.
Não adicionar a tag de rastreamento à página
Deixe como padrão (desmarcado).
Usar AppMeasurement
Deixe como padrão (desmarcado).
Não realizar importações de impressões de página todas as noites (autor)
Deixe como padrão (desmarcado).
Não realizar importações de impressões de página todas as noites (publicar)
Deixe como padrão (desmarcado).
Para salvar as configurações:
Selecione Ligar ao Analytics
Se não for bem-sucedido,
Selecione OK.
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 as variáveis do Analytics (conjunto de relatórios).
Selecione o ícone [+]
ao lado de Frameworks disponíveis para criar uma nova estrutura
Título
(Obrigatório) Um título de exibição para a estrutura
Por exemplo, digite Enablement Community Framework.
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, digite Communities.
Modelo
Selecionar Adobe Analytics Framework
.
Selecione Criar.
A criação da Estrutura do Analytics abre a estrutura para configuração.
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 definidas no 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:
Conjunto de relatórios da 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 Report Suites.
Selecione Adicionar Item +.
Duas caixas suspensas são exibidas.
Escolha um Report suite.
Os conjuntos de relatórios associados à conta de Empresa estão disponíveis para seleção.
Selecione Yes 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?
Escolha um Run Mode
.
Selecione 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 esse serviço do Analytics ativado.
Para adicionar o serviço de nuvem do Analytics enquanto cria um novo site da comunidade:
Na etapa 3, na guia ANALYTICS:
Como opção, retorne à configuração da estrutura do Analytics para ajustar os mapeamentos de variáveis.
Para adicionar o serviço de nuvem do 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:
Como opção, retorne à configuração da estrutura do Analytics para ajustar os mapeamentos de variáveis.
Para que o rastreamento e a importação do Analytics funcionem corretamente em 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 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 personalizado da comunidade que sobrepõe o script sitepage.hbs
, verifique se o elemento está presente. A variável siteUrl
será definida quando renderizada no servidor antes de servir ao cliente.
Para um site AEM genérico que inclui componentes 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>
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 novos componentes personalizados forem criados e instrumentados para o Analytics, eles deverão ser adicionados a essa lista de componentes configurados.
Os componentes do journal são usados para implementar o recurso de blog.
Depois que o site da comunidade for salvo com o Analytics ativado e a estrutura de configuração da nuvem selecionada, as variáveis 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 variável dentro de evar1 até evar11 e evento1 até evento7, será necessário remapear as variáveis AEM e restaurar o mapeamento original.
Veja a seguir um exemplo de mapeamentos padrão após seguir o tutorial getting started:
Tipo de Ativação Recurso |
Título do Site |
Tipo de função |
Título do Grupo |
Caminho do Grupo |
Tipo UGC |
Título do UGC |
User (Membro) |
Caminho UGC |
Caminho do Site |
|
eVar 1 | eVar2 | eVar 3 | eVar 4 | eVar 5 | eVar 6 | eVar 7 | eVar 8 | eVar 9 | eVar10 | |
Reprodução de Recursos do evento1 |
(uma sessão gerenciada no quadro branco) | - | - | - | - | - | - | - | i) | - |
evento2 SCFView |
(uma sessão gerenciada no quadro branco) | b) | c) | (d) | (e) | (f) | (g) | (h) | i) | j) |
evento3 SCFCreate (Post) |
- | b) | c) | d) | e) | f) | g) | h) | i) | j) |
evento4 SCFFollow |
- | b) | c) | d) | e) | f) | g) | h) | i) | j) |
evento5 SCFVoteUp |
- | b) | c) | d) | e) | f) | g) | h) | i) | j) |
evento6 SCFVoteDown |
- | b) | c) | d) | e) | f) | g) | h) | i) | j) |
evento7 SCFRate |
- | 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/<site name>/en/groups/hiking
ResourceType do componente UGC: social/forum/components/hbs/topic
Título do componente UGC: Tópicos de rastreamento
login (authorizedId): aaron.mcdonald@mailinator.com
Caminho SRP para UGC: /content/usergenerated/asi/.../forum/jmtz-topic3
ou
caminho do componente a ser seguido: /content/sites/<site name>/en/jcr:content/content/primary/forum
caminho para o conteúdo do site da comunidade: /content/sites/<site name>/en
O mapeamento de eVars e eventos do Analytics para variáveis 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 da publicação do site da comunidade, 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 duplicados, remova a evar ou o evento substituído do Analytics da linha passando o mouse sobre ela e selecionando o "X" que aparece à direita do elemento de variável do Analytics.
Se as eVars das Comunidades e os eventos substituírem os mapeamentos que existiam no conjunto de relatórios, para evitar perda de dados, atribua as variáveis AEM para os recursos das Comunidades a outras eVars ou eventos do Analytics e restaure os mapeamentos originais.
É importante remapear antes que o site da comunidade seja publicado com o Analytics ativado, caso contrário, há risco de perda de dados.
Convém verificar o mapeamento de variável antes de publicar o site da comunidade, que também publica o serviço e a estrutura da nuvem do 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 Comunidades AEM 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, pode resultar em perda irrecuperável de dados.
Quando a implantação escolhida é um farm de publicação, uma instância de publicação AEM deve ser identificada como o editor principal para sondar o Adobe Analytics para que os dados do relatório sejam gravados em SRP.
Por padrão, a configuração 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 a 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 principal.
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.
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.
Depois que o serviço em nuvem do Analytics for ativado para um site da comunidade e, se necessário, o mapeamento do Analytics para variáveis AEM tiver sido ajustado, será necessário replicar a configuração para o ambiente de publicação (re)publicando o site da comunidade.
A configuração OSGi do autor e editor principal, AEM Communities Analytics Report Management
, é usada para query do 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.
Depois que um site da comunidade habilitado pelo 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 em SRP.
Quando os dados podem ser classificados como "grandes dados", pesquisas mais frequentes podem colocar uma grande carga no site da comunidade.
A pesquisa padrão Importar intervalo está definida como 12 horas.
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, faça logon com privilégios administrativos.
Navegue até CRXDE Lite. Por exemplo, https://localhost:4503/crx/de.
No nó jcr:content da raiz do idioma (por exemplo, /content/sites/engage/en/jcr:content),
navegue até o componente configurado para o relatórios do Analytics.
Por exemplo, analytics/reportConfigs/social_forum_components_hbs_topic
Observe os períodos de tempo criados:
last30Days
last90Days
thisYear
Observe o nó total
.
interval
substitui o intervalo do Importador de relatórios.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.