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.

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.

     

   • Caso já tenha projetos existentes, eles serão listados e Criar novo projeto estará no canto superior direito.

     

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:

   • https://adminconsole.adobe.com

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:

• https://developer.adobe.com/console/projects

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

   

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.

Recursos do Business.Adobe.com