Show Menu
TEMAS×

Guía de solución de problemas de inserción de flujo continuo

Este documento proporciona respuestas a las preguntas más frecuentes sobre la transmisión de la ingesta por flujo continuo en Adobe Experience Platform. Para preguntas y solución de problemas relacionados con otros Platform servicios, incluidos los que se encuentran en todas Platform las API, consulte la guía de solución de problemas del Experience Platform .
Adobe Experience Platform Data Ingestion proporciona API RESTful que puede utilizar para transferir datos a Experience Platform. Los datos ingestados se utilizan para actualizar perfiles de clientes individuales en tiempo casi real, lo que le permite ofrecer experiencias relevantes y personalizadas en varios canales. Lea la información general sobre la ingestión de datos para obtener más información sobre el servicio y los diferentes métodos de ingestión. Para ver los pasos sobre cómo utilizar las API de inserción de flujo continuo, lea la descripción general de la ingesta de flujo.

Preguntas frecuentes

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

¿Cómo sé que la carga útil que envío 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 ajusten a la estructura de un esquema XDM predefinido provocará un error en la ingestión. Para obtener más información sobre XDM y su uso en Experience Platform, consulte la descripción general del sistema XDM.
La ingestión de flujo continuo admite dos modos de validación: sincrónico y asincrónico. Cada método de validación gestiona los datos fallidos 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 al efectuar la validación se eliminan y se devuelve 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 asincrónica debe usarse en la producción. Los datos mal formados que no pasen la validación se envían al archivo Data Lake como un archivo por lotes con errores, donde se pueden recuperar posteriormente para mayor análisis.
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 flujo. Para ver los pasos para la vista de lotes en los que se han producido errores al efectuar la validación, consulte la guía para recuperar lotes en los que se han producido errores.

¿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 asincrónica, el servicio detecta y envía los datos mal formados a la Data Lake ubicación donde posteriormente se pueden recuperar para su análisis. Consulte la descripción general de validación de flujo para obtener más información.

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

¿Cómo puedo garantizar que los datos se recopilen únicamente 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 testigo web JSON (JWT) y su identificador de organización 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 de transmisión de datos a Real-time Customer Profile?

Los eventos de flujo se reflejan generalmente 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 única carga útil de solicitud y transmitirlos a Platform. Cuando se utiliza correctamente, agrupar varios mensajes dentro de una sola solicitud es una manera excelente 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 (de forma satisfactoria o no) 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 ingestado 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 la página de actividad del conjunto de datos, mostrando todos los lotes enviados durante un período de tiempo seleccionado. Para obtener más información sobre el uso Experience Platform para supervisar flujos de datos, consulte la guía sobre supervisión de flujos de datos de flujo continuo.
Si los datos no se han podido transferir y desea recuperarlos de Platform, puede recuperar los lotes con errores enviando sus ID al Data Access API. Consulte la guía para recuperar lotes con errores para obtener más información.

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

Hay una variedad de razones por las que la ingestión por lotes puede no alcanzar el objetivo Data Lake, como formato no válido, datos que faltan o errores del sistema. Para determinar por qué falló el lote, debe recuperar el lote mediante el Data Ingestion Service API y vista sus detalles. Para ver los pasos detallados sobre la recuperación de un lote dañado, consulte la guía sobre la 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 se aceptó la solicitud. Si se devuelve un código de respuesta correcto, se puede revisar el objeto de responses matriz 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 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: un éxito y otro fracaso. Los mensajes que se transmiten correctamente devuelven una xactionId propiedad. Los mensajes que no se pueden transmitir devuelven una statusCode propiedad 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é mis mensajes enviados no son recibidos 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. Puede ser el resultado de proporcionar un valor o una Área de nombres no válidos para una identidad.
Existen dos tipos de Áreas de nombres de identidad: predeterminado y personalizado. Cuando utilice Áreas de nombres personalizadas, asegúrese de que la Área de nombres se ha registrado en Identity Service. Consulte la descripción general de la Área de nombres de identidad para obtener más información sobre el uso de Áreas de nombres predeterminadas y personalizadas.
Puede utilizar la IU de Experience Platform para obtener más información sobre el motivo por el que un mensaje no se puede ingestar. Haga clic en Monitoreo en el panel de navegación izquierdo y, a continuación, vista la ficha Flujo de extremo a extremo para ver los lotes de mensajes transmitidos durante un período de tiempo seleccionado.