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:
No ambiente de criação:
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:
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
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 Marketing 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 de evar11
ativação7 Eventos bem-sucedidos (eventos)
event1
por meio de event7
ativação
Tipo Counter
Counter (no subrelations)
Pode redefinir (renomear) os eventos existentes ou criar novos eventos para usar nos recursos das Comunidades
Console de relatórios de vídeo
Video Core
Console de medição do vídeo principal
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árias 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.
Se estiver usando um conjunto de relatórios existente que já usa variáveis no
evar1
a evar11
event1
a event7
Depois, antes de o site da comunidade ser publicado, é importante restaurar o mapeamento pré-existente, 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 variáveis AEM para outras variáveis do Analytics, consulte a seção sobre Modificar o mapeamento de variável do Analytics.
Se isso não for feito, poderá ocorrer perda irrecuperável de dados.
Quando o Video Heartbeat Analytics está licenciado, um Marketing Cloud Org Id
é atribuído.
Para ativar o relatório do Video Heartbeat após configurar o conjunto de relatórios do Analytics para o relatório de vídeo:
Marketing Cloud Org Id
ao site da comunidadeO Marketing Cloud Org Id
pode ser inserido no momento de criação de site da comunidade ou posterior por modificação das propriedades de site da comunidade.
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.
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:
[+]
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 Ativar o Analytics da comunidade
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 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 requer as informações de pré-requisito da conta obtidas do representante da conta.
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:
Selecione Conectar-se ao Analytics
Se não tiver êxito,
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 (AEM) das Comunidades para variáveis do Analytics (conjunto de relatórios).
[+]
ao lado de Frameworks disponíveis para criar uma nova estruturaTítulo
(Obrigatório) Um título de exibição para a estrutura
Por exemplo, digite Estrutura de comunidade de ativação
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 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 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.
Report suite
que os conjuntos de relatórios associados à conta Empresa devem estar disponíveis para seleçãoLoad default server settings? Do you want to load the default server settings and overwrite current values in the Server section?
Run Mode
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.
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 [!UICONTROL Communities > 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 para um site da comunidade, um elemento de página com a classe scf-js-site-title
e os atributos href devem estar presentes. Somente um desses elementos 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 o 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 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 de AEM genérico que inclui componentes do Communities, mas não é criado com o assistente de criação de site, é 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
, use:
<div
class="navbar-brand scf-js-site-title"
href="/content/my/company/en.html?lang=pt-BR"
style="visibility: hidden;"
>
</div>
O Analytics é usado automaticamente para vários recursos das Comunidades.
A configuração OSGi do ambiente do autor, AEM Communities Analytics Component Configuration
, fornece uma listagem 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.
Observação: os componentes journal
são usados para implementar o recurso de blog.
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 AEM e restaurar o mapeamento original.
A seguir, um exemplo de mapeamentos padrão após seguir o tutorial getting started:
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 | eVar 4 | eVar 5 | eVar 6 | eVar7 | eVar8 | eVar9 | eVar10 | |
event1Resource Play | (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) |
event3SCFCreate (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:
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.
É importante remapear antes que o site da comunidade seja publicado com o Analytics ativado, caso contrário há risco de perda de dados.
É 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:
Se estiver usando um conjunto de relatórios existente que já usa variáveis no
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 do 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.
Quando a implantação escolhida é um publish farm, uma instância de publicação AEM deve ser identificada como o editor principal para polling Adobe Analytics para que os dados do relatório gravem 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 as 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 Principal.
Para obter instruções específicas, consulte a seção Editor principal 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 Replicate the Crypto Key.
Depois que o serviço de nuvem do Analytics for ativado para um site da comunidade e, se necessário, o mapping do Analytics para AEM variáveis tiver sido ajustado, é 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 do editor principal, 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.
Depois que um site da comunidade habilitado para o Analytics for publicado, a configuração do editor principal OSGi, 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 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 Import range é definida como 12 horas.
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
Navegue até CRXDE Lite
No nó jcr:content
da raiz do idioma
/content/sites/engage/en/jcr:content
Navegue até o componente configurado para os relatórios do Analytics
analytics/reportConfigs/social_forum_components_hbs_topic
Observe os períodos de tempo criados
last30Days
last90Days
thisYear
Observe o nó total
interval
substituirá o intervalo do Importador de relatóriosO 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.