Guía de solución de problemas de ingesta de transmisión

Este documento proporciona respuestas a las preguntas más frecuentes sobre la transmisión por secuencias de comandos en Adobe Experience Platform. Para preguntas y solución de problemas relacionados con otros Platform servicios, incluidos los que se encuentran en todas las API Platform, consulte la guía de solución de problemas del Experience Platform.

Adobe Experience Platform Data Ingestion proporciona API RESTful que puede utilizar para introducir 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 el Resumen de ingesta de datos para obtener más información sobre el servicio y los distintos métodos de ingesta. Para ver los pasos sobre cómo utilizar las API de ingesta de flujo continuo, lea la descripción general de ingesta de flujo.

Preguntas frecuentes

A continuación se ofrece una lista de respuestas a las preguntas más frecuentes sobre la transmisión por secuencias de comandos.

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

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

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

La validación sincrónica debe utilizarse durante el proceso de desarrollo. Los registros en los que se ha producido un error de validación se pierden y devuelven un mensaje de error en el que se indica por qué han fallado (por ejemplo: "Formato de mensaje XDM no válido").

La validación asíncrona debe utilizarse en la producción. Los datos con formato incorrecto que no pasan la validación se envían al Data Lake como archivo por lotes con errores, donde se pueden recuperar posteriormente para su análisis posterior.

Para obtener más información sobre la validación sincrónica y asíncrona, consulte la descripción general de validación de flujo continuo. Para ver los pasos sobre cómo ver lotes que no se pueden validar, consulte la guía sobre recuperación de lotes fallidos.

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

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

¿Qué sucede cuando se solicita la 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 validación de flujo continuo para obtener más información sobre validación sincrónica.

¿Cómo me aseguro de que los datos solo se recopilen a partir de fuentes de confianza?

Experience Platform admite la recopilación de datos segura. Cuando la recopilación de datos autenticada está habilitada, los clientes deben enviar un token web JSON (JWT) y su ID de organización de IMS 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 la transmisión de datos a Real-time Customer Profile?

Los eventos de flujo continuo 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 dentro de una única carga útil de solicitud y transmitirlos a Platform. Cuando se utiliza correctamente, agrupar varios mensajes dentro de una única solicitud es una excelente manera de optimizar las operaciones de datos. Lea el tutorial sobre el envío de varios mensajes en una solicitud para obtener más información.

¿Cómo sé si los datos que envío se están recibiendo?

Todos los datos que se envían a Platform (con éxito o de otro modo) 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 incorporado correctamente comprobando la actividad del conjunto de datos mediante la interfaz de usuario del Experience Platform. Haga clic en Datasets 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 Dataset activity y mostrar todos los lotes enviados durante un período de tiempo seleccionado. Para obtener más información sobre el uso de Experience Platform para monitorizar flujos de datos, consulte la guía sobre monitorización de flujos de datos de flujo continuo.

Si los datos no se han podido introducir y desea recuperarlos de Platform, puede recuperar los lotes en los que se han producido errores enviando sus ID a Data Access API. Para obtener más información, consulte la guía sobre recuperación de lotes fallidos .

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

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

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

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

Una solicitud de API de un solo mensaje correcta devuelve el código de estado 200. Una solicitud de API 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: un éxito y otro fracaso. Los mensajes que transmiten correctamente devuelven una propiedad xactionId. Los mensajes que no se pueden transmitir 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: [{IMS_ORG}] 
                Message has unknown xdm format"
        }
    ]
}

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

Si Real-time Customer Profile rechaza un mensaje, lo más probable es que se deba a una información de identidad incorrecta. Esto puede ser el resultado de proporcionar un valor o área de nombres no válida para una identidad.

Existen dos tipos de áreas de nombres de identidad: predeterminado y personalizado. Cuando utilice espacios de nombres personalizados, asegúrese de que el espacio de nombres se haya registrado en Identity Service. Consulte 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 utilizar Experience Platform UI para ver más información sobre el motivo por el que un mensaje falla en la ingesta. Haga clic en Monitoring en el panel de navegación izquierdo y, a continuación, vea la pestaña Streaming end-to-end para ver los lotes de mensajes que se transmiten durante un período de tiempo seleccionado.

En esta página