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.

OBSERVAÇÃO

O suporte para a API 2.0 do Adobe Analytics Standard é novo no AEM 6.5.12.0. Essa versão da API é compatível com a autenticação IMS.

O uso da API do Adobe Analytics Classic 1.4 no AEM ainda é compatível com versões anteriores. O A API do Analytics Classic usa a autenticação de credenciais do usuário.

A seleção da API é orientada pelo método de autenticação usado para a integração do AEM/Analytics.

Outras informações também estão disponíveis em Migrar para as APIs 2.0.

Pré-requisitos

Antes de iniciar este procedimento:

  • O Suporte da Adobe precisa provisionar sua conta com:

    • Adobe Console
    • Console do desenvolvedor da Adobe
    • Adobe Analytics e
    • Adobe IMS (Identity Management System)
  • 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 Adobe Developer.
    • Para obter mais detalhes, consulte Gerenciar desenvolvedores.

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

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

  1. No AEM, abra o menu Ferramentas.

  2. Na seção Segurança, selecione Configurações do Adobe IMS.

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

  4. Usando a lista suspensa em Configuração na nuvem, selecione Adobe Analytics.

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

  6. Confirme com Criar certificado.

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

    ATENÇÃO

    Mantenha essa configuração aberta. Ela será necessária novamente ao Concluir a configuração do IMS no AEM.

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

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

Criação do projeto

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

  1. Abra os projetos do Adobe Developer Console:

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

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

    • Se você ainda não tiver um projeto, Criar novo projeto estará no centro, na parte inferior.

      Criar novo projeto - Primeiro projeto

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

      Criar novo projeto - Vários projetos

  3. Selecione Adicionar ao projeto, seguido da API:

    Introdução ao novo projeto

  4. Selecione Adobe Analytics e, 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.

    Adicionar uma API

  5. Selecione Conta de serviço (JWT) como o tipo de autenticação e clique em Próximo:

    Selecione o tipo de autenticação

  6. Faça upload da sua chave pública e, quando terminar, clique em Próximo:

    Selecione Fazer upload da sua chave pública

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

    Revisar credenciais

  8. Selecione os perfis de produto necessários e clique em Salvar API configurada:

    Selecionar perfis de produto necessários

  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:

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

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

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

  5. Selecione Editor como Função do produto, em vez de Observador.

Detalhes armazenados para o projeto de integração do Adobe Developer Console

No de Projetos do Adobe Developer Console, é possível ver uma lista de todos os projetos de integração:

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 do 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 à configuração do 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 Adobe Developer:

    Detalhes da configuração do AEM IMS

  4. Confirme com Criar.

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

    Configuração IMS

Confirmação da configuração do 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. Selecione Verificar integridade na barra de ferramentas e, em seguida, Verificar.

    Configuração do IMS — Verificar integridade

  4. Se for 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 será 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.

Nesta página