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 estão também disponíveis no Migração para as APIs 2.0.

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.

      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. Selecionar Adicionar ao projeto seguida de API:

    Introdução ao novo projeto

  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.

    Adicionar uma API

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

    Selecionar tipo de autenticação

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

    Fazer upload de sua chave pública

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

    Revisar credenciais

  8. Selecione os perfis de produto necessários e continue com 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. 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:

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:

    Detalhes da configuração do AEM IMS

  4. Confirme com Criar.

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

    Configuração IMS

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.

    Configuração IMS - Verificar integridade

  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.

Nesta página