Pesquisar atributos de perfil na borda em tempo real
A Adobe Experience Platform usa o Perfil de cliente em tempo real como a única fonte da verdade para todos os dados de perfil. Para recuperação rápida de dados em tempo real, ele usa perfis de borda, que são perfis leves distribuídos pela Edge Network. Isso permite casos de uso de personalização rápidos e em tempo real.
Casos de uso use-cases
Abaixo estão dois casos de uso em que a pesquisa de perfil de borda pode ajudar.
- Real-Time Personalization: recupere rapidamente informações de perfil do perfil de borda para personalizar a experiência de um usuário em seu site.
- Suporte ao Cliente: recupere informações de perfil em tempo real quando um cliente ligar para um agente da central de suporte.
Esta página descreve as etapas que você deve seguir para pesquisar dados do perfil de borda em tempo real, fornecer experiências de personalização ou informar regras de decisão por meio de aplicativos downstream.
Terminologia e pré-requisitos prerequisites
Ao configurar o caso de uso descrito nesta página, você usará os seguintes componentes da plataforma:
- Datastreams: uma sequência de dados recebe dados de evento do Web SDK e responde com dados de perfil de borda.
- Políticas de Mesclagem: você criará uma política de mesclagem do Ative-On-Edge para garantir que os perfis de borda usem os dados de perfil corretos.
- Conexão personalizada com o Personalization: você configurará uma nova conexão personalizada que enviará os atributos do perfil para o Edge Network.
- API do Edge Network: você usará a funcionalidade coleção de dados interativa da API do Edge Network para recuperar rapidamente atributos de perfil dos perfis de borda.
Medidas de proteção de desempenho guardrails
Os casos de uso de pesquisa de perfil do Edge estão sujeitos às medidas de proteção de desempenho específicas descritas na tabela abaixo. Para obter mais detalhes sobre as medidas de proteção da API do Edge Network, consulte as medidas de proteção página de documentação.
Etapa 1: Criar e configurar um fluxo de dados create-datastream
Siga as etapas na documentação da configuração da sequência de dados para criar uma nova sequência de dados com as seguintes configurações de Serviço:
-
Serviço: Adobe Experience Platform
-
Destinos do Personalization: Habilitado
-
Segmentação do Edge: se você precisar de segmentação de borda, habilite esta opção. Se você estiver interessado apenas em pesquisar atributos de perfil na borda, mas não quiser executar nenhuma segmentação com base nos perfis de borda, deixe essa opção desativada.
Etapa 2: configurar os públicos-alvo para avaliação de borda audience-edge-evaluation
A pesquisa de atributos de perfil na borda exige que os públicos-alvo sejam configurados para avaliação de borda.
Verifique se os públicos que você planeja ativar têm a Política de mesclagem ativa no Edge definida como padrão. A política de mesclagem do Active-On-Edge garante que os públicos-alvo sejam avaliados constantemente na borda e estejam disponíveis para casos de uso de personalização em tempo real.
Siga as instruções em criando uma política de mesclagem e habilite a Política de mesclagem Ative-On-Edge.
Etapa 3: enviar dados do atributo de perfil para a Edge Network configure-custom-personalization-connection
Para pesquisar perfis de borda, incluindo atributos e dados de associação de público-alvo, em tempo real, os dados precisam ser disponibilizados na Edge Network. Para isso, você deve criar uma conexão com um destino Personalization Personalizado com Atributos e ativar os públicos, incluindo os atributos que você gostaria de pesquisar nos perfis de borda.
Siga o tutorial de criação de conexão de destino para obter instruções detalhadas sobre como criar uma nova conexão de destino.
Ao configurar o novo destino, selecione a sequência de dados que você criou na etapa 1 no campo ID da sequência de dados. Para o Alias de integração, você pode usar qualquer valor que o ajude a identificar essa conexão de destino no futuro, como o nome de destino.
Depois de criar uma conexão Personalization Personalizada com Atributos, você estará pronto para enviar dados de perfil para a Edge Network.
| note important |
|---|
| IMPORTANT |
|
| Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias. |
-
Vá para Conexões > Destinos e selecione a guia Catálogo.
-
Localize o cartão de destino Personalization Personalizado com Atributos e selecione Ativar públicos-alvo, conforme mostrado na imagem abaixo.
-
Selecione a conexão de destino configurada anteriormente e selecione Avançar.
-
Selecione seus públicos-alvo. Use as caixas de seleção à esquerda dos nomes de público-alvo para selecionar os públicos que você deseja ativar para o destino e selecione Próximo.
Você pode selecionar entre vários tipos de públicos-alvo, dependendo de sua origem:
-
Serviço de segmentação: públicos-alvo gerados no Experience Platform pelo serviço de segmentação. Consulte a documentação de segmentação para obter mais detalhes.
-
Upload personalizado: públicos-alvo gerados fora do Experience Platform e carregados na Platform como arquivos CSV. Para saber mais sobre públicos-alvo externos, consulte a documentação sobre importação de um público-alvo.
-
Outros tipos de públicos-alvo, originados de outras soluções da Adobe, como o Audience Manager.
-
-
Selecione os atributos de perfil que você deseja disponibilizar para os perfis de borda.
-
Selecionar atributos de origem. Para adicionar atributos de origem, selecione o controle Adicionar novo campo na coluna Campo do Source e pesquise ou navegue até o campo de atributo XDM desejado, conforme mostrado abaixo.
-
Selecionar atributos de destino. Para adicionar atributos de destino, selecione o controle Adicionar novo campo na coluna Campo de destino e digite o nome do atributo personalizado para o qual você deseja mapear o atributo de origem.
-
Quando terminar de mapear os atributos do perfil, selecione Avançar.
Na página Revisão, você pode ver um resumo da sua seleção. Selecione Cancelar para interromper o fluxo, Voltar para modificar as configurações ou Concluir para confirmar a seleção e começar a enviar dados de perfil para a Edge Network.
Se sua organização adquiriu o Adobe Healthcare Shield ou o Adobe Privacy & Security Shield, selecione Exibir políticas de consentimento aplicáveis para ver quais políticas de consentimento são aplicadas e quantos perfis são incluídos na ativação como resultado delas. Leia sobre avaliação de política de consentimento para obter mais informações.
Verificações de política de uso de dados
Na etapa Revisão, a Experience Platform também verifica se há violações de política de uso de dados. Veja abaixo um exemplo de violação de uma política. Não é possível concluir o fluxo de trabalho de ativação de público-alvo até que a violação seja resolvida. Para obter informações sobre como resolver violações de política, leia sobre violações de política de uso de dados na seção de documentação sobre governança de dados.
Na etapa Revisão, é possível usar os filtros disponíveis na página para exibir apenas os públicos-alvo cujo agendamento ou mapeamento foi atualizado como parte deste fluxo de trabalho. Você também pode alternar quais colunas da tabela deseja visualizar.
Se você estiver satisfeito com a sua seleção e nenhuma violação de política tiver sido detectada, selecione Concluir para confirmar a seleção.
Etapa 4: pesquisar os atributos do perfil na borda configure-edge-profile-lookup
Agora você já deve ter concluído a configuração da sua sequência de dados, você criou uma nova conexão de destino Personalization Personalizada com Atributos e usou essa conexão para enviar os atributos de perfil que você poderá pesquisar na Edge Network.
A próxima etapa é configurar sua solução de personalização para recuperar atributos de perfil dos perfis de borda.
Se você não seguir os requisitos acima, a personalização será baseada somente na associação ao público-alvo e os atributos de perfil não estarão disponíveis para você.
A sequência de dados configurada na etapa 1 agora está pronta para aceitar dados de eventos de entrada e responder com informações de perfil de borda.
Configure sua integração para recuperar informações de perfil de borda conforme mostrado nos exemplos abaixo.
Solicitação request
Para recuperar dados do perfil de borda, envie uma chamada POST vazia para o ponto de extremidade /interact, com a identidade principal para a qual você está procurando os atributos de perfil incluídos no evento, conforme mostrado abaixo.
curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
"event":
{
"xdm": {
"identityMap": {
"Email": [
{
"id":"test123@adobetest.com",
"primary":true
}
]
}
}
}
}'
Resposta response
Uma resposta bem-sucedida retorna o status HTTP 200 OK, com um objeto Handle que inclui informações semelhantes aos exemplos nas guias abaixo, dependendo se o perfil é encontrado na borda ou não.
handle pode incluir vários objetos payload de vários tipos. As informações relacionadas à pesquisa de perfil de borda estão agrupadas sob o objeto payload com "type": "activation:pull",Se o perfil existir na borda, dependendo dos atributos e públicos-alvo do perfil ativados para a borda, você pode esperar uma resposta com atributos e associações de público-alvo semelhantes à abaixo.
| code language-json |
|---|
|
O objeto handle fornece as informações descritas na tabela abaixo.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 | |
|---|---|
| Parâmetro | Descrição |
payload |
O objeto payload que inclui as informações de pesquisa de borda. A resposta pode conter vários objetos payload adicionais, não relacionados à pesquisa de borda. |
type |
As cargas são agrupadas na resposta por seu tipo. O tipo de carga para a pesquisa de perfil de borda é sempre definido como profileLookup. |
destinationId |
A ID da instância de conexão do Personalization personalizada que você criou na etapa 3. |
alias |
O alias da conexão de destino, configurado pelo usuário quando ele cria a conexão de destino do Personalization Personalizado. |
attributes |
Esta matriz inclui os atributos do perfil de borda dos públicos ativados na etapa 3. |
segments |
Esta matriz inclui os públicos ativados na etapa 3. |
type |
handle objetos são agrupados por tipo. Para casos de uso de pesquisa de perfil de borda, o tipo do objeto handle é sempre activation:pull. |
eventIndex |
O Edge Network recebe eventos do cliente na forma de arrays. A ordem dos eventos na matriz é preservada durante o processamento e refletida por esse índice. A indexação do evento começa com 0. |
Se o perfil não existir na borda, você pode esperar uma resposta semelhante à abaixo.
| code language-json |
|---|
|
O objeto handle fornece as informações descritas na tabela abaixo.
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parâmetro | Descrição |
payload |
Quando o perfil não está presente na borda, o objeto payload fica vazio. |
type |
payload objetos são agrupados por tipo. Para casos de uso de pesquisa de perfil de borda, o tipo do objeto payload é sempre activation:pull. |
eventIndex |
O Edge Network recebe eventos do cliente na forma de arrays. A ordem dos eventos na matriz é preservada durante o processamento e refletida por esse índice. A indexação do evento começa com 0. |
Conclusão conclusion
Seguindo as etapas acima, você pode pesquisar com eficiência atributos de perfil de borda em tempo real, permitindo experiências personalizadas e tomada de decisão informada por meio de aplicativos de downstream.