Exportation des données préventives

Introduction

Prenlytics est un cadre d'exportation puissant conçu pour transmettre en toute sécurité des données statistiques brutes enrichies au format JSON vers un point d'accès api externe. Ce flux est conçu pour les clients qui ont besoin d'intégrer des analyses détaillées basées sur des événements directement dans leurs propres systèmes, offrant un format de données riche et flexible qui est facile à incorporer dans les bases de données du client ou d'autres applications.

Nous offrons également la possibilité de convertir et de transmettre les données dans des formats personnalisés par le biais d'intégrations backend à backend. Que vous ayez besoin de données dans un format spécifique ou qu'elles soient envoyées directement à un système tiers, cette solution peut être adaptée pour répondre à vos besoins exacts.

Détails de la mise en œuvre

Transfert de données

Les clients Prenly Reader envoient les données statistiques à un service backend Prenlytics dédié, conçu spécifiquement pour gérer la charge élevée et l'intensité du trafic associées au traitement de données statistiques à grande échelle. Ce backend fonctionne indépendamment des API standard de Prenly afin de garantir des performances optimales même dans des conditions de trafic intense.

Documentation du schéma JSON

Toutes les données exportées sont conformes à un schéma JSON qui définit la structure des données et fournit une documentation textuelle de base. Cela garantit que les données exportées suivent systématiquement les règles du schéma, ce qui rend l'intégration avec des systèmes externes à la fois stable et fiable.

Les détails de chaque événement et de ses dimensions sont plus spécifiquement documentés ici.

Considérations techniques

• Dans le schéma JSON, la plupart des champs ne sont pas définis comme obligatoires, ce qui offre une certaine souplesse pour les mises à jour futures. Cette conception minimise le risque d'erreurs de validation lors de l'ajout de nouveaux champs ou de la mise à jour du schéma.
• Pour réduire la quantité de données envoyées, les propriétés sans valeur (normalement représentées par null) ne seront pas incluses - au lieu de cela, la propriété est entièrement omise de l'objet JSON.
• Outre la documentation de la structure des données, le schéma peut également être utilisé pour la validation technique, ce qui peut simplifier vos processus de traitement.

Versionnement et compatibilité

Versionnement sémantique

Prenlytics utilise le versionnement sémantique pour gérer les mises à jour du schéma JSON. Cette approche garantit que les mises à jour sont prévisibles et rétrocompatibles, sauf en cas de changement de version majeur. Le numéro de version est structuré comme MAJOR.MINOR.PATCH (par exemple 1.17.4), où :

• MAJOR augmente lorsque des changements radicaux sont introduits. Ces changements ne sont pas rétrocompatibles et peuvent nécessiter des ajustements de votre intégration. Nous informerons les clients bien à l'avance si une mise à jour majeure est prévue afin d'assurer une transition en douceur.
• MINOR augmente lorsque de nouvelles propriétés de données rétrocompatibles, y compris de nouvelles propriétés d'événements, sont ajoutées. Les nouvelles propriétés ne seront jamais requises dans le schéma JSON, ce qui garantit que les intégrations existantes ne seront pas affectées.
• PATCH augmente lorsque de petites modifications sont apportées, notamment des corrections de bogues rétrocompatibles et des modifications textuelles dans les descriptions.

Gestion de plusieurs versions de schéma

Il est important de noter que plusieurs versions de schéma peuvent être actives simultanément sur différentes plateformes :

Applications web: Les déploiements Web peuvent rapidement adopter de nouvelles versions du schéma dès leur publication. Lorsque la plateforme web est mise à jour, elle peut commencer à envoyer des données en utilisant la dernière version du schéma.

Applications natives: Pour les applications natives (iOS et Android), les versions du schéma sont liées à la version de l'application installée sur l'appareil de l'utilisateur. Étant donné que tous les utilisateurs ne mettent pas leurs applications à jour immédiatement, les anciennes versions de schéma peuvent rester utilisées longtemps après la publication d'une nouvelle version.

Pour simplifier la prise en charge de ce problème, nous fournissons une documentation complète sur les anciennes versions, les versions actuelles et les versions prévues.

Versions du schéma et références

Ce tableau présente les versions publiées et les versions provisoires du format de données Prenlytics, ainsi que la date à laquelle elles ont été publiées ou devraient l'être.

Mise en place

Mise en place d'un export Prenlytics

L'export Prenlytics est intégré dans toutes les applications clients Prenly (web, Android, iOS), son activation ne nécessite donc pas la création d'une nouvelle version des applications natives.

Si vous souhaitez récupérer des données au format Prenlytics, veuillez contacter notre service d'assistance.