Integração com o Adobe Analytics usando IMS

A integração do AEM com o Adobe Analytics por meio da API do Analytics Standard requer a configuração do Adobe IMS (Identity Management System) usando o Adobe Developer Console.

Pré-requisitos

Antes de iniciar este procedimento:

• Suporte a Adobe precisa provisionar sua conta para:

  • Console Adobe
  • Console do desenvolvedor do Adobe
  • Adobe Analytics e
  • Adobe IMS (Sistema Identity Management)

• O Administrador de sistema da sua organização deve usar o Admin Console para adicionar os desenvolvedores necessários em sua organização aos perfis de produto relevantes.

  • Isso fornece aos desenvolvedores específicos permissões para ativar integrações no Console do desenvolvedor do Adobe.
  • Para obter mais detalhes, consulte Gerenciar desenvolvedores.

Configuração de um IMS - Geração de uma chave pública

O primeiro estágio da configuração é criar uma Configuração IMS no AEM e gerar a Chave pública.

1. Em AEM abra o Ferramentas menu.

2. No Segurança seção selecionar Configurações do Adobe IMS.

3. Selecionar Criar para abrir o Configuração de conta técnica do Adobe IMS.

4. Uso da lista suspensa em Configuração na nuvem, selecione Adobe Analytics.

5. Ativar Criar novo certificado e insira um novo alias.

6. Confirme com Criar certificado.

   

7. Selecionar Baixar ou Baixar chave pública) para baixar o arquivo na unidade local, de modo que ele esteja pronto para uso quando configuração do IMS para integração do Adobe Analytics com o AEM.

   ATENÇÃO

   Mantenha essa configuração aberta, ela será necessária novamente quando Concluir a configuração IMS no AEM.

   

Configuração do IMS para integração do Adobe Analytics com o AEM

Usando o Console do desenvolvedor do Adobe, é necessário criar um Projeto (integração) com o Adobe Analytics (para uso do AEM) e, em seguida, atribuir os privilégios necessários.

Criação do projeto

Abra o Console do desenvolvedor do Adobe para criar um Projeto com o Adobe Analytics que AEM usará:

1. Abra o Console do desenvolvedor do Adobe para Projetos:

   https://developer.adobe.com/console/projects

2. Quaisquer projetos que você tiver serão mostrados. Selecionar Criar novo projeto - a localização e utilização dependerão:

   • Se você ainda não tiver um projeto, Criar novo projeto será central, inferior.

     

   • Caso já tenha projetos existentes, eles serão listados e Criar novo projeto estará no canto superior direito.

     

3. Selecionar Adicionar ao projeto seguida de API:

   

4. Selecionar Adobe Analytics, em seguida Próximo:

   OBSERVAÇÃO

   Se você estiver inscrito no Adobe Analytics, mas não o vir listado, verifique a variável Pré-requisitos.

   

5. Selecionar Conta de serviço (JWT) como o tipo de autenticação, continue com Próximo:

   

6. Fazer upload de sua chave pública e quando terminar, continue com Próximo:

   

7. Revise as credenciais e continue com Próximo:

   

8. Selecione os perfis de produto necessários e continue com Salvar API configurada:

   

9. A configuração será confirmada.

Atribuir privilégios à integração

Agora, você deve atribuir os privilégios necessários à integração:

1. Abra o Adobe Admin Console:

   • https://adminconsole.adobe.com

2. Navegar para Produtos (barra de ferramentas superior), em seguida, selecione Adobe Analytics - <your-tenant-id> (no painel esquerdo).

3. Selecionar Perfis de produto, seu espaço de trabalho necessário na lista apresentada. Por exemplo, Espaço de trabalho padrão.

4. Selecionar Credenciais da API, em seguida, a configuração de integração necessária.

5. Selecionar Editor como Função do produto; em vez de Observador.

Detalhes armazenados para o Projeto de integração do Console do Desenvolvedor do Adobe

No console Adobe Developer Projects, é possível ver uma lista de todos os seus projetos de integração:

• https://developer.adobe.com/console/projects

Selecione uma entrada de projeto específica para mostrar mais detalhes sobre a configuração. Dentre elas:

• Visão geral do projeto
• Insights
• Credenciais
  • Conta de serviço (JWT)
    • Detalhes da credencial
    • Gerar JWT
• APIS
  • Por exemplo, Adobe Analytics

Alguns deles, você precisará concluir a integração do Adobe Analytics no AEM.

Concluir a configuração IMS no AEM

Ao retornar para AEM, é possível concluir a configuração do IMS adicionando os valores necessários do projeto de integração do Analytics:

1. Retorne ao Configuração IMS aberta no AEM.

2. Selecione Próximo.

3. Aqui você pode usar o Detalhes armazenados para o Projeto de integração do Console do Desenvolvedor do Adobe:

   • Título: Seu texto.
   • Servidor de autorização: Copie/cole no aud da Carga seção abaixo, por exemplo https://ims-na1.adobelogin.com no exemplo abaixo
   • Chave da API: Copie isso do Credenciais da seção Visão geral do projeto
   • Segredo do cliente: Gere isso no Guia Segredo do cliente da seção Conta de serviço (JWT)e copiar
   • Carga: Copie isso do Guia Gerar JWT da seção Conta de Serviço (JWT)

   

4. Confirme com Criar.

5. Sua configuração do Adobe Analytics será exibida no console AEM.

   

Confirmação da configuração IMS

Para confirmar que a configuração está funcionando como esperado:

1. Abrir:

   • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

   Por exemplo:

   • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html

2. Selecione sua configuração.

3. Selecionar Verificar integridade na barra de ferramentas, seguida por Verificar.

   

4. Se bem-sucedido, você verá uma mensagem de confirmação.

Configuração do serviço Adobe Analytics Cloud

A configuração agora pode ser mencionada para um Cloud Service para usar a API do Analytics Standard:

1. Abra o Ferramentas menu. Em seguida, no Cloud Services seção , selecione Cloud Services herdados.

2. Role para baixo até Adobe Analytics e selecione Configurar agora.

   O Criar configuração será aberta.

3. Insira um Título e, se quiser, um Nome (se deixado em branco, isso será gerado a partir do título).

   Você também pode selecionar o modelo necessário (se mais de um estiver disponível).

4. Confirme com Criar.

   O Editar componente será aberta.

5. Insira os detalhes na Configurações do Analytics guia :

   • Autenticação: IMS

   • Configuração IMS: selecione o nome da Configuração IMS

6. Clique em Conectar-se ao Analytics para inicializar a conexão com o Adobe Analytics.

   Se a conexão for bem-sucedida, a mensagem Conexão bem-sucedida é exibida.

7. Selecionar OK na mensagem.

8. Complete outros parâmetros, conforme necessário, seguido de OK na caixa de diálogo para confirmar a configuração.

9. Agora você pode continuar com Adicionar uma estrutura do Analytics para configurar parâmetros que serão enviados para o Adobe Analytics.