Configuração do IMS para uso na integração com o Adobe Analytics ims-configuration-for-integration-with-adobe-analytics

A integração do Adobe Experience Manager as a Cloud Service (AEMaaCS) com o Adobe Analytics, por meio da API do Analytics Standard, requer a configuração do Adobe IMS (Identity Management System). A configuração é realizada com o Adobe Developer Console.

NOTE
A compatibilidade com a API 2.0 do Adobe Analytics Standard é nova no AEMaaCS 2022.2.0. Essa versão da API é compatível com a autenticação IMS.
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 prerequisites

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 sistemas 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 usando o Adobe Developer Console.
    • Consulte Gerenciar desenvolvedores.

Configuração de IMS - Geração de uma Chave pública configuring-ims-generating-a-public-key

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 contas técnicas 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.

    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.

    note caution
    CAUTION
    Mantenha essa configuração aberta, ela será necessária novamente ao Concluir a configuração do IMS no AEM.

    Baixar certificado

Configurar o IMS para integração do Adobe Analytics com o AEM configuring-ims-adobe-analytics-integration-with-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 creating-the-project

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

CAUTION
Atualmente, só oferecemos suporte ao console do Adobe Developer Conta de serviço (JWT) tipo de credencial.
Não use o Servidor OAuth para servidor tipo de credencial, que terá suporte no futuro.
  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á na parte inferior central.

      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:

    note note
    NOTE
    Se você estiver inscrito no Adobe Analytics, mas não o vir listado, verifique os 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 é confirmada.

Atribuir privilégios à integração assigning-privileges-to-the-integration

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 details-stored-for-the-ims-integration-project

No Console do desenvolvedor da Adobe - Projetos, você pode 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

Em alguns desses, você deve concluir a integração do Adobe Analytics no AEM com base no IMS.

Concluir a configuração do IMS no AEM completing-the-ims-configuration-in-aem

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

  1. Retorne à Configuração do IMS aberta no AEM.

  2. Selecione Próximo.

  3. Aqui, é possível usar os detalhes da configuração do projeto no Console do Desenvolvedor da Adobe:

    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 confirming-the-ims-configuration

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 tiver êxito, você verá uma mensagem de confirmação.

Concluir a integração com o Adobe Analytics complete-the-integration-with-adobe-analytics

Agora, você pode usar essa configuração do IMS para concluir a integração com o Adobe Analytics.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab