Guía de solución de problemas de ingesta

Este documento proporciona respuestas a las preguntas frecuentes acerca de la ingesta de transmisión en Adobe Experience Platform. Para preguntas y solucionar problemas relacionados con otros servicios de Platform, incluidos los que se encuentran en todas las API de Platform, consulte la guía de solución de problemas para Experience Platform.

Adobe Experience Platform Data Ingestion proporciona API RESTful que puede usar para ingerir datos en Experience Platform. Los datos introducidos se utilizan para actualizar perfiles de clientes individuales en tiempo casi real, lo que le permite ofrecer experiencias personalizadas y relevantes en varios canales. Lea la Información general sobre la ingesta de datos para obtener más información sobre el servicio y los diferentes métodos de ingesta. Para ver los pasos de cómo usar las API de ingesta de transmisión, lee información general sobre la ingesta de transmisión.

Preguntas frecuentes

A continuación se muestra una lista de respuestas a las preguntas frecuentes acerca de la ingesta de transmisión.

¿Cómo sé que la carga útil que estoy enviando tiene el formato correcto?

Data Ingestion aprovecha Experience Data Model esquemas (XDM) para validar el formato de los datos entrantes. Si se envían datos que no se ajustan a la estructura de un esquema XDM predefinido, la ingesta fallará. Para obtener más información sobre XDM y su uso en Experience Platform, consulte la descripción general del sistema XDM.

La ingesta por transmisión admite dos modos de validación: sincrónico y asincrónico. Cada método de validación gestiona los datos con errores de forma diferente.

Validación sincrónica debe usarse durante el proceso de desarrollo. Los registros que no superan la validación se pierden y devuelven un mensaje de error sobre el motivo del error (por ejemplo: "Formato de mensaje XDM no válido").

La validación asincrónica debe usarse en la producción. Los datos con formato incorrecto que no pasan la validación se envían a Data Lake como un archivo por lotes con errores, donde se pueden recuperar más adelante para realizar un análisis más detallado.

Para obtener más información sobre la validación sincrónica y asincrónica, consulte la descripción general de la validación de transmisión. Para obtener información sobre cómo ver los lotes que no superan la validación, consulte la guía sobre recuperación de lotes con errores.

¿Puedo validar una carga útil de solicitud antes de enviarla a Platform?

Las cargas útiles de solicitud solo se pueden evaluar una vez enviadas a Platform. Al realizar la validación sincrónica, las cargas útiles válidas devuelven objetos JSON rellenados, mientras que las cargas útiles no válidas devuelven mensajes de error. Durante la validación asincrónica, el servicio detecta y envía los datos mal formados a Data Lake, donde se pueden recuperar más adelante para su análisis. Consulte la descripción general de la validación de transmisión para obtener más información.

¿Qué sucede cuando se solicita una validación sincrónica en un perímetro que no la admite?

Cuando no se admite la validación sincrónica para la ubicación solicitada, se devuelve una respuesta de error 501. Consulte la descripción general de la validación de transmisión para obtener más información sobre la validación sincrónica.

¿Cómo puedo asegurarme de que los datos solo se recopilen de fuentes de confianza?

Experience Platform admite la recopilación de datos protegidos. Cuando la recopilación de datos autenticados está habilitada, los clientes deben enviar un token web JSON (JWT) y su ID de organización como encabezados de solicitud. Para obtener más información sobre cómo enviar datos autenticados a Platform, consulte la guía sobre recopilación de datos autenticados.

¿Cuál es la latencia para transmitir datos a Real-Time Customer Profile?

Los eventos transmitidos generalmente se reflejan en Real-Time Customer Profile en menos de 60 segundos. Las latencias reales pueden variar debido al volumen de datos, el tamaño del mensaje y las limitaciones de ancho de banda.

¿Puedo incluir varios mensajes en la misma solicitud de API?

Puede agrupar varios mensajes en una sola carga de solicitud y transmitirlos a Platform. Cuando se utiliza correctamente, agrupar varios mensajes dentro de una sola solicitud es una forma excelente de optimizar las operaciones de datos. Lea el tutorial sobre envío de varios mensajes en una solicitud para obtener más información.

¿Cómo sé si se están recibiendo los datos que estoy enviando?

Todos los datos enviados a Platform (correctamente o de otra manera) se almacenan como archivos por lotes antes de persistir en los conjuntos de datos. El estado de procesamiento de los lotes aparece dentro del conjunto de datos al que se enviaron.

Puede comprobar si los datos se han introducido correctamente comprobando la actividad del conjunto de datos mediante la interfaz de usuario del Experience Platform. Haga clic en Conjuntos de datos en el panel de navegación izquierdo para mostrar una lista de conjuntos de datos. Seleccione el conjunto de datos al que está transmitiendo desde la lista mostrada para abrir su página Actividad del conjunto de datos, que muestra todos los lotes enviados durante un período de tiempo seleccionado. Para obtener más información acerca del uso de Experience Platform para supervisar flujos de datos, consulte la guía sobre supervisión de flujos de datos de flujo.

Si no se pudieron introducir los datos y desea recuperarlos de Platform, puede recuperar los lotes con errores enviando sus identificadores a Data Access API. Consulte la guía sobre recuperación de lotes con errores para obtener más información.

¿Por qué los datos de streaming no están disponibles en el lago de datos?

Existen varias razones por las que la ingesta por lotes puede no llegar a Data Lake, como formato no válido, falta datos o errores del sistema. Para determinar por qué falló el lote, debe recuperar el lote mediante Data Ingestion Service API y ver sus detalles. Para ver los pasos detallados sobre la recuperación de un lote fallido, consulte la guía sobre recuperación de lotes fallidos.

¿Cómo analizo la respuesta devuelta para la solicitud de API?

Puede analizar una respuesta comprobando primero el código de respuesta del servidor para determinar si su solicitud fue aceptada. Si se devuelve un código de respuesta correcto, puede revisar el objeto de matriz responses para determinar el estado de la tarea de ingesta.

Una solicitud correcta de API de un solo mensaje devuelve el código de estado 200. Una solicitud de API de mensaje por lotes correcta (o parcialmente correcta) devuelve el código de estado 207.

El siguiente JSON es un objeto de respuesta de ejemplo para una solicitud de API con dos mensajes: uno correcto y otro fallido. Los mensajes que se retransmiten correctamente devuelven una propiedad xactionId. Los mensajes que no se transmiten devuelven una propiedad statusCode y una respuesta message con más información.

{
    "inletId": "9b0cb233972f3b0092992284c7353f5eead496218e8441a79b25e9421ea127f5",
    "batchId": "1565638336649:1750:244",
    "receivedTimeMs": 1565638336705,
    "responses": [
        {
            "xactionId": "1565650704337:2124:92:3"
        },
        {
            "statusCode": 400,
            "message": "inletId: [9b0cb233972f3b0092992284c7353f5eead496218e8441a
                79b25e9421ea127f5]
                imsOrgId: [{ORG_ID}]
                Message has unknown xdm format"
        }
    ]
}

¿Por qué no reciben mis mensajes enviados Real-Time Customer Profile?

Si Real-Time Customer Profile rechaza un mensaje, lo más probable es que se deba a información de identidad incorrecta. Esto puede deberse a que se ha proporcionado un valor o un área de nombres no válidos para una identidad.

Existen dos tipos de áreas de nombres de identidad: predeterminadas y personalizadas. Cuando utilice áreas de nombres personalizadas, asegúrese de que el área de nombres se ha registrado en Identity Service. Vea la descripción general del área de nombres de identidad para obtener más información sobre el uso de áreas de nombres predeterminadas y personalizadas.

Puede usar Experience Platform UI para ver más información sobre por qué falló la ingesta de un mensaje. Haga clic en Supervisión en el panel de navegación izquierdo y, a continuación, vea la pestaña Transmisión de extremo a extremo para ver los lotes de mensajes transmitidos durante un período de tiempo seleccionado.