Show Menu
TEMAS×

Ingestión parcial por lotes

La ingestión parcial por lotes es la capacidad de ingerir datos que contengan errores, hasta un cierto umbral. Con esta capacidad, los usuarios pueden transferir correctamente todos los datos correctos a Adobe Experience Platform mientras que todos los datos incorrectos se agrupan por lotes por separado, junto con los detalles de por qué no son válidos.
Este documento proporciona un tutorial para administrar la ingestión parcial por lotes.

Primeros pasos

Este tutorial requiere un conocimiento práctico de los diversos servicios de Adobe Experience Platform que intervienen en la ingestión parcial de lotes. Antes de comenzar este tutorial, consulte la documentación de los siguientes servicios:
  • Ingesta por lotes: Método que Platform ingiere y almacena datos de archivos de datos, como CSV y Parquet.
  • Experience Data Model (XDM) : El marco normalizado por el cual Platform organiza los datos de experiencia del cliente.
Las siguientes secciones proporcionan información adicional que deberá conocer para realizar llamadas a Platform las API de forma satisfactoria.

Leer llamadas de API de muestra

Esta guía proporciona ejemplos de llamadas a API para mostrar cómo dar formato a las solicitudes. Estas incluyen rutas, encabezados requeridos y cargas de solicitud con el formato adecuado. También se proporciona el JSON de muestra devuelto en las respuestas de API. Para obtener información sobre las convenciones utilizadas en la documentación de las llamadas de API de muestra, consulte la sección sobre cómo leer llamadas de API de ejemplo en la guía de solución de problemas Experience Platform .

Recopilar valores para encabezados necesarios

Para realizar llamadas a Platform API, primero debe completar el tutorial de autenticación. Al completar el tutorial de autenticación se proporcionan los valores para cada uno de los encabezados necesarios en todas las llamadas Experience Platform de API, como se muestra a continuación:
  • Autorización: Portador {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}
Todos los recursos de Experience Platform están aislados en entornos limitados virtuales específicos. Todas las solicitudes a Platform las API requieren un encabezado que especifique el nombre del entorno limitado en el que se realizará la operación:
  • x-sandbox-name: {SANDBOX_NAME}
Para obtener más información sobre los entornos limitados de Platform, consulte la documentación general del entorno limitado.

Habilitar un lote para la ingestión parcial de lotes en la API

En esta sección se describe cómo habilitar un lote para la ingestión parcial por lotes mediante la API. Para obtener instrucciones sobre el uso de la interfaz de usuario, lea el paso habilitar un lote para la ingestión parcial por lotes en la interfaz de usuario .
Puede crear un nuevo lote con la ingestión parcial activada.
Para crear un nuevo lote, siga los pasos de la guía para desarrolladores de ingestión por lotes. Una vez que llegue al paso Crear lote , agregue el siguiente campo dentro del cuerpo de la solicitud:
{
    "enableErrorDiagnostics": true,
    "partialIngestionPercentage": 5
}

Propiedad
Descripción
enableErrorDiagnostics
Un indicador que permite Platform generar mensajes de error detallados sobre el lote.
partialIngestionPercentage
El porcentaje de errores aceptables antes de que se produzca un error en todo el lote. Así que, en este ejemplo, un máximo del 5% del lote puede ser error, antes de que falle.

Habilitar un lote para la ingestión parcial de lotes en la interfaz de usuario

En esta sección se describe cómo habilitar un lote para la ingestión parcial por lotes mediante la interfaz de usuario. Si ya ha habilitado un lote para la ingestión parcial por lotes mediante la API, puede pasar a la siguiente sección.
Para habilitar un lote para la ingestión parcial a través de la interfaz de usuario, puede crear un nuevo lote a través de conexiones de origen, crear un nuevo lote en un conjunto de datos existente o crear un nuevo lote a través del flujo Platform "Asignar CSV a XDM".

Crear una nueva conexión de origen

Para crear una nueva conexión de origen, siga los pasos que se enumeran en la descripción general de Fuentes. Una vez que llegue al paso de detalle de Flujo de datos, tome nota de los campos de ingesta parcial y diagnóstico de errores .
La conmutación de ingestión parcial le permite habilitar o deshabilitar el uso de la ingestión parcial por lotes.
La opción de diagnóstico de errores solo aparece cuando la opción de alternancia de ingestión ​parcial está desactivada. Esta función permite Platform generar mensajes de error detallados sobre los lotes ingestados. Si se activa la opción de alternancia de ingestión ​parcial, los diagnósticos de error mejorados se aplican automáticamente.
El umbral de error permite establecer el porcentaje de errores aceptables antes de que se produzca un error en todo el lote. De forma predeterminada, este valor se establece en 5 %.

Usar un conjunto de datos existente

Para utilizar un conjunto de datos existente, seleccione un conjunto de datos para el inicio. La barra lateral de la derecha se rellena con información sobre el conjunto de datos.
La conmutación de ingestión parcial le permite habilitar o deshabilitar el uso de la ingestión parcial por lotes.
La opción de diagnóstico de errores solo aparece cuando la opción de alternancia de ingestión ​parcial está desactivada. Esta función permite Platform generar mensajes de error detallados sobre los lotes ingestados. Si se activa la opción de alternancia de ingestión ​parcial, los diagnósticos de error mejorados se aplican automáticamente.
El umbral de error permite establecer el porcentaje de errores aceptables antes de que se produzca un error en todo el lote. De forma predeterminada, este valor se establece en 5 %.
Ahora, puede cargar datos con el botón Añadir datos y se ingesta con ingestión parcial.

Utilizar el flujo "Asignar CSV al esquemaXDM"

Para utilizar el flujo "Asignar CSV al esquemaXDM", siga los pasos enumerados en el tutorial Asignación de un archivo CSV a un esquema XDM Asignar un archivo CSV. Una vez que llegue al paso de Añadir datos , tome nota de los campos de diagnóstico de ingestión ​parcial y error .
La conmutación de ingestión parcial le permite habilitar o deshabilitar el uso de la ingestión parcial por lotes.
La opción de diagnóstico de errores solo aparece cuando la opción de alternancia de ingestión ​parcial está desactivada. Esta función permite Platform generar mensajes de error detallados sobre los lotes ingestados. Si se activa la opción de alternancia de ingestión ​parcial, los diagnósticos de error mejorados se aplican automáticamente.
El umbral de error permite establecer el porcentaje de errores aceptables antes de que se produzca un error en todo el lote. De forma predeterminada, este valor se establece en 5 %.

Pasos siguientes

Este tutorial trata sobre cómo crear o modificar un conjunto de datos para habilitar la ingestión parcial por lotes. Para obtener más información sobre la ingestión por lotes, lea la guía para desarrolladores de la ingestión de lotes.
Para obtener información sobre la supervisión de los errores de ingestión parcial, lea la guía de diagnóstico de errores de ingestión de lotes.