2.3.6 SDK de destinos
Configurar o projeto do Adobe I/O
Neste exercício, você usará o Adobe I/O novamente para consultar as APIs da Adobe Experience Platform. Se você ainda não tiver configurado seu projeto do Adobe I/O, volte para o Exercício 3 no Módulo 2.1 e siga as instruções lá.
Autenticação para o Adobe I/O
Neste exercício, você usará o Postman novamente para consultar as APIs da Adobe Experience Platform. Se você ainda não tiver configurado seu aplicativo Postman, volte para o Exercício 3 no Módulo 2.1 e siga as instruções lá.
Definir ponto de extremidade e formato
Para este exercício, será necessário configurar um endpoint para que, quando um público-alvo se qualificar, o evento de qualificação possa ser transmitido para esse endpoint. Neste exercício, você usará um terminal de exemplo usando https://pipedream.com/requestbin. Vá para https://pipedream.com/requestbin, crie uma conta e um espaço de trabalho. Depois que o espaço de trabalho for criado, você verá algo semelhante a isso.
Clique em copiar para copiar a url. Você precisará especificar esse url no próximo exercício. A URL neste exemplo é https://eodts05snjmjz67.m.pipedream.net.
Quanto ao formato, usaremos um modelo padrão que transmitirá as qualificações ou não qualificações do público-alvo junto com metadados como identificadores de clientes. Os modelos podem ser personalizados para atender às expectativas de endpoints específicos, mas neste exercício reutilizaremos um modelo padrão, o que resultará em uma carga como essa que será transmitida para o endpoint.
{
"profiles": [
{
"identities": [
{
"type": "ecid",
"id": "64626768309422151580190219823409897678"
}
],
"AdobeExperiencePlatformSegments": {
"add": [
"f58c723c-f1e5-40dd-8c79-7bb4ab47f041"
],
"remove": []
}
}
]
}
Criar uma configuração de servidor e modelo
A primeira etapa para criar seu próprio Destino no Adobe Experience Platform é criar uma configuração de servidor e modelo usando o Postman.
Para fazer isso, abra o aplicativo Postman e vá para API de Criação de Destino, para Servidores e modelos de destino e clique para abrir a solicitação POST - Criar uma configuração de servidor de destino.
Você verá isso. Em Cabeçalhos, é necessário atualizar manualmente o valor da chave x-sandbox-name e defini-lo como --aepSandboxName--. Selecione o valor {{SANDBOX_NAME}}.
Substituir por --aepSandboxName--.
Em seguida, vá para Corpo. selecione o espaço reservado {{body}}.
Agora é necessário substituir o espaço reservado {{body}} pelo código abaixo:
{
"name": "Custom HTTP Destination",
"destinationServerType": "URL_BASED",
"urlBasedDestination": {
"url": {
"templatingStrategy": "PEBBLE_V1",
"value": "yourURL"
}
},
"httpTemplate": {
"httpMethod": "POST",
"requestBody": {
"templatingStrategy": "PEBBLE_V1",
"value": "{\n \"profiles\": [\n {%- for profile in input.profiles %}\n {\n \"identities\": [\n {%- for idMapEntry in profile.identityMap -%}\n {%- set namespace = idMapEntry.key -%}\n {%- for identity in idMapEntry.value %}\n {\n \"type\": \"{{ namespace }}\",\n \"id\": \"{{ identity.id }}\"\n }{%- if not loop.last -%},{%- endif -%}\n {%- endfor -%}{%- if not loop.last -%},{%- endif -%}\n {% endfor %}\n ],\n \"AdobeExperiencePlatformSegments\": {\n \"add\": [\n {%- for segment in profile.segmentMembership.ups | added %}\n \"{{ segment.key }}\"{%- if not loop.last -%},{%- endif -%}\n {% endfor %}\n ],\n \"remove\": [\n {#- Alternative syntax for filtering segments by status: -#}\n {% for segment in removedSegments(profile.segmentMembership.ups) %}\n \"{{ segment.key }}\"{%- if not loop.last -%},{%- endif -%}\n {% endfor %}\n ]\n }\n }{%- if not loop.last -%},{%- endif -%}\n {% endfor %}\n ]\n}"
},
"contentType": "application/json"
}
}
Depois de colar o código acima, você precisa atualizar manualmente o campo urlBasedDestination.url.value e defini-lo para a url do webhook criado na etapa anterior, que era https://eodts05snjmjz67.m.pipedream.net neste exemplo.
Depois de atualizar o campo urlBasedDestination.url.value, ele deve ficar assim. Clique em Enviar.
access_token válido. Para obter um access_token válido, execute a solicitação POST - Obter Token de Acesso na coleção Adobe IO - OAuth.Depois de clicar em Enviar, seu modelo de servidor será criado e, como parte da resposta, você verá um campo chamado instanceId. Anote-o, como você precisará dele na próxima etapa. Neste exemplo, a instanceId é52482c90-8a1e-42fc-b729-7f0252e5cebd.
Criar sua configuração de destino
No Postman, em API de Criação de Destino, vá para Configurações de destino e clique para abrir a solicitação POST - Criar uma configuração de destino. Você verá isso. Em Cabeçalhos, é necessário atualizar manualmente o valor da chave x-sandbox-name e defini-lo como --aepSandboxName--. Selecione o valor {{SANDBOX_NAME}} e substitua-o por --aepSandboxName--.
Em seguida, vá para Corpo. selecione o espaço reservado {{body}}.
Agora é necessário substituir o espaço reservado {{body}} pelo código abaixo:
{
"name": "--aepUserLdap-- - Webhook",
"description": "Exports segment qualifications and identities to a custom webhook via Destination SDK.",
"status": "TEST",
"customerAuthenticationConfigurations": [
{
"authType": "BEARER"
}
],
"customerDataFields": [
{
"name": "endpointsInstance",
"type": "string",
"title": "Select Endpoint",
"description": "We could manage several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
"isRequired": true,
"enum": [
"US",
"EU",
"APAC",
"NZ"
]
}
],
"uiAttributes": {
"documentationLink": "https://experienceleague.adobe.com/docs/experience-platform/destinations/home.html?lang=pt-BR",
"category": "streaming",
"connectionType": "Server-to-server",
"frequency": "Streaming"
},
"identityNamespaces": {
"ecid": {
"acceptsAttributes": true,
"acceptsCustomNamespaces": false
}
},
"segmentMappingConfig": {
"mapExperiencePlatformSegmentName": true,
"mapExperiencePlatformSegmentId": true,
"mapUserInput": false
},
"aggregation": {
"aggregationType": "BEST_EFFORT",
"bestEffortAggregation": {
"maxUsersPerRequest": "1000",
"splitUserById": false
}
},
"schemaConfig": {
"profileRequired": false,
"segmentRequired": true,
"identityRequired": true
},
"destinationDelivery": [
{
"authenticationRule": "NONE",
"destinationServerId": "yourTemplateInstanceID"
}
]
}
Depois de colar o código acima, é necessário atualizar manualmente o campo destinationDelivery. destinationServerId, e você precisa defini-lo como instanceId do modelo de servidor de destino que você criou na etapa anterior, que era 52482c90-8a1e-42fc-b729-7f0252e5cebd neste exemplo. Em seguida, clique em Enviar.
Você verá essa resposta.
Seu destino foi criado no Adobe Experience Platform. Vamos lá verificar.
Ir para Adobe Experience Platform. Depois de fazer logon, você chegará à página inicial do Adobe Experience Platform.
Antes de continuar, você precisa selecionar uma sandbox. A sandbox a ser selecionada é chamada --aepSandboxName--. Depois de selecionar a sandbox apropriada, você verá a alteração da tela e agora estará na sandbox dedicada.
No menu esquerdo, vá para Destinos, clique em Catálogo e role para baixo até a categoria Streaming. Você verá seu destino disponível lá agora.
Vincular o público ao destino
Em Destinos > Catálogo, clique em Configurar no seu destino para começar a adicionar públicos ao novo destino.
Insira um valor aleatório para o token do portador, como 1234. Clique em Conectar ao destino.
Você verá isso. Como um nome para o seu destino, use --aepUserLdap-- - Webhook. Selecione um endpoint de escolha, neste exemplo EU. Clique em Next.
Opcionalmente, é possível selecionar uma política de governança de dados. Clique em Next.
Selecione o público-alvo criado anteriormente, chamado --aepUserLdap-- - Interest in Galaxy S24. Clique em Next.
Você verá isso. Mapeie o CAMPO DO SOURCE --aepTenantId--.identification.core.ecid para o campo Identity: ecid. Clique em Next.
Clique em Concluir.
Seu destino agora está ativo, as novas qualificações de público-alvo serão transmitidas para seu webhook personalizado agora.
Testar a ativação do público
Ir para https://dsn.adobe.com. Depois de fazer logon com sua Adobe ID, você verá isso. Clique nos 3 pontos … do projeto do site e clique em Executar para abri-lo.
Você verá seu site de demonstração aberto. Selecione o URL e copie-o para a área de transferência.
Abra uma nova janela incógnita do navegador.
Cole o URL do site de demonstração que você copiou na etapa anterior. Você será solicitado a fazer logon usando sua Adobe ID.
Selecione o tipo de conta e conclua o processo de logon.
Em seguida, você verá seu site carregado em uma janela incógnita do navegador. Para cada exercício, será necessário usar uma janela do navegador nova e incógnita para carregar o URL do site de demonstração.
Neste exemplo, você deseja responder a um cliente específico que exibe um produto específico.
Na página inicial do Citi Signal, vá para Telefones e dispositivos e clique no produto Galaxy S24.
A página do produto do Galaxy S24 foi visualizada, portanto, seu público se qualificará para o seu perfil nos minutos seguintes.
Ao abrir o Visualizador de Perfis e acessar Públicos-alvo, você verá o público-alvo qualificado.
Agora volte para o webhook aberto em https://eodts05snjmjz67.m.pipedream.net, em que você deve ver uma nova solicitação de entrada, originada no Adobe Experience Platform e que contém o evento de qualificação de público-alvo.
Próximas etapas
Ir para Resumo e benefícios
Voltar para a CDP em tempo real - Criar um público-alvo e executar ações
Voltar para Todos os módulos