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 el Modelo de datos de experiencia (XDM). Al configurar una secuencia de datos habilitada para Platform, puede utilizar las funcionalidades de preparación de datos para asignar los datos de origen a XDM al enviarlos a Platform Edge Network.

Todos los datos enviados desde una página web deben aterrizar en Experience Platform como XDM. Existen tres formas de traducir datos de una capa de datos en la página al XDM aceptado por el Experience Platform:

  1. Vuelva a dar formato a la capa de datos en XDM en la propia página web.
  2. Utilice la funcionalidad Etiquetas de elementos de datos nativos para reformatear el formato de capa de datos existente de una página web en XDM.
  3. Vuelva a dar formato al formato de capa de datos existente de una página web en XDM mediante el Edge Network con la preparación de datos para la recopilación de datos.

Esta guía se centra en la tercera opción.

Cuándo utilizar la preparación de datos para la recopilación de datos when-to-use-data-prep

Existen dos casos de uso en los que la preparación de datos para la recopilación de datos es útil:

  1. El sitio web tiene una capa de datos bien formada, controlada y mantenida, y hay una preferencia por enviarla directamente al Edge Network en lugar de utilizar la manipulación de JavaScript para convertirla a XDM en la página (ya sea mediante elementos de datos de etiquetas o mediante la manipulación manual de JavaScript).
  2. En el sitio se implementa un sistema de etiquetado que no sea Etiquetas.

Envíe una capa de datos existente al Edge Network mediante WebSDK send-datalayer-via-websdk

La capa de datos existente debe enviarse usando el objeto data dentro del comando sendEvent.

Si usa etiquetas, debe usar el campo Datos del tipo de acción Enviar evento, tal como se describe en la documentación de extensión de etiqueta del SDK web.

El resto de esta guía se centrará en cómo asignar la capa de datos a los estándares XDM después de que el SDK web la haya enviado.

NOTE
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. Para seguir estos pasos, inicie el proceso de creación de una secuencia de datos hasta (e incluyendo) el 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 select-data

Seleccione Guardar y añadir asignación después de completar la configuración básica de una secuencia de datos y aparece el paso Seleccionar datos. Desde aquí, debe proporcionar un objeto JSON de muestra que represente la estructura de los datos que tiene previsto 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 objeto data deben construirse de manera que se asignen 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 formato correcto con una raíz data.

Archivo JSON de muestra con una raíz data
code language-json
{
  "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 raíz de xdm.

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

NOTE
Utilice un objeto JSON de muestra que represente cada elemento de capa de datos que se pueda utilizar en cualquier página. Por ejemplo, no todas las páginas utilizan elementos de capa de datos del carro de compras. Sin embargo, los elementos de la capa de datos del carro de compras deben incluirse en este objeto JSON de muestra.

Asignación

Aparece el paso 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:

Creación de reglas de asignación create-mapping

Para crear una regla de asignación, seleccione Agregar nueva asignación.

Agregando 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 botón Seleccionar para continuar.

Seleccionando el campo que se va a 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.

Seleccionando el 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. La sección Asignación en curso se actualiza para reflejar el número total de campos que se han asignado correctamente.

Campo asignado correctamente con progreso reflejado.

TIP
Si desea asignar una matriz de objetos (en el campo de origen) a una diferente (en el campo de destino), añada [*] después del nombre de la matriz en las rutas de campo de origen y destino, tal como se muestra a continuación.
Asignación de objeto de matriz.

Importación de reglas de asignación existentes import-mapping

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

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

Para empezar, seleccione Importar asignación.

Se está seleccionando el botón Importar asignación.

En el cuadro de diálogo que aparece, seleccione la secuencia de datos cuyas reglas de asignación desea importar. Una vez elegida la secuencia de datos, seleccione Vista previa.

Seleccionando una secuencia de datos existente.

NOTE
Las secuencias de datos solo se pueden importar dentro de la misma zona protegida. En otras palabras, no se puede importar una secuencia de datos de una zona protegida a otra.

La siguiente pantalla muestra una previsualización de las reglas de asignación guardadas para la secuencia de datos seleccionada. Asegúrese de que las asignaciones mostradas sean las esperadas y, a continuación, seleccione Importar para confirmar y agregar las asignaciones a la nueva secuencia de datos.

Reglas de asignación para importar.

NOTE
Si algún campo de origen en las reglas de asignación importadas no se incluye en los datos JSON de muestra que ha proporcionado anteriormente estas 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 definido como obligatorio debe asignarse para completar este paso. El contador campos obligatorios indica cuántos campos obligatorios aún no están asignados en la configuración actual.

Una vez que el recuento de campos requerido llegue a 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 secuencia de datos, ahora puede volver al paso sobre visualización de detalles de secuencia de datos.

recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac