Integração com o Adobe Target usando IMS

Última atualização em 2023-11-07

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

OBSERVAÇÃO

A compatibilidade com a API do Adobe Target Standard é nova no AEM 6.5. A API do Target Standard usa autenticação IMS.

O uso da API do Adobe Target Classic no AEM ainda é compatível com versões anteriores. A variável A API do Target Classic 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/Target.
Consulte também a ID do locatário e código do cliente seção.

Pré-requisitos

Antes de iniciar este procedimento:

  • O Suporte da Adobe precisa provisionar sua conta com:

    • Adobe Console
    • Console do desenvolvedor da Adobe
    • Adobe Target 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

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

  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 integração do Adobe Target com o AEM.

    ATENÇÃO

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

    Mensagem de informações para adicionar certificado ao Adobe I/O

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

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

Criação do projeto

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

ATENÇÃO

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á no canto superior direito.

      Criar novo projeto - Vários projetos

  3. Selecione Adicionar ao projeto e, em seguida, API:

    Console do desenvolvedor da Adobe

  4. Selecione Adobe Target e, em seguida, Próximo:

    OBSERVAÇÃO

    Se estiver inscrito no Adobe Target, mas ele não estiver listado, verifique os Pré-requisitos.

    Clicar em Próximo

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

    Adição de integrações usando o Console do desenvolvedor

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

    Criação de um projeto

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

    OBSERVAÇÃO

    Os perfis de produto que são exibidos dependem se você:

    • Adobe Target Standard - somente o Espaço de trabalho padrão está disponível
    • Adobe Target Premium - todos os espaços de trabalho disponíveis são listados, conforme mostrado abaixo

    Selecionar uma API para adicionar

  8. A criação é confirmada.

Atribuir privilégios à integração

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 Target - <seu-id-de-locatário> (no painel esquerdo).

  3. Selecione Perfis de produto e, em seguida, o espaço de trabalho necessário. 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 Console do desenvolvedor da Adobe - Projetos, você pode ver uma lista de todos os seus projetos de integração:

Para mostrar mais detalhes sobre a configuração, selecione Exibir (à direita de 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 Target

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

Concluir a configuração do IMS no AEM

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

  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:

    • Título: seu texto.
    • Servidor de autorização: copie/cole essa informação da linha aud da seção Carga abaixo, por exemplo, https://ims-na1.adobelogin.com no exemplo abaixo
    • Chave de API: copie isso da lista Visão geral seção
    • Segredo do cliente: gere isso no Visão geral seção e cópia
    • Carga: copie isso da seção Gerar JWT

    Configuração da conta técnica

  4. Confirme com Criar.

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

    Configurações da conta técnica do Adobe 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, seguido por Verificar.

    Configurações do Adobe IMS

  4. Se tiver êxito, você verá a mensagem:

    Verificar uma configuração

Configuração do Cloud Service Adobe Target

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

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

  2. Role para baixo até Adobe Target 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 Adobe Target guia:

    • Autenticação: IMS

    • ID do inquilino: a ID do locatário do Adobe IMS. Consulte também a ID do locatário e código do cliente seção.

      OBSERVAÇÃO

      Para IMS, esse valor deve ser retirado do próprio Target. Você pode fazer logon no Target e extrair a ID do locatário do URL.

      Por exemplo, se o URL for:

      https://experience.adobe.com/#/@yourtenantid/target/activities

      Então você usaria yourtenantid.

    • Código do cliente: Consulte a ID do locatário e código do cliente seção.

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

    • Tipo de API: REST

    • Configuração do A4T Analytics Cloud: selecione a configuração do Analytics Cloud usada para métricas e metas da atividade de direcionamento. Isso é necessário se estiver usando o Adobe Analytics como fonte de relatórios ao direcionar conteúdo. Se você não vir a configuração da nuvem, consulte a observação em Definição da Configuração do A4T Analytics Cloud.

    • Usar a segmentação precisa: por padrão, essa caixa de seleção está marcada. Se selecionada, a configuração do Cloud Service aguarda o contexto ser carregado antes de carregar o conteúdo. Veja a observação a seguir.

    • Sincronizar segmentos do Adobe Target: selecione essa opção para baixar segmentos definidos no Target e usá-los no AEM. Selecione essa opção quando a propriedade Tipo de API for REST, pois os segmentos em linha não são compatíveis e você sempre deve usar segmentos do Target. (O termo AEM de "segmento" é equivalente ao termo "público-alvo" do Target.)

    • Biblioteca do cliente: selecione se deseja a biblioteca do cliente AT.js ou mbox.js (descontinuada).

    • Usar o sistema Tag Management para disponibilizar a biblioteca do cliente: Use o DTM (obsoleto), o Adobe Launch ou qualquer outro sistema de gerenciamento de tags.

    • AT.js personalizada: Deixe em branco se tiver marcado a caixa Tag Management ou para usar a AT.js padrão. Como alternativa, faça upload do seu AT.js personalizado. Aparece somente se tiver selecionado AT.js.

    OBSERVAÇÃO

    Configuração de um Cloud Service para usar a API do Target Classic foi descontinuado (usa a guia Configurações do Adobe Recommendations ).

  6. Clique em Conectar ao Target para inicializar a conexão com o Adobe Target.

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

  7. Selecionar OK na mensagem, seguido por OK na caixa de diálogo para que você possa confirmar a configuração.

  8. Agora você pode prosseguir para Adição de uma estrutura do Target para configurar os parâmetros do ContextHub ou do ClientContext que são enviados para o Target. Observe que isso pode não ser necessário para exportar fragmentos de experiência do AEM para o Target.

ID do locatário e código do cliente

Com Adobe Experience Manager 6.5.8.0, o campo Código do cliente foi adicionado à janela de configuração do Target.

Ao configurar os campos ID de locatário e Código do cliente, esteja ciente do seguinte:

  1. Para a maioria dos clientes, a ID do locatário e o Código do cliente são iguais. Isso significa que ambos os campos contêm as mesmas informações e são idênticos. Insira a ID do locatário em ambos os campos.
  2. Para fins herdados, você também pode inserir valores diferentes nos campos ID do locatário e Código do cliente.

Em ambos os casos, esteja ciente do seguinte:

  • Por padrão, o código de cliente (se adicionado primeiro) também é copiado automaticamente para o campo ID de locatário.
  • Opcionalmente, é possível alterar o conjunto padrão de ID do locatário.
  • Portanto, as chamadas de back-end para o Target são baseadas na ID do locatário e as chamadas do lado do cliente para o Target são baseadas no Código do cliente.

Como dito anteriormente, o primeiro caso é o mais comum para o AEM 6.5. De qualquer maneira, verifique se ambos Os campos contêm as informações corretas, dependendo das suas necessidades.

OBSERVAÇÃO

Se quiser alterar uma Configuração do Target existente:

  1. Insira novamente a ID do locatário.
  2. Conecte-se novamente ao Target.
  3. Salve a configuração.

Nesta página