Eksport af Prenlytics-data

Introduktion

Prenlytics er en kraftfuld eksportramme, der er designet til sikkert at overføre berigede rå statistiske data i JSON-format til et eksternt api-slutpunkt. Dette flow er skræddersyet til kunder, der har brug for at integrere detaljerede hændelsesbaserede analyser direkte i deres egne systemer, og tilbyder et rigt og fleksibelt dataformat, der er nemt at indarbejde i kundens egne databaser eller andre applikationer.

Vi tilbyder også fleksibilitet til at konvertere og videresende data til brugerdefinerede formater via backend-til-backend-integrationer. Uanset om du har brug for data i et bestemt format eller skal have dem sendt direkte til et tredjepartssystem, kan denne løsning skræddersys, så den passer præcis til dine krav.

Detaljer om implementering

Overførsel af data

Prenly Reader-klienterne sender statistiske data til en dedikeret Prenlytics-backend-tjeneste, som er designet specifikt til at håndtere den høje belastning og trafikintensitet, der er forbundet med statistisk databehandling i stor skala. Denne backend fungerer uafhængigt af Prenlys standard-API'er for at sikre en jævn ydeevne, selv under tunge trafikforhold.

Dokumentation af JSON-skema

Alle eksporterede data følger et JSON-skema, der både definerer dataenes struktur og giver grundlæggende tekstdokumentation. Dette sikrer, at de eksporterede data konsekvent følger skemaets regler, hvilket gør integrationen med eksterne systemer både stabil og pålidelig.

Detaljerne om hver begivenhed og dens dimensioner er mere specifikt dokumenteret her.

Tekniske overvejelser

• I JSON-skemaet er de fleste felter ikke defineret som obligatoriske, hvilket giver fleksibilitet til fremtidige opdateringer. Dette design minimerer risikoen for valideringsfejl, når der tilføjes nye felter eller sker opdateringer af skemaet.
• For at reducere mængden af data, der sendes, vil egenskaber uden en værdi (normalt repræsenteret som null) ikke blive inkluderet - i stedet udelades egenskaben helt fra JSON-objektet.
• Ud over at dokumentere datastrukturen kan skemaet også bruges til teknisk validering, hvilket kan forenkle dine behandlingspipelines.

Versionering og kompatibilitet

Semantisk versionering

Prenlytics bruger semantisk version ering til at håndtere opdateringer af JSON-skemaer. Denne tilgang sikrer, at opdateringer er forudsigelige og bagudkompatible, medmindre der sker en større versionsændring. Versionsnummeret er struktureret som MAJOR.MINOR.PATCH (f.eks. 1.17.4), hvor:

• MAJOR øges, når der indføres banebrydende ændringer. Disse ændringer er ikke bagudkompatible og kan kræve justeringer af din integration. Vi giver kunderne besked i god tid, hvis der er planlagt en større opdatering for at sikre en smidig overgang.
• MINOR stiger, når der tilføjes nye, bagudkompatible dataegenskaber, herunder nye hændelsesegenskaber. Nye egenskaber vil aldrig være nødvendige i JSON-skemaet, hvilket sikrer, at eksisterende integrationer forbliver upåvirkede.
• PATCH øges, når der foretages små ændringer, herunder bagudkompatible fejlrettelser og tekstændringer i beskrivelser.

Håndtering af flere skemaversioner

Det er vigtigt at bemærke, at flere skemaversioner kan være aktive på samme tid på tværs af forskellige platforme:

Webapplikationer: Webimplementeringer kan hurtigt tage nye versioner af skemaet i brug, så snart de udgives. Når webplatformen opdateres, kan den begynde at sende data ved hjælp af den seneste skemaversion.

Indbyggede applikationer: For native apps (iOS og Android) er skemaversioner bundet til den version af appen, der er installeret på brugerens enhed. Da ikke alle brugere opdaterer deres apps med det samme, kan ældre schema-versioner forblive i brug længe efter, at en ny version er udgivet.

For at gøre det nemmere at understøtte dette, giver vi fuld dokumentation for gamle, nuværende og planlagte versioner.

Skemaversioner og referencer

Denne tabel viser både udgivne og foreløbige versioner af Prenlytics-dataformatet, samt hvornår de blev udgivet eller er planlagt til at blive udgivet.

Opsætning

Opsætning af Prenlytics-eksport

Prenlytics-eksport er indbygget i alle Prenly-applikationsklienter (web, Android, iOS), så aktivering af den kræver ikke, at man bygger en ny version af de oprindelige apps.

Hvis du er interesseret i at hente data i Prenlytics-format, bedes du kontakte vores helpdesk.