Crear una conexión de origen y un flujo de datos para transmitir datos de LAVA mediante la interfaz de usuario
Siga esta guía paso a paso para configurar su propio conector de origen de LAVA en la interfaz de usuario de Experience Platform.
Introducción
Este tutorial requiere una comprensión práctica de los siguientes componentes de Experience Platform:
-
Experience Data Model (XDM) Sistema: El marco estandarizado mediante el cual Experience Platform organiza los datos de experiencia del cliente.
- Aspectos básicos de la composición de esquemas: obtenga información sobre los componentes básicos de los esquemas XDM, incluidos los principios clave y las prácticas recomendadas en la composición de esquemas.
- Tutorial del editor de esquemas: Aprenda a crear esquemas personalizados mediante la interfaz de usuario del editor de esquemas.
-
Real-Time Customer Profile: proporciona un perfil de consumidor unificado y en tiempo real basado en los datos agregados de varias fuentes.
Conectar su cuenta de LAVA
En la interfaz de usuario de Experience Platform, seleccione Fuentes en la barra de navegación izquierda para acceder al área de trabajo de Fuentes. La pantalla Catálogo muestra una variedad de orígenes con los que puede crear una cuenta.
Puede seleccionar la categoría adecuada del catálogo en la parte izquierda de la pantalla. También puede encontrar la fuente específica con la que desea trabajar utilizando la opción de búsqueda.
En la categoría Transmisión, seleccione LAVA y, a continuación, seleccione Agregar datos.
Seleccionar datos
Aparecerá el paso Seleccionar datos, que proporciona una interfaz para que pueda seleccionar los datos que trae a Platform.
- La parte izquierda de la interfaz es un explorador que le permite ver los flujos de datos disponibles en su cuenta;
- La parte derecha de la interfaz de le permite previsualizar hasta 100 filas de datos de un archivo JSON.
Seleccione Cargar archivos para cargar un archivo JSON desde su sistema local o cargue el archivo de muestra desde la sección Información general correspondiente al conjunto de datos que está configurando. También puede arrastrar y soltar el archivo JSON que desee cargar en el panel Arrastrar y soltar archivos.
Una vez cargado el archivo, la interfaz de vista previa se actualiza para mostrar una vista previa del esquema cargado. La interfaz de vista previa permite inspeccionar el contenido y la estructura de un archivo. También puede usar la utilidad Campo de búsqueda para acceder a elementos específicos desde el esquema.
Cuando termine, seleccione Siguiente.
Detalles del flujo de datos
Aparecerá el paso Detalle del flujo de datos, que le proporcionará opciones para usar un conjunto de datos existente o establecer uno nuevo para su flujo de datos, así como la oportunidad de proporcionar un nombre y una descripción para su flujo de datos. Durante este paso, también puede configurar las opciones de Ingesta de perfiles, diagnósticos de error, ingesta parcial y alertas.
Cuando termine, seleccione Siguiente.
Asignación
Aparecerá el paso Mapping, que le proporcionará una interfaz para asignar los campos del esquema de origen a sus campos XDM de destino adecuados en el esquema de destino.
Cuando use el esquema proporcionado por LAVA, use la siguiente asignación recomendada:
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto | |
|---|---|
| LAVA campo del conector de Source | 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 | |
|---|---|
| LAVA campo del conector de Source | 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 | |
|---|---|
| LAVA campo del conector de Source | LAVA campo de esquema de evento |
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 | |
|---|---|
| LAVA campo del conector de Source | LAVA campo de esquema de evento |
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 | |
|---|---|
| LAVA campo del conector de Source | LAVA campo de esquema de evento |
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 | |
|---|---|
| LAVA campo del conector de Source | LAVA campo de esquema de evento |
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, puede ajustar manualmente las reglas de asignación para adaptarlas a sus casos de uso. En función de sus necesidades, puede elegir asignar campos directamente o utilizar funciones de preparación de datos para transformar los datos de origen y derivar valores calculados o calculados. Para ver los pasos detallados sobre el uso de la interfaz de asignador y los campos calculados, consulte la guía de la interfaz de usuario de la preparación de datos.
Una vez que los datos de origen estén asignados correctamente, seleccione Siguiente.
Revisar
Aparece el paso Revisar, que le permite revisar el nuevo flujo de datos antes de crearlo. Los detalles se agrupan en las siguientes categorías:
- Conexión: muestra el tipo de origen, la ruta de acceso relevante del archivo de origen elegido y el número de columnas dentro de ese archivo de origen.
- Asignar campos de conjunto de datos y asignación: muestra en qué conjunto de datos se están ingiriendo los datos de origen, incluido el esquema al que se adhiere el conjunto de datos.
Una vez que haya revisado el flujo de datos, seleccione Finalizar y espere un poco para que se cree el flujo de datos.
Obtener la URL del extremo de flujo continuo y el ID de flujo de datos
Con el flujo de datos de flujo continuo creado, ahora puede recuperar la URL del extremo de flujo de datos de flujo continuo y el ID de flujo de datos. Se usarán para configurar LAVA, lo que permitirá que el origen de flujo se comunique con Experience Platform.
Para recuperar el extremo de flujo continuo, vaya a la página Actividad de flujo de datos del flujo de datos que acaba de crear y copie el extremo desde la parte inferior del panel Propiedades.
Integrar LAVA con su webhook
En la consola LAVA, vaya a Resources > Data Export.
Seleccione Create New Export y luego elija Adobe Source Connector como tipo de destino. A continuación, seleccione los datos de origen que desee enviar e introduzca la dirección URL del extremo de flujo continuo junto con el ID del flujo de datos.
