Atualizar perfis do Adobe Experience Platform a partir de páginas de aterrissagem do Adobe Campaign ac-aep-lp
A integração entre o Adobe Campaign e o Adobe Experience Platform permite sincronizar facilmente os dados do perfil entre as páginas de aterrissagem do Adobe Campaign e o Adobe Experience Platform. Com essa integração, você pode:
- Recupere atributos de perfil do Adobe Experience Platform para exibir informações atualizadas nas páginas de aterrissagem do Adobe Campaign,
- Envie de volta os atributos de perfil atualizados para o Adobe Experience Platform para atualizar os atributos correspondentes com base no que foi preenchido e enviado nas landing pages.
As principais etapas para configurar essa integração são as seguintes:
Configurar uma conexão Oauth oauth
As APIs do Adobe Cloud Platform usam o protocolo OAuth 2.0 para autenticação e autorização. Para conectar o Adobe Experience Platform ao Adobe Campaign usando chamadas de API, é necessário gerar um token de acesso usando a Integração OAuth criada no Adobe Developer Console.
Para fazer isso, siga estes passos:
-
Acesse o Adobe Developer Console.
-
Crie uma nova conexão de API usando o produto Adobe Experience Platform API. As etapas detalhadas sobre como obter um token de acesso OAuth 2.0 estão disponíveis na documentação do Adobe Developer Console.
-
Depois que a conexão for criada, navegue até o menu OAuth Server-to-Server e copie os detalhes abaixo, que são necessários no Campaign para autenticação:
CLIENT ID
CLIENT SECRET
ORGANIZATION ID
Agora que sua conexão Oauth está configurada, crie e configure uma nova conexão do Source HTTP API para vincular o Adobe Campaign ao Adobe Experience Platform.
Criar uma conexão HTTP API Source source
Com a conexão OAuth estabelecida, a próxima etapa é criar uma conexão do Source HTTP API no Adobe Experience Platform. Essa conexão permite transmitir dados para o Adobe Experience Platform usando APIs. Siga estas etapas:
-
Navegue até Adobe Experience Platform Sources, pesquise a origem HTTP API e clique em Add data.
-
Configure a conexão de acordo com suas necessidades. Informações detalhadas sobre como configurar uma conexão HTTP API estão disponíveis na documentação de origens do Adobe Experience Platform.
Na etapa Authentication, alterne a opção Enable authentication para autenticar usando o token de acesso gerado anteriormente pela integração OAuth.
-
Depois que a conexão de origem é configurada, o endpoint de transmissão é exibido. Esse endpoint é necessário para assimilar dados na Adobe Experience Platform.
Você também pode acessar uma amostra do formato de dados assimilado na Adobe Experience Platform abrindo o fluxo de dados recém-criado na guia Dataflows.
Agora que a conexão HTTP API Source está configurada, é necessário adicionar opções específicas no Adobe Campaign para habilitar a conexão com o Adobe Experience Platform.
Adicionar opções de autenticação no Adobe Campaign xtk
Depois que a conexão HTTP API Source é configurada, é necessário adicionar opções específicas no Adobe Campaign para habilitar a conexão com o Adobe Experience Platform. Isso pode ser feito no menu Administração do Campaign ou ao executar o fluxo de trabalho da página de aterrissagem adicionando uma atividade JavaScript code específica.
Navegue pelas guias abaixo para descobrir os dois métodos:
-
Navegue até o menu Administration > Platform > Options.
-
Adicione as seguintes opções com os valores correspondentes do Adobe Developer Console:
- IMS_CLIENT_ID = cryptString(CLIENT ID)
- IMS_CLIENT_SECRET = cryptString(CLIENT SECRET)
- IMS_ORG_ID = ID DA ORGANIZAÇÃO
- IMS_CLIENT_API_KEY = cryptString(CLIENT ID)
note note NOTE A função cryptString() é usada para criptografar os dados de autenticação.
Para configurar essas opções automaticamente na execução do fluxo de trabalho de páginas de aterrissagem, adicione uma atividade JavaScript code ao fluxo de trabalho com o código abaixo. Saiba como configurar uma atividade de código JavaScript.
Na execução do workflow, as opções são criadas automaticamente no console do Campaign com os valores fornecidos.
code language-javascript |
---|
|
Agora que as opções de autenticação estão configuradas no Campaign, é necessário criar códigos JavaScript personalizados para permitir a sincronização de dados entre o Campaign e o Adobe Experience Platform a partir da página de destino.
Adicionar opções na execução do fluxo de trabalho javascript
Para permitir a sincronização de dados entre landing pages e o Adobe Experience Platform, códigos personalizados do JavaScript devem ser adicionados ao Adobe Campaign. Siga estas etapas:
-
Navegue até o menu Administration > Configuration > JavaScript codes.
-
Crie novos códigos JavaScript e copie e cole os trechos abaixo.
note note NOTE O token de acesso e os dados de autenticação são recuperados automaticamente das opções configuradas anteriormente.
Esse código verifica se o perfil existe no Adobe Experience Platform antes de carregar a landing page. Ele recupera os atributos do perfil e os exibe nos campos correspondentes da landing page.
code language-javascript |
---|
|
Esse código atualiza os atributos de perfil no Adobe Experience Platform com os valores enviados na landing page.
code language-javascript |
---|
|
Agora que os códigos personalizados do JavaScript são criados no Adobe Campaign, você pode configurar o fluxo de trabalho que contém sua página de aterrissagem para usar esses códigos JavaScript para sincronização de dados.
Configurar o fluxo de trabalho da landing page script
Com os códigos JavaScript adicionados ao Adobe Campaign, você pode aproveitá-los no fluxo de trabalho da página de aterrissagem usando JavaScript code atividades:
- Para carregar dados do Experience Platform antes de carregar a landing page, adicione uma atividade JavaScript code antes da atividade da landing page e copie e cole o Script 1.
code language-javascript |
---|
|
- Para atualizar atributos de perfil de Experience Platform com os dados enviados na página de aterrissagem, adicione uma atividade JavaScript code após a atividade de página de aterrissagem e copie e cole o Script 2.
code language-javascript |
---|
|
Este é um exemplo de fluxo de trabalho usando as atividades de código JavaScript antes e depois de uma página de aterrissagem:
Este é um exemplo de uma página de aterrissagem e uma atividade de código JavaScript configuradas para atualizar atributos de perfil no Adobe Experience Platform: