Criar uma conexão de origem e um fluxo de dados para transmitir dados do LAVA usando a interface
Siga este guia passo a passo para ajudar você a configurar seu próprio conector de origem do LAVA na interface do usuário do Experience Platform.
Introdução
Este tutorial requer uma compreensão funcional dos seguintes componentes do Experience Platform:
-
Experience Data Model (XDM) Sistema: a estrutura padronizada pela qual o Experience Platform organiza os dados de experiência do cliente.
- Noções básicas sobre a composição de esquema: saiba mais sobre os blocos de construção básicos de esquemas XDM, incluindo princípios-chave e práticas recomendadas na composição de esquema.
- Tutorial do Editor de esquemas: saiba como criar esquemas personalizados usando a interface do Editor de esquemas.
-
Real-Time Customer Profile: Fornece um perfil de consumidor unificado em tempo real com base em dados agregados de várias fontes.
Conectar sua conta do LAVA
Na interface do usuário do Experience Platform, selecione Fontes na barra de navegação esquerda para acessar o espaço de trabalho Fontes. A tela Catálogo exibe uma variedade de fontes com as quais você pode criar uma conta.
Você pode selecionar a categoria apropriada no catálogo no lado esquerdo da tela. Como alternativa, você pode encontrar a fonte específica com a qual deseja trabalhar usando a opção de pesquisa.
Na categoria Streaming, selecione LAVA e Adicionar dados.
Selecionar dados
A etapa Selecionar dados é exibida, fornecendo uma interface para que você selecione os dados que trará para a Platform.
- A parte esquerda da interface é um navegador que permite visualizar os fluxos de dados disponíveis em sua conta;
- A parte direita da interface permite visualizar até 100 linhas de dados de um arquivo JSON.
Selecione Carregar arquivos para carregar um arquivo JSON do sistema local ou carregar o arquivo de amostra da seção Visão geral correspondente ao conjunto de dados que você está configurando. Como alternativa, você pode arrastar e soltar o arquivo JSON que deseja carregar no painel Arrastar e soltar arquivos.
Depois que o arquivo for carregado, a interface de visualização será atualizada para exibir uma visualização do esquema carregado. A interface de visualização permite inspecionar o conteúdo e a estrutura de um arquivo. Você também pode usar o utilitário Campo de pesquisa para acessar itens específicos de dentro do esquema.
Quando terminar, selecione Próximo.
Detalhes do fluxo de dados
A etapa Detalhes do fluxo de dados é exibida, fornecendo opções para usar um conjunto de dados existente ou estabelecer um novo para o fluxo de dados, bem como uma oportunidade de fornecer um nome e uma descrição para o fluxo de dados. Durante essa etapa, você também pode definir configurações para Assimilação de perfil, diagnóstico de erro, assimilação parcial e alertas.
Quando terminar, selecione Próximo.
Mapeamento
A etapa Mapeamento é exibida, fornecendo uma interface para mapear os campos do esquema de origem para os campos XDM de destino apropriados no esquema de destino.
Ao usar o esquema fornecido de LAVA, use o seguinte mapeamento recomendado:
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto | |
|---|---|
| Campo do Conector do Source LAVA | Campo de esquema de perfil LAVA |
lavaId |
_tenant.lavaId |
firstName |
person.name.firstName |
lastName |
person.name.lastName |
email |
personalEmail.address |
phone |
mobilePhone.number |
| table 0-row-2 1-row-2 2-row-2 layout-auto | |
|---|---|
| Campo do Conector do Source LAVA | Campo de esquema de perfil LAVA |
lavaId |
_tenant.lavaId |
balances[] |
_tenant.balances[] |
| 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 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2 20-row-2 21-row-2 22-row-2 23-row-2 24-row-2 25-row-2 26-row-2 27-row-2 28-row-2 layout-auto | |
|---|---|
| Campo do Conector do Source LAVA | Campo de esquema de evento LAVA |
campo calculado to_map("LavaId",to_array(false,to_object("id",lavaId,"primary",true))) |
identityMap |
type |
eventType |
timestamp |
timestamp |
eventId |
_tenant.ticketScan.eventId |
eventName |
_tenant.ticketScan.eventName |
eventLabel |
_tenant.ticketScan.eventLabel |
venue |
_tenant.ticketScan.venue |
venueLabel |
_tenant.ticketScan.venueLabel |
section |
_tenant.ticketScan.section |
sectionLabel |
_tenant.ticketScan.sectionLabel |
row |
_tenant.ticketScan.row |
seat |
_tenant.ticketScan.seat |
gate |
_tenant.ticketScan.gate |
gateLabel |
_tenant.ticketScan.gateLabel |
transactionId |
_tenant.transaction.transactionId |
referenceId |
_tenant.transaction.referenceId |
subtotal |
_tenant.transaction.subtotal |
total |
_tenant.transaction.total |
location |
_tenant.transaction.location |
items[] |
_tenant.transaction.items[] |
redeemedAmount |
_tenant.transaction.redeemedAmount |
rewardsApplied[] |
_tenant.transaction.rewardsApplied[] |
amount |
_tenant.ledger.amount |
expiresAt |
_tenant.ledger.expiresAt |
rewardId |
_tenant.ledger.rewardId |
rewardName |
_tenant.ledger.rewardName |
rewardSlug |
_tenant.ledger.rewardSlug |
rewardType |
_tenant.ledger.rewardType |
| 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 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 layout-auto | |
|---|---|
| Campo do Conector do Source LAVA | Campo de esquema de evento LAVA |
campo calculado to_map("LavaId",to_array(false,to_object("id",lavaId,"primary",true))) |
identityMap |
eventId |
_tenant.ticketScan.eventId |
eventName |
_tenant.ticketScan.eventName |
eventLabel |
_tenant.ticketScan.eventLabel |
venue |
_tenant.ticketScan.venue |
venueLabel |
_tenant.ticketScan.venueLabel |
section |
_tenant.ticketScan.section |
sectionLabel |
_tenant.ticketScan.sectionLabel |
row |
_tenant.ticketScan.row |
seat |
_tenant.ticketScan.seat |
gate |
_tenant.ticketScan.gate |
gateLabel |
_tenant.ticketScan.gateLabel |
type |
eventType |
timestamp |
timestamp |
| 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 9-row-2 10-row-2 11-row-2 layout-auto | |
|---|---|
| Campo do Conector do Source LAVA | Campo de esquema de evento LAVA |
campo calculado to_map("LavaId",to_array(false,to_object("id",lavaId,"primary",true))) |
identityMap |
transactionId |
_tenant.transaction.transactionId |
referenceId |
_tenant.transaction.referenceId |
subtotal |
_tenant.transaction.subtotal |
total |
_tenant.transaction.total |
location |
_tenant.transaction.location |
items[] |
_tenant.transaction.items[] |
redeemedAmount |
_tenant.transaction.redeemedAmount |
rewardsApplied[] |
_tenant.transaction.rewardsApplied[] |
type |
eventType |
timestamp |
timestamp |
| 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 9-row-2 layout-auto | |
|---|---|
| Campo do Conector do Source LAVA | Campo de esquema de evento LAVA |
campo calculado to_map("LavaId",to_array(false,to_object("id",lavaId,"primary",true))) |
identityMap |
amount |
_tenant.ledger.amount |
expiresAt |
_tenant.ledger.expiresAt |
rewardId |
_tenant.ledger.rewardId |
rewardName |
_tenant.ledger.rewardName |
rewardSlug |
_tenant.ledger.rewardSlug |
rewardType |
_tenant.ledger.rewardType |
type |
eventType |
timestamp |
timestamp |
Como alternativa, você pode ajustar manualmente as regras de mapeamento para atender aos seus casos de uso. Com base nas suas necessidades, você pode optar por mapear campos diretamente ou usar funções de preparação de dados para transformar dados de origem para derivar valores calculados ou calculados. Para obter etapas abrangentes sobre como usar a interface do mapeador e campos calculados, consulte o Guia da Interface do Preparo de Dados.
Depois que os dados de origem forem mapeados com êxito, selecione Próximo.
Revisar
A etapa Revisão é exibida, permitindo que você revise seu novo fluxo de dados antes de ele ser criado. Os detalhes são agrupados nas seguintes categorias:
- Conexão: mostra o tipo de origem, o caminho relevante do arquivo de origem escolhido e o número de colunas nesse arquivo de origem.
- Atribuir campos de conjunto de dados e mapa: mostra em qual conjunto de dados os dados de origem estão sendo assimilados, incluindo o esquema ao qual o conjunto de dados pertence.
Depois de revisar o fluxo de dados, selecione Concluir e aguarde algum tempo para que o fluxo de dados seja criado.
Obter o URL do ponto de extremidade de transmissão e a ID do fluxo de dados
Com o fluxo de dados de transmissão criado, agora é possível recuperar o URL do ponto de extremidade de transmissão e a ID do fluxo de dados. Eles serão usados para configurar o LAVA, permitindo que a fonte de streaming se comunique com o Experience Platform.
Para recuperar o ponto de extremidade de streaming, vá para a página Atividade de fluxo de dados do fluxo de dados que você acabou de criar e copie o ponto de extremidade da parte inferior do painel Propriedades.
Integrar o LAVA ao seu webhook
No Console LAVA, navegue até Resources > Data Export.
Selecione Create New Export e escolha Adobe Source Connector como o tipo de destino. Em seguida, selecione os dados de origem que deseja enviar e insira o URL do ponto final de transmissão junto com a ID do fluxo de dados.
