Export av Prenlytics-data

Introduktion till Prenlytics

Prenlytics är ett kraftfullt exportramverk som är utformat för att på ett säkert sätt överföra berikad statistisk rådata i JSON-format till en extern api-slutpunkt. Detta flöde är skräddarsytt för kunder som behöver integrera detaljerade händelsebaserade analyser direkt i sina egna system och erbjuder ett rikt och flexibelt dataformat som är enkelt att införliva i kundens egna databaser eller andra applikationer.

Vi erbjuder också flexibiliteten att konvertera och vidarebefordra data till anpassade format via backend-till-backend-integrationer. Oavsett om du behöver data i ett specifikt format eller om du vill att den ska skickas direkt till ett tredjepartssystem kan den här lösningen skräddarsys för att passa dina exakta krav.

Detaljer om implementeringen

Överföring av data

Prenly Reader-klienterna skickar statistiska data till en dedikerad Prenlytics backend-tjänst, som är särskilt utformad för att hantera den höga belastning och trafikintensitet som är förknippad med storskalig statistisk databehandling. Denna backend fungerar oberoende av Prenlys standard-API:er för att säkerställa smidig prestanda även under tunga trafikförhållanden.

Dokumentation av JSON-schema

Alla exporterade data följer ett JSON-schema som definierar både datastrukturen och tillhandahåller grundläggande textdokumentation. Detta säkerställer att de exporterade uppgifterna konsekvent följer schemats regler, vilket gör integrationen med externa system både stabil och tillförlitlig.

Detaljerna om varje händelse och dess dimensioner är mer specifikt dokumenterade här.

Tekniska överväganden

• I JSON-schemat är de flesta fält inte definierade som obligatoriska, vilket ger flexibilitet för framtida uppdateringar. Denna design minimerar risken för valideringsfel när nya fält läggs till eller schemauppdateringar sker.
• För att minska mängden data som skickas kommer egenskaper utan värde (normalt representerade som null) inte att inkluderas - i stället utelämnas egenskapen helt och hållet från JSON-objektet.
• Förutom att dokumentera datastrukturen kan schemat också användas för teknisk validering, vilket kan förenkla dina bearbetningspipelines.

Versionering och kompatibilitet

Semantisk versionshantering

Prenlytics följer semantisk versions hantering för att hantera uppdateringar av JSON-scheman. Detta tillvägagångssätt säkerställer att uppdateringar är förutsägbara och bakåtkompatibla om inte en större versionsändring inträffar. Versionsnumret är strukturerat som MAJOR.MINOR.PATCH (t.ex. 1.17.4), där:

• MAJOR ökar när banbrytande ändringar införs. Dessa ändringar är inte bakåtkompatibla och kan kräva justeringar av din integration. Vi kommer att meddela kunderna i god tid om en större uppdatering planeras för att säkerställa en smidig övergång.
• MINOR ökar när nya, bakåtkompatibla dataegenskaper, inklusive nya händelseegenskaper, läggs till. Nya egenskaper kommer aldrig att krävas i JSON-schemat, vilket säkerställer att befintliga integrationer förblir opåverkade.
• PATCH ökar när små ändringar görs, inklusive bakåtkompatibla buggfixar och textändringar i beskrivningar.

Hantera flera schemaversioner

Det är viktigt att notera att flera schemaversioner kan vara aktiva samtidigt på olika plattformar:

Webbapplikationer: Webbdistributioner kan snabbt ta i bruk nya versioner av schemat så snart de släpps. När webbplattformen uppdateras kan den börja skicka data med hjälp av den senaste schemaversionen.

Inbyggda applikationer: För inbyggda appar (iOS och Android) är schemaversionerna knutna till den version av appen som är installerad på användarens enhet. Eftersom inte alla användare uppdaterar sina appar omedelbart kan äldre schemaversioner fortsätta att användas långt efter att en ny version har släppts.

För att förenkla detta tillhandahåller vi fullständig dokumentation av gamla, nuvarande och planerade versioner.

Schemaversioner och referenser

I den här tabellen visas både släppta och utkast till versioner av Prenlytics dataformat, samt när de släpptes eller planeras att släppas.

Uppsättning

Konfigurera en Prenlytics-export

Prenlytics-export är inbyggd i alla Prenly-applikationsklienter (webb, Android, iOS), så för att aktivera den behöver du inte bygga en ny version av de inbyggda apparna.

Om du är intresserad av att hämta data i Prenlytics-format kan du kontakta vår helpdesk.