Preparación de datos es un servicio de Adobe Experience Platform que le permite asignar, transformar y validar datos desde y hacia Modelo de datos de experiencia (XDM). Al configurar una plataforma habilitada datastream, puede utilizar las funciones de preparación de datos para asignar los datos de origen a XDM al enviarlos a la red perimetral de plataforma.
Para obtener una guía completa sobre todas las funciones de preparación de datos, incluidas las funciones de transformación para campos calculados, consulte la siguiente documentación:
Esta guía explica cómo asignar los datos dentro de la interfaz de usuario de . Para seguir los pasos, inicie el proceso de creación de un conjunto de datos hasta (e incluido) el paso básico de configuración.
Para ver una demostración rápida del proceso de preparación de datos para la recopilación de datos, consulte el siguiente vídeo:
Select Guardar y agregar asignaciones después de completar la configuración básica de un conjunto de datos, y Seleccionar datos aparece. A partir de aquí, debe proporcionar un objeto JSON de muestra que represente la estructura de los datos que planea enviar a Platform.
Para capturar propiedades directamente desde la capa de datos, el objeto JSON debe tener una sola propiedad raíz data
. Las subpropiedades de la variable data
a continuación, debe crearse de forma que se asigne a las propiedades de la capa de datos que desee capturar. Seleccione la sección siguiente para ver un ejemplo de un objeto JSON con un formato correcto con un data
raíz.
data
root{
"data": {
"eventMergeId": "cce1b53c-571f-4f36-b3c1-153d85be6602",
"eventType": "view:load",
"timestamp": "2021-09-30T14:50:09.604Z",
"web": {
"webPageDetails": {
"siteSection": "Product section",
"server": "example.com",
"name": "product home",
"URL": "https://www.example.com"
},
"webReferrer": {
"URL": "https://www.adobe.com/index2.html",
"type": "external"
}
},
"commerce": {
"purchase": 1,
"order": {
"orderID": "1234"
}
},
"product": [
{
"productInfo": {
"productID": "123"
}
},
{
"productInfo": {
"productID": "1234"
}
}
],
"reservation": {
"id": "anc45123xlm",
"name": "Embassy Suits",
"SKU": "12345-L",
"skuVariant": "12345-LG-R",
"priceTotal": "112.99",
"currencyCode": "USD",
"adults": 2,
"children": 3,
"productAddMethod": "PDP",
"_namespace": {
"test": 1,
"priceTotal": "112.99",
"category": "Overnight Stay"
},
"freeCancellation": false,
"cancellationFee": 20,
"refundable": true
}
}
}
Para capturar propiedades de un elemento de datos de objeto XDM, se aplican las mismas reglas al objeto JSON, pero la propiedad raíz debe tener una clave que xdm
en su lugar. Seleccione la sección siguiente para ver un ejemplo de un objeto JSON con un formato correcto con un xdm
raíz.
xdm
root{
"xdm": {
"environment": {
"type": "browser",
"browserDetails": {
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_5) AppleWebkit/537.36 (KHTML, like Gecko) Chrome/49.0.2623.112 Safari/537.36",
"javaScriptEnabled": true,
"javaScriptVersion": "1.8.5",
"cookiesEnabled": true,
"viewportHeight": 900,
"viewportWidth": 1680,
"javaEnabled": true
},
"domain": "adobe.com",
"colorDepth": 24,
"viewportHeight": 1050,
"viewportWidth": 1680
},
"device": {
"screenHeight": 1050,
"screenWidth": 1680
}
}
}
Puede seleccionar la opción para cargar el objeto como archivo o pegar el objeto sin procesar en el cuadro de texto proporcionado. Si el JSON es válido, se muestra un esquema de vista previa en el panel derecho. Haga clic en Siguiente para continuar.
La variable Asignación , lo que le permite asignar los campos de los datos de origen a los del esquema de evento de destino en Platform. Desde aquí puede configurar la asignación de dos formas:
Para empezar, seleccione Añadir nueva asignación para crear una nueva fila de asignación.
Seleccione el icono de origen () y, en el cuadro de diálogo que aparece, seleccione el campo de origen que desea asignar en el lienzo proporcionado. Una vez que haya elegido un campo, utilice la variable Select para continuar.
A continuación, seleccione el icono de esquema () para abrir un cuadro de diálogo similar para el esquema de eventos de destino. Elija el campo al que desea asignar los datos antes de confirmar con Select.
La página de asignación vuelve a aparecer con la asignación de campo completada que se muestra. La variable Asignación del progreso actualizaciones de sección para reflejar el número total de campos que se han asignado correctamente.
Si desea asignar una matriz de objetos (en el campo de origen) a una matriz de diferentes objetos (en el campo de destino), agregue [*]
después del nombre de la matriz en las rutas de los campos de origen y destino, como se muestra a continuación.
Si ya ha creado un conjunto de datos, puede reutilizar las reglas de asignación configuradas para un nuevo conjunto de datos.
La importación de reglas de asignación desde otro conjunto de datos sobrescribirá cualquier asignación de campo que haya agregado antes de la importación.
Para empezar, seleccione Importar asignación.
En el cuadro de diálogo que aparece, seleccione el conjunto de datos cuyas reglas de asignación desea importar. Una vez elegido el conjunto de datos, seleccione Vista previa.
Los conjuntos de datos solo se pueden importar dentro de un mismo entorno limitado. En otras palabras, no se puede importar un conjunto de datos de un entorno limitado a otro.
La siguiente pantalla muestra una vista previa de las reglas de asignación guardadas para el conjunto de datos seleccionado. Asegúrese de que las asignaciones mostradas sean las que espera y, a continuación, seleccione Importar para confirmar y agregar las asignaciones al nuevo conjunto de datos.
Si algún campo de origen de las reglas de asignación importadas no está incluido en los datos JSON de muestra que usted proporcionado anteriormente, esas asignaciones de campo no se incluirán en la importación.
Siga los pasos anteriores para asignar el resto de los campos al esquema de destino. Aunque no es necesario asignar todos los campos de origen disponibles, cualquier campo del esquema de destino que esté configurado como necesario debe asignarse para completar este paso. La variable Campos requeridos counter indica cuántos campos obligatorios aún no están asignados en la configuración actual.
Una vez que el recuento de campos requerido alcance cero y esté satisfecho con la asignación, seleccione Guardar para finalizar los cambios.
En esta guía se explica cómo asignar los datos a XDM al configurar un conjunto de datos en la interfaz de usuario. Si estaba siguiendo el tutorial de conjuntos de datos generales, ahora puede volver al paso ver detalles del almacén de datos.