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.
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.
Antes de iniciar este procedimento:
O Suporte da Adobe precisa provisionar sua conta com:
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.
O primeiro estágio da configuração é criar uma configuração do IMS no AEM e gerar a Chave pública.
No AEM, abra o menu Ferramentas.
Na seção Segurança, selecione Configurações do Adobe IMS.
Selecione Criar para abrir a Configuração de contas técnicas do Adobe IMS.
Usando a lista suspensa em Configuração na nuvem, selecione Adobe Target.
Ative Criar novo certificado e insira um novo alias.
Confirme com Criar certificado.
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.
Mantenha essa configuração aberta; ela será necessária novamente para Concluir a configuração do IMS no 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.
Abra o Adobe Developer Console para criar um Projeto com o Adobe Target que o AEM usará:
Abra os projetos do Adobe Developer Console:
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.
Selecione Adicionar ao projeto e, em seguida, API:
Selecione Adobe Target e, em seguida, Próximo:
Se você estiver inscrito no Adobe Target, mas não o vir listado, verifique a Pré-requisitos.
Fazer upload de sua chave pública, e quando terminar, continue com Próximo:
Revise as credenciais e continue com Próximo:
Selecione os perfis de produto necessários e continue com Salvar API configurada:
Os perfis de produto que são exibidos dependem se você:
A criação será confirmada.
Agora, você deve atribuir os privilégios necessários à integração:
Abra o Adobe Admin Console:
Navegue até Produtos (barra de ferramentas superior) e, em seguida, selecione Adobe Target - <seu-id-de-locatário> (no painel esquerdo).
Selecione Perfis de produto e, em seguida, o espaço de trabalho necessário. Por exemplo, Espaço de trabalho padrão.
Selecione Credenciais da API e, em seguida, a configuração de integração necessária.
Selecione Editor como Função do produto, em vez de Observador.
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:
Em alguns desses, você precisará concluir a integração do Adobe Target no AEM com base no IMS.
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:
Retorne à configuração do IMS aberta no AEM.
Selecione Próximo.
Aqui, é possível usar os detalhes da configuração do projeto no Console do Desenvolvedor da Adobe:
aud
da seção Carga abaixo; por exemplo, https://ims-na1.adobelogin.com
no exemplo abaixoConfirme com Criar.
Sua configuração do Adobe Target será exibida no console do AEM.
Para confirmar que a configuração está funcionando como esperado:
Abrir:
https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html
Por exemplo:
https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
Selecione sua configuração.
Selecione Verificar integridade na barra de ferramentas, seguido por Verificar.
Se for bem-sucedido, você verá a mensagem:
A configuração agora pode ser referenciada para um Cloud Service usar a API do Target Standard:
Abra o Ferramentas menu. Em seguida, no prazo de Cloud Services , selecione Cloud Services herdados.
Role para baixo até Adobe Target e selecione Configurar agora.
A variável Criar configuração será aberta.
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).
Confirme com Criar.
A variável Editar componente será aberta.
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.
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.
Configuração de um Cloud Service para usar a API do Target Classic foi descontinuado (usa a guia Configurações do Adobe Recommendations ).
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.
Selecionar OK na mensagem, seguido por OK no diálogo para confirmar a configuração.
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.
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:
Em ambos os casos, esteja ciente de que:
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.
Se quiser alterar uma Configuração do Target existente: