Integração com o Adobe Target usando o Adobe I/O

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) e do Adobe I/O.

OBSERVAÇÃO

O suporte para a Adobe Target Standard API é novo no AEM 6.5. A API do Target Standard usa autenticação IMS.

O uso da Adobe Target Classic API no AEM ainda é compatível com compatibilidade retroativa. A API Público alvo Classic usa autenticação de credenciais de usuário.

A seleção da API é orientada pelo método de autenticação usado para integração de AEM/Público alvo.

Pré-requisitos

Antes de iniciar este procedimento:

  • O suporte para Adobe deve fornecer sua conta para:

    • Console Adobe
    • Adobe I/O
    • Adobe Target e
    • Adobe IMS (Sistema Identity Management)
  • 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 produtos relevantes.

    • Isso fornece aos desenvolvedores específicos permissões para habilitar integrações no Adobe I/O.
    • Para obter mais detalhes, consulte Gerenciar desenvolvedores.

Configuração de IMS - Geração de uma chave pública

A primeira etapa da configuração é criar uma Configuração IMS no AEM e gerar a Chave pública.

  1. AEM abra o menu Ferramentas.

  2. Na seção Security selecione Configurações IMS de Adobe.

  3. Selecione Criar para abrir a Configuração Técnica de Conta do Adobe IMS.

  4. Usando o menu suspenso em Configuração da nuvem, selecione Adobe Target.

  5. Ative Crie um 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, para que esteja pronto para uso ao configurar a integração do Adobe I/O para Adobe Target com AEM](#configuring-adobe-i-o-for-adobe-target-integration-with-aem).[

    CUIDADO

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

Configuração da integração do Adobe I/O para Adobe Target com AEM

Você precisa criar o Adobe I/O Project (integração) com a Adobe Target que AEM usará e, em seguida, atribuir os privilégios necessários.

Criando o projeto

Abra o console do Adobe I/O para criar um projeto de E/S com a Adobe Target que AEM usará:

OBSERVAÇÃO

Consulte também os tutoriais do Adobe I/O.

  1. Abra o console do Adobe I/O para projetos:

    https://console.adobe.io/projects

  2. Todos os projetos que você tiver serão mostrados. Selecione Criar novo projeto - o local e a utilização dependerão de:

    • Se você ainda não tiver um projeto, Criar novo projeto será centralizado, na parte inferior.

      Criar novo projeto - Primeiro projeto

    • Se você já tiver projetos existentes, eles serão listados e Criar novo projeto será o topo direito.

      Criar novo projeto - Vários projetos

  3. Selecione Adicionar ao projeto seguido por API:

  4. Selecione Adobe Target, em seguida Seguinte:

    OBSERVAÇÃO

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

  5. Carregue sua chave pública e, ao concluir, continue com Próximo:

  6. Revise as credenciais e continue com Next:

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

    OBSERVAÇÃO

    Os perfis de produto exibidos dependem se você:

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

  8. A criação será confirmada.

Atribuindo 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 selecione Adobe Target - <your-locatário-id (no painel esquerdo).

  3. Selecione Perfis de produto, em seguida, o espaço de trabalho necessário na lista apresentada. Por exemplo, Espaço de trabalho padrão.

  4. Selecione Integrações e a configuração de integração necessária.

  5. Selecione Editor como a Função do Produto; em vez de Observer.

Detalhes armazenados para o Adobe I/O Integration Project

No console do Adobe I/O Projects você pode ver uma lista de todos os projetos de integração:

Selecione Visualização (à 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

Alguns deles, você precisará concluir a integração do Adobe I/O para o Público alvo no AEM.

Concluindo a configuração do IMS em AEM

Retornando ao AEM, é possível concluir a configuração do IMS adicionando os valores necessários da integração do Adobe I/O para o Público alvo:

  1. Retorne para Configuração IMS aberta em AEM.

  2. Selecione Próximo.

  3. Aqui você pode usar os detalhes do Adobe I/O:

    • Título: Seu texto.
    • Servidor de autorização: Copie/cole na "aud" linha da seção ​Payloadsection abaixo, por exemplo, "https://ims-na1.adobelogin.com" no exemplo abaixo
    • Chave da API: Copie isso da seção Visão geral da integração do Adobe I/O para o Público alvo
    • Segredo do cliente: Gere isso na seção Visão geral da integração do Adobe I/O para o Público alvo e copie
    • Carga: Copie-o da seção Gerar JWT da integração do Adobe I/O para o Público alvo

  4. Confirme com Create.

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

Confirmando a configuração do IMS

Para confirmar se 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 bem-sucedido, você verá a mensagem:

Configuração do Adobe Target Cloud Service

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

  1. Abra o menu Ferramentas. Em seguida, na seção Cloud Services, selecione Cloud Services herdados.

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

    A caixa de diálogo Criar Configuração será aberta.

  3. Insira um Title e, se desejar, um Nome (se deixado em branco, isso será gerado a partir do título).

    Você também pode selecionar o modelo necessário (se houver mais de um disponível).

  4. Confirme com Create.

    A caixa de diálogo Editar componente será aberta.

  5. Digite os detalhes na guia Configurações do Adobe Target:

    • Autenticação: IMS

    • ID do inquilino: a ID do locatário do Adobe IMS

      OBSERVAÇÃO

      Para o IMS este valor precisa ser retirado do próprio Público alvo. Você pode fazer logon no Público alvo e extrair a ID do locatário do URL.

      Por exemplo, se o URL for:

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

      Em seguida, você usaria yourtenantid.

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

    • Tipo de API: REST

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

    • Usar direcionamento preciso: Por padrão, essa caixa de seleção é selecionada. Se selecionada, a configuração do serviço de nuvem aguardará o contexto ser carregado antes de carregar o conteúdo. Veja a seguir.

    • Sincronizar segmentos do Adobe Target: Selecione essa opção para baixar segmentos definidos no Público alvo para 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 suportados e você sempre precisa usar os segmentos do Público alvo. (Observe que o termo AEM de "segment" equivale à "audiência" do Público alvo.)

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

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

    • AT.js personalizado: Deixe em branco se você tiver marcado a caixa Gerenciamento de tags ou para usar o padrão AT.js. Como alternativa, carregue seu AT.js personalizado. Será exibido somente se você tiver selecionado AT.js.

    OBSERVAÇÃO

    A configuração de um Cloud Service para usar a API do Público alvo Classic foi substituída (usa a guia Configurações do Adobe Recommendations).

    Por exemplo:

  6. Clique em Ligar ao Público alvo para inicializar a ligação ao Adobe Target.

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

  7. Selecione OK na mensagem, seguido por OK na caixa de diálogo para confirmar a configuração.

  8. Agora você pode ir para Adicionar uma Estrutura de Público alvo para configurar parâmetros ContextHub ou ClientContext que serão enviados para o Público alvo. Observe que isso pode não ser necessário para exportar AEM Fragmentos de experiência para o Público alvo.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free