DocumentaçãoAEM 6.5Guia do usuário

Integração com o Adobe Analytics usando IMS integration-with-adobe-analytics-using-ims

Last update: Fri Apr 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Admin

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 console do Adobe Developer.

NOTE
A compatibilidade com a API 2.0 do Adobe Analytics Standard é nova no AEM 6.5.12.0. Esta versão da API é compatível com autenticação IMS.
O uso da API do Adobe Analytics Classic 1.4 no AEM ainda é compatível com versões anteriores. A variável A API clássica do Analytics usa 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 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 no Console do Adobe Developer.
    • Consulte Gerenciar desenvolvedores.

Configuração de IMS - Geração de uma Chave pública configuring-an-ims-configuration-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. No 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.

    Assistente de configuração de conta técnica do Adobe IMS

  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 quando Concluir a configuração do IMS no AEM.

    Caixa de diálogo Informações para adicionar a chave ao Adobe I/O

Configurar o IMS para integração do Adobe Analytics com o AEM configuring-ims-for-adobe-analytics-integration-with-aem

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

Criação do projeto creating-the-project

Para criar um projeto com o Adobe Analytics que o AEM possa usar, abra o Adobe Developer Console:

CAUTION
No momento, o Adobe só é compatível com o 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. Selecionar Criar novo projeto - a localização e utilização dependem do seguinte:

    • 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 são listados e Criar novo projeto está localizado 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. Selecionar Conta de serviço (JWT) como o tipo de autenticação, depois continue com Próxima:

    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 atribua 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 Projetos Adobe Developer é possível ver uma lista de todos os projetos de integração:

Para mostrar mais detalhes sobre a configuração, selecione uma entrada de projeto específica. 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.

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 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 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.

Configuração do serviço Adobe Analytics Cloud configuring-the-adobe-analytics-cloud-service

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

  1. Abra o Ferramentas menu. Em seguida, no prazo de Cloud Service , selecione Cloud Service herdados.

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

    A variável Criar configuração é aberta.

  3. Insira um Título e, se desejar, um Nome (se deixado em branco, é 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.

    A variável Editar componente é aberta.

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

    • Autenticação: IMS

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

  6. Para inicializar a conexão com o Adobe Analytics, clique em Conectar-se ao Analytics.

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

  7. Selecionar OK na mensagem.

  8. Preencha outros parâmetros conforme necessário, seguido por OK na caixa de diálogo para que você possa confirmar a configuração.

  9. Agora você pode prosseguir para Adicionar uma estrutura do Analytics para configurar parâmetros enviados para o Adobe Analytics.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2