Preparación de datos para la recopilación de datos

La 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 un perfil habilitado para Platform secuencia de datosAdemás, puede utilizar las funcionalidades de preparación de datos para asignar los datos de origen a XDM al enviarlos a Platform Edge Network.

NOTA

Para obtener instrucciones completas sobre todas las funcionalidades de preparación de datos, incluidas las funciones de transformación para los 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 estos pasos, inicie el proceso de creación de un conjunto de datos hasta el (e incluido) paso de configuración básica.

Para obtener una demostración rápida del proceso de preparación de datos para la recopilación de datos, consulte el siguiente vídeo:

Seleccionar datos

Seleccionar Guardar y agregar asignación después de completar la configuración básica de un conjunto de datos y la Seleccionar datos aparece el paso. Desde 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 del data a continuación, el objeto debe construirse de manera que se asigne a las propiedades de capa de datos que desee capturar. Seleccione la sección siguiente para ver un ejemplo de un objeto JSON con formato correcto con una data raíz.

 Archivo JSON de muestra con data raíz
{
  "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 la clave xdm en su lugar. Seleccione la sección siguiente para ver un ejemplo de un objeto JSON con formato correcto con una xdm raíz.

 Archivo JSON de muestra con xdm raíz
{
  "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 un 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.

Muestra JSON de datos entrantes esperados

Asignación

El Asignación Este paso aparece, 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:

Creación de una nueva asignación

Para empezar, seleccione Añadir nueva asignación para crear una nueva fila de asignación.

Adición de una nueva asignación

Seleccione el icono de origen (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 el Seleccionar para continuar.

Selección del campo que desea asignar en el esquema de origen

A continuación, seleccione el icono de esquema (Icono de esquema) para abrir un cuadro de diálogo similar para el esquema de evento de destinatario. Elija el campo al que desea asignar los datos antes de confirmar con Seleccionar.

Selección del campo que se va a asignar en el esquema de destino

La página de asignación vuelve a aparecer y se muestra la asignación de campos completada. El Asignación en curso se actualiza la sección para reflejar el número total de campos que se han asignado correctamente.

Campo asignado correctamente con progreso reflejado

SUGERENCIA

Si desea asignar una matriz de objetos (en el campo de origen) a una matriz de objetos diferentes (en el campo de destino), agregue [*] después del nombre de la matriz en las rutas de campo de origen y destino, como se muestra a continuación.

Asignación de objeto de matriz

Importar reglas de asignación existentes

Si ha creado anteriormente una secuencia de datos, puede volver a utilizar sus reglas de asignación configuradas para una nueva secuencia de datos.

ADVERTENCIA

La importación de reglas de asignación desde otro conjunto de datos sobrescribirá las asignaciones de campo que haya agregado antes de la importación.

Para empezar, seleccione Importar asignación.

Imagen que muestra el Importar asignación botón seleccionado

En el cuadro de diálogo que aparece, seleccione la secuencia de datos cuyas reglas de asignación desee importar. Una vez elegido el conjunto de datos, seleccione Previsualizar.

Imagen que muestra una secuencia de datos existente que se está seleccionando

NOTA

Las secuencias de datos solo se pueden importar dentro del mismo espacio aislado. En otras palabras, no se puede importar un conjunto de datos de una zona protegida a otra.

La siguiente pantalla muestra una previsualización de las reglas de asignación guardadas para el conjunto de datos seleccionado. Asegúrese de que las asignaciones mostradas sean las esperadas y, a continuación, seleccione Importar para confirmar y agregar las asignaciones al nuevo conjunto de datos.

Imagen que muestra las reglas de asignación que se van a importar

NOTA

Si algún campo de origen en las reglas de asignación importadas no se incluye en los datos JSON de muestra que proporcionado anteriormenteSin embargo, esas asignaciones de campos no se incluirán en la importación.

Finalización de la asignación

Siga los pasos anteriores para asignar el resto de los campos al esquema de destino. Aunque no tiene que asignar todos los campos de origen disponibles, cualquier campo del esquema de destino que se establezca como obligatorio debe asignarse para completar este paso. El Campos obligatorios counter indica cuántos campos obligatorios aún no están asignados en la configuración actual.

Una vez que el recuento de campos requeridos alcance cero y esté satisfecho con la asignación, seleccione Guardar para finalizar los cambios.

Asignación completa

Pasos siguientes

En esta guía se explica cómo asignar los datos a XDM al configurar una secuencia de datos en la interfaz de usuario. Si estaba siguiendo el tutorial general de flujos de datos, ahora puede volver al paso en visualización de detalles de secuencia de datos.

En esta página