Integração com o Adobe Target usando IMS

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

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

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

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

Criação do projeto

Abra o Adobe Developer Console para criar um Projeto com o Adobe Target 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 e, em seguida, API:

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

    OBSERVAÇÃO

    Se você estiver inscrito no Adobe Target, mas não o vir listado, verifique a Pré-requisitos.

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

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

  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

  8. A criaçã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 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:

Selecione Exibir (à direita de 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 Target

Em alguns desses, você precisará 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 para 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.

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.

  4. Se for bem-sucedido, você verá a mensagem:

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 Services , selecione Cloud Services herdados.

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

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

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

    A variável Editar componente será 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 o IMS, esse valor precisa 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 da nuvem do A4T Analytics: selecione a configuração da nuvem do Analytics usada para métricas e metas de atividade do Target. 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 aguardará o carregamento do contexto 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. Você deve selecionar 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 precisa usar segmentos do Target. (Observe que o termo “segmento” do AEM equivale 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 no diálogo para 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 serã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 do 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 de que:

  • Por padrão, o Código do cliente (se adicionado primeiro) também será copiado automaticamente para o campo ID do locatário.
  • Você tem a opção de alterar o conjunto padrão de ID de locatário.
  • Assim, as chamadas de back-end para o Target serão baseadas na ID do locatário e as chamadas do lado do cliente para o Target serão baseadas no Código do cliente.

Como dito anteriormente, o primeiro caso é o mais comum para o AEM 6.5. De qualquer maneira, certifique-se de 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