Exportación de datos prenlytics

Introducción

Prenlytics es un potente marco de exportación diseñado para transmitir de forma segura datos estadísticos brutos enriquecidos en formato JSON a un punto final api externo. Este flujo está diseñado para clientes que necesitan integrar análisis detallados basados en eventos directamente en sus propios sistemas, ofreciendo un formato de datos rico y flexible que es fácil de incorporar en las propias bases de datos u otras aplicaciones del cliente.

También ofrecemos la flexibilidad de convertir y reenviar los datos a formatos personalizados mediante integraciones backend-to-backend. Tanto si necesita datos en un formato específico como si requiere que se envíen directamente a un sistema de terceros, esta solución puede adaptarse a sus requisitos exactos.

Detalles de implementación

Transferencia de datos

Los clientes de Prenly Reader envían datos estadísticos a un servicio backend dedicado de Prenlytics, diseñado específicamente para gestionar la alta carga y la intensidad de tráfico asociadas al procesamiento de datos estadísticos a gran escala. Este backend funciona independientemente de las API estándar de Prenly para garantizar un rendimiento sin problemas incluso en condiciones de tráfico intenso.

Documentación del esquema JSON

Todos los datos exportados se adhieren a un esquema J SON que define tanto la estructura de los datos como proporciona documentación textual básica. Esto garantiza que los datos exportados sigan sistemáticamente las reglas del esquema, haciendo que la integración con sistemas externos sea estable y fiable.

Los detalles sobre cada evento y sus dimensiones se documentan más específicamente aquí.

Consideraciones técnicas

• En el esquema JSON, la mayoría de los campos no se definen como obligatorios, lo que proporciona flexibilidad para futuras actualizaciones. Este diseño minimiza el riesgo de errores de validación cuando se añaden nuevos campos o se actualiza el esquema.
• Para reducir la cantidad de datos que se envían, las propiedades sin valor (normalmente representadas como null) no se incluyen, sino que se omiten por completo del objeto JSON.
• Además de documentar la estructura de datos, el esquema también puede utilizarse para la validación técnica, lo que puede simplificar sus procesos.

Versionado y compatibilidad

Versionado semántico

Prenlytics utiliza el versionado semántico para gestionar las actualizaciones del esquema JSON. Este enfoque garantiza que las actualizaciones sean predecibles y compatibles con versiones anteriores, a menos que se produzca un cambio de versión importante. El número de versión se estructura como MAYOR.MENOR.PATCH (por ejemplo 1.17.4), donde:

• MAYOR aumenta cuando se introducen cambios de última hora. Estos cambios no son compatibles con versiones anteriores y pueden requerir ajustes en su integración. Notificaremos a los clientes con suficiente antelación si está prevista una actualización importante para garantizar una transición fluida.
• MINOR aumenta cuando se añaden nuevas propiedades de datos compatibles con versiones anteriores, incluidas nuevas propiedades de eventos. Las nuevas propiedades nunca serán necesarias en el esquema JSON, lo que garantiza que las integraciones existentes no se vean afectadas.
• PATCH aumenta cuando se realizan pequeños cambios, incluidas correcciones de errores compatibles con versiones anteriores y cambios textuales en las descripciones.

Gestión de varias versiones del esquema

Es importante tener en cuenta que varias versiones del esquema pueden estar activas simultáneamente en distintas plataformas:

Aplicaciones web: Las implantaciones web pueden adoptar rápidamente nuevas versiones del esquema en cuanto se publican. Cuando la plataforma web se actualiza, puede empezar a enviar datos utilizando la última versión del esquema.

Aplicaciones nativas: En el caso de las aplicaciones nativas (iOS y Android), las versiones del esquema están vinculadas a la versión de la aplicación instalada en el dispositivo del usuario. Dado que no todos los usuarios actualizan sus aplicaciones inmediatamente, las versiones de esquema más antiguas pueden seguir utilizándose mucho tiempo después de que se publique una nueva versión.

Para simplificar el soporte, proporcionamos documentación completa de las versiones antiguas, actuales y previstas.

Versiones y referencias del esquema

Esta tabla muestra tanto las versiones publicadas como los borradores del formato de datos de Prenlytics, así como cuándo se publicaron o está previsto que se publiquen.

Configuración

Configurar una exportación de Prenlytics

La exportación de Prenlytics está incorporada en todos los clientes de la aplicación Prenly (web, Android, iOS), por lo que activarla no requiere construir una nueva versión de las aplicaciones nativas.

Si está interesado en recuperar datos en formato Prenlytics, póngase en contacto con nuestro servicio de asistencia.