Eksport av Prenlytics-data

Innledning

Prenlytics er et kraftig eksportrammeverk som er utviklet for sikker overføring av berikede statistiske rådata i JSON-format til et eksternt api-endepunkt. Denne flyten er skreddersydd for kunder som trenger å integrere detaljerte hendelsesbaserte analyser direkte i sine egne systemer, og tilbyr et rikt og fleksibelt dataformat som er enkelt å innlemme i kundens egne databaser eller andre applikasjoner.

Vi tilbyr også fleksibilitet til å konvertere og videresende dataene til tilpassede formater via backend-til-backend-integrasjoner. Enten du trenger data i et bestemt format eller ønsker at de skal sendes direkte til et tredjepartssystem, kan denne løsningen skreddersys slik at den passer akkurat til dine behov.

Detaljer om implementering

Overføring av data

Prenly Reader-klientene sender statistiske data til en dedikert Prenlytics-backend-tjeneste, som er utviklet spesielt for å håndtere den høye belastningen og trafikkintensiteten som er forbundet med statistisk databehandling i stor skala. Denne backend-tjenesten fungerer uavhengig av Prenlys standard-API-er for å sikre jevn ytelse selv under tunge trafikkforhold.

JSON-skjemadokumentasjon

Alle eksporterte data følger et JSON-skjema som definerer både datastrukturen og gir grunnleggende tekstdokumentasjon. Dette sikrer at de eksporterte dataene konsekvent følger skjemaets regler, noe som gjør integrasjonen med eksterne systemer både stabil og pålitelig.

Detaljer om hver enkelt hendelse og dens dimensjoner er mer spesifikt dokumentert her.

Tekniske betraktninger

• I JSON-skjemaet er de fleste feltene ikke definert som obligatoriske, noe som gir fleksibilitet for fremtidige oppdateringer. Denne utformingen minimerer risikoen for valideringsfeil når nye felt legges til eller skjemaet oppdateres.
• For å redusere datamengden som sendes, vil egenskaper uten en verdi (normalt representert som null) ikke bli inkludert - i stedet utelates egenskapen helt fra JSON-objektet.
• I tillegg til å dokumentere datastrukturen kan skjemaet også brukes til teknisk validering, noe som kan forenkle prosesseringsrutinene dine.

Versjonering og kompatibilitet

Semantisk versjonering

Prenlytics bruker semantisk versjonering for å håndtere oppdateringer av JSON-skjemaer. Denne tilnærmingen sikrer at oppdateringer er forutsigbare og bakoverkompatible med mindre det skjer en større versjonsendring. Versjonsnummeret er strukturert som MAJOR.MINOR.PATCH (for eksempel 1.17.4), der:

• MAJOR øker når det innføres banebrytende endringer. Disse endringene er ikke bakoverkompatible og kan kreve justeringer av integrasjonen din. Vi vil varsle kundene i god tid hvis en større oppdatering er planlagt, for å sikre en smidig overgang.
• MINOR øker når nye, bakoverkompatible dataegenskaper, inkludert nye hendelsesegenskaper, legges til. Nye egenskaper vil aldri være påkrevd i JSON-skjemaet, slik at eksisterende integrasjoner ikke påvirkes.
• PATCH øker når det gjøres små endringer, inkludert bakoverkompatible feilrettinger og tekstlige endringer i beskrivelser.

Håndtering av flere skjema-versjoner

Det er viktig å merke seg at flere skjema-versjoner kan være aktive samtidig på tvers av ulike plattformer:

Webapplikasjoner: Webdistribusjoner kan raskt ta i bruk nye versjoner av skjemaet så snart de lanseres. Når nettplattformen oppdateres, kan den begynne å sende data ved hjelp av den nyeste skjemaversionen.

Innebygde applikasjoner: For native apper (iOS og Android) er skjema-versjoner knyttet til versjonen av appen som er installert på brukerens enhet. Siden ikke alle brukere oppdaterer appene sine umiddelbart, kan eldre skjema-versjoner fortsatt være i bruk lenge etter at en ny versjon er lansert.

For å gjøre det enklere å støtte dette, tilbyr vi full dokumentasjon av gamle, nåværende og planlagte versjoner.

Skjemaversjoner og referanser

Denne tabellen viser både utgitte og foreløpige versjoner av Prenlytics-dataformatet, samt når de ble utgitt eller er planlagt utgitt.

Oppsett

Sette opp en Prenlytics-eksport

Prenlytics-eksport er innebygd i alle Prenly-applikasjonsklienter (web, Android, iOS), så aktivering av den krever ikke at du bygger nye versjoner av de opprinnelige appene.

Hvis du er interessert i å hente data i Prenlytics-format, kan du kontakte vår helpdesk.