Integrar o AEM Forms com o Adobe Analytics integrate-aem-forms-with-adobe-analytics
Este documento descreve o procedimento manual para habilitar o Adobe Analytics em um Formulário adaptável. No entanto, o Adobe recomenda usar o Habilitar o Adobe Analytics para um Formulário Adaptável usando a Automação de Instalação do Experience Cloud.
O AEM Forms integra-se ao Adobe Analytics para permitir que você capture e rastreie métricas de desempenho para seus formulários publicados. O objetivo por trás da análise dessas métricas é permitir que os usuários empresariais obtenham insights sobre o comportamento do usuário final e otimizem a experiência de captura de dados. Você pode capturar e rastrear o comportamento de usuários conectados e não conectados (anônimos) por meio do Adobe Analytics para Forms adaptável.
Após executar as ações mencionadas neste artigo, você pode configurar e exibir relatórios no Adobe Analytics, conforme demonstrado no vídeo a seguir:
Você pode usar o Adobe Analytics para descobrir padrões de interação e problemas que os usuários enfrentam ao usar formulários adaptáveis. Pronto para uso, Adobe Analytics rastreia e armazena informações sobre os seguintes eventos:
-
Renderização: número de vezes que um formulário é aberto.
-
Enviar: número de vezes que um formulário é enviado.
-
Abandonar: número de vezes que os usuários saem sem preencher o formulário.
-
Erro: Número de erros encontrados no painel e nos campos do painel.
-
Ajuda: Número de vezes que um usuário abre a ajuda de um painel e os campos do painel.
-
Visita de campo: número de vezes que um usuário visita um campo no formulário.
-
Salvar: número de vezes que os usuários salvam um formulário no Portal do Forms.
Além desses eventos prontos para uso, você pode definir eventos personalizados em formulários adaptáveis usando um editor de regras e mapear esses eventos para eventos no Adobe Analytics
A figura a seguir ilustra as ações que você precisa executar antes de exibir relatórios em Adobe Analytics:
1. Configurar Adobe Analytics Configure-adobe-analytics
Antes de configurar Adobe Analytics, crie:
- Uma Adobe ID para fazer logon no Adobe Experience Cloud.
- Um conjunto de relatórios.
Instalar o AEM Forms e as extensões do Adobe Analytics install-extensions
Execute as seguintes etapas para configurar o AEM Forms e as extensões do Adobe Analytics:
-
Faça logon no Adobe Experience Cloud e selecione um nome apropriado para a empresa.
-
Selecione Iniciar/Coleção de Dados e Ir para Iniciar/Coleção de Dados.
-
Selecione Nova propriedade e especifique um nome para a configuração.
-
Especifique um nome de domínio e selecione Salvar para salvar a propriedade.
-
Selecione o nome da configuração disponível na lista de Propriedades da tag.
-
Na seção Criação, selecione Extensões.
-
Selecione Catálogo e Instalar para a extensão Adobe Experience Manager Forms. O Adobe Experience Manager Forms é exibido na lista de extensões instaladas disponíveis na guia Instalado.
-
Selecione Instalar para a extensão Adobe Analytics.
-
Selecione o nome do conjunto de relatórios nas listas suspensas Conjuntos de relatórios de desenvolvimento, Conjuntos de relatórios de preparo e Conjuntos de relatórios de produto e selecione Salvar para salvar a extensão.
Configurar elementos de dados configure-data-elements
Você pode selecionar qualquer um dos elementos de dados configurados em uma regra criada para um evento. Quando ocorre um evento em um formulário adaptável, o AEM Forms envia esses elementos de dados para Adobe Analytics.
Após instalar a extensão Adobe Experience Manager Forms, você pode criar os seguintes elementos de dados:
Execute as seguintes etapas para configurar elementos de dados:
-
Na seção Criação, selecione Elementos de Dados.
-
Selecione Criar Novo Elemento De Dados.
-
Especifique um nome para o Elemento de dados. Por exemplo, Título do formulário para o tipo de elemento de dados FormTitle.
-
Especifique Adobe Experience Manager Forms como o nome da Extensão.
-
Selecione o Tipo de Elemento de Dados.
-
Selecione Salvar para salvar o elemento de dados.
embed
Configurar regras configure-rules
Execute as seguintes etapas para criar regras com base na extensão Adobe Experience Manager Forms:
-
Na seção Criação, selecione Regras.
-
Selecione Criar Nova Regra.
-
Especifique um nome para a Regra. Por exemplo, Envio de formulário para registrar envios de formulário.
-
Na seção Eventos, selecione Adicionar.
-
Especifique Adobe Experience Manager Forms como o nome da Extensão.
-
Selecione o tipo de evento. A entrada para o campo Nome é preenchida automaticamente com base no tipo de evento selecionado.
-
Selecione Manter alterações para salvar o evento.
-
Na seção Actions, selecione Add.
-
Especifique Adobe Analytics como o nome da Extensão.
-
Selecione Definir variáveis como o Tipo de ação. As opções disponíveis na lista suspensa incluem:
-
Definir Variáveis: use este tipo de ação para definir o tipo de evento para o qual os elementos de dados selecionados são enviados do AEM Forms para Adobe Analytics.
-
Enviar sinal: use este tipo de ação para enviar dados do AEM Forms para Adobe Analytics.
-
Limpar Variáveis: use este tipo de ação para limpar a trilha de dados de forma que o evento seja registrado apenas uma vez em Adobe Analytics.
A abordagem recomendada é usar o tipo de ação Definir Variáveis para configurar o evento e os elementos de dados, usar Enviar Beacon para enviar dados e usar Limpar Variáveis para limpar a trilha de dados.
-
-
Na seção Props, mapeie as opções do conjunto de relatórios disponíveis na lista suspensa com os elementos de dados definidos com o uso de Configurar elementos de dados.
Por exemplo, para enviar o elemento de dados Título do formulário do AEM Forms para Adobe Analytics quando você enviar um formulário:
-
Na seção Props, selecione uma prop para o Título do Formulário disponível no conjunto de relatórios e, em seguida, selecione
-
Selecione Adicionar Outro para adicionar mais elementos de dados à lista.
-
-
Na seção Eventos, selecione um evento dentre as opções disponíveis no conjunto de relatórios e selecione Manter alterações.
-
Na seção Actions, selecione + e especifique Adobe Analytics como o nome da Extensão.
-
Selecione Enviar sinal como o Tipo de ação. No painel direito, selecione s.t() para enviar dados a Adobe Analytics e tratá-los como um modo de exibição de página ou s.tl() para enviar dados a Adobe Analytics e não tratá-los como um modo de exibição de página. Selecione Manter alterações.
-
Na seção Actions, selecione + e especifique Adobe Analytics como o nome da Extensão.
-
Selecione Limpar Variáveis como o Tipo de Ação. Selecione Manter alterações. Depois de executar essas etapas, a seção Ações é exibida como:
Personalize a seção Ações de acordo com suas necessidades. Por exemplo, você pode definir duas etapas Enviar Beacon em um Fluxo de ação para enviar dados para Adobe Analytics e tratá-los como uma exibição de página em uma etapa e enviar dados para Adobe Analytics e não tratá-los como uma exibição de página na segunda etapa.
-
Selecione Salvar para salvar a regra.
Você pode criar regras para todos os tipos de evento, como Abandonar, Erro, Visita de campo, Ajuda, Renderizar, Salvar e Enviar.
embed
Fluxos Publish publish-flow
Depois de criar os elementos de dados e usá-los nas regras, publique a configuração para coletar dados de formulário no Adobe Analytics.
Execute as seguintes etapas para publicar a configuração:
-
Na seção Publicação, selecione Fluxo de Publicação.
-
Selecione Adicionar biblioteca, especifique um nome e selecione o ambiente para a biblioteca.
-
Selecione Adicionar todos os recursos alterados e selecione Salvar e criar no desenvolvimento.
-
Na seção Desenvolvimento, selecione
-
Confirme se as alterações e o fluxo de publicação serão exibidos em breve na seção Publicado.
2. Configurar o AEM Forms configure-aem-forms
Antes de criar uma configuração do Adobe Launch, crie uma Configuração do Adobe IMS usando o Adobe Launch como a Solução da nuvem.
Criar configuração do Adobe Launch create-adobe-launch-configuration
Execute as seguintes etapas para criar uma configuração do Adobe Launch:
-
Na instância do Autor do AEM Forms, navegue até Ferramentas > Cloud Service > Configurações do Adobe Launch.
-
Selecione uma pasta para criar a configuração e selecione Criar.
-
Especifique um título para a configuração no campo Título.
-
Selecione a configuração IMS da Adobe associada.
-
Selecione o nome da empresa usada durante a configuração do Adobe Analytics.
-
Selecione o nome da propriedade criada durante a configuração do Adobe Analytics.
-
Selecione Salvar e fechar.
-
Publish da configuração.
Habilitar Adobe Analytics para um formulário adaptável enable-analytics-adaptive-form
Para usar a configuração Adobe Launch em um Formulário adaptável existente:
- Na instância do Autor do AEM Forms, navegue até Adobe Experience Manager > Forms > Forms e Documentos.
- Selecione o Formulário adaptável e selecione Propriedades.
- Na guia Básico, selecione o contêiner de configuração usado ao criar a configuração do Adobe Launch.
- Selecione Salvar e fechar. O Formulário adaptável está habilitado para Adobe Analytics.
- Publish o formulário.
Depois de habilitar Adobe Analytics para um formulário adaptável, você poderá validar se houver um fluxo de eventos de dados apropriado entre o AEM Forms e o Adobe Analytics. A integração do AEM Forms com o Adobe Analytics está concluída. Agora você pode configurar e exibir relatórios no Adobe Analytics.
Criar regras para capturar eventos personalizados (Opcional) capture-custom-events
Crie regras em campos específicos de um formulário adaptável usando um editor de regras para enviar dados do Analytics de um formulário adaptável para Adobe Analytics.
Em um processo de dois estágios, você define uma regra em um campo em um formulário adaptável. A regra despacha um evento. O nome do evento é mapeado para um evento de captura personalizado no Adobe Launch.
Para criar regras usando um editor de regras em um formulário adaptável:
- Selecione o campo e selecione
- Defina uma condição na seção When da regra.
- Na seção Then da regra, selecione Evento de Despacho na lista suspensa Selecionar Ação.
- Especifique o nome do evento no campo Digitar Nome do Evento.
Por exemplo, se a data de nascimento for anterior a uma determinada data, a AEM Forms enviará o evento Segurança.
Para mapear o evento para um evento de captura personalizado em Adobe Analytics:
-
Na seção Eventos, selecione Adicionar.
-
Especifique Adobe Experience Manager Forms como o nome da Extensão.
-
Selecione Capturar evento personalizado na lista suspensa Tipo de evento.
-
Especifique o nome do evento especificado na etapa 4 ao criar uma regra usando o editor de regras.
-
Selecione Manter Alterações e execute o restante das ações especificadas em Configurar Regras.
3. Configurar e exibir relatórios em Adobe Analytics view-reports-adobe-analytics
Depois de configurar um formulário adaptável para enviar dados do evento para o Adobe Analytics, você pode começar a exibir relatórios em Adobe Analytics:
-
Selecione
-
Selecione Criar projeto e selecione Projeto em branco.
-
Selecione o nome do conjunto de relatórios na lista suspensa na parte superior direita da forma livre.
-
Especifique o Título do formulário no texto dos itens de dimensão de Pesquisa para exibir todos os títulos de formulário.
-
Solte o título do formulário adaptável para a caixa de texto Solte um segmento aqui (ou qualquer outro componente).
-
Na seção Métricas, solte os eventos a serem rastreados na caixa de texto Solte uma métrica aqui (ou qualquer outro componente).
-
Selecione
-
Selecione as teclas Ctrl + S e especifique um nome para salvar o projeto.