Prenlytics-tietojen vienti

Johdanto

Prenlytics on tehokas vientikehys, joka on suunniteltu siirtämään rikastettuja raakatilastotietoja turvallisesti JSON-muodossa ulkoiseen api-loppupisteeseen. Tämä virtaus on räätälöity asiakkaille, jotka tarvitsevat yksityiskohtaista tapahtumapohjaista analytiikkaa suoraan omiin järjestelmiinsä, ja se tarjoaa rikkaan ja joustavan tietomuodon, joka on helppo sisällyttää asiakkaan omiin tietokantoihin tai muihin sovelluksiin.

Tarjoamme myös joustavuutta muuntaa ja välittää tietoja mukautettuihin muotoihin backend-to-backend-integraatioiden kautta. Tarvitsitpa sitten tietoja tietyssä muodossa tai halusitko ne lähetettäväksi suoraan kolmannen osapuolen järjestelmään, tämä ratkaisu voidaan räätälöidä vastaamaan täsmällisesti tarpeitasi.

Toteutuksen yksityiskohdat

Tietojen siirtäminen

Prenly Reader -asiakkaat lähettävät tilastotietoja Prenlyticsin omaan backend-palveluun, joka on suunniteltu erityisesti käsittelemään suuren mittakaavan tilastotietojen käsittelyyn liittyvää suurta kuormitusta ja liikenteen intensiteettiä. Tämä backend toimii Prenlyn vakioliittymistä riippumattomasti, jotta varmistetaan sujuva suorituskyky myös kovassa liikenteessä.

JSON-skeeman dokumentaatio

Kaikki viedyt tiedot noudattavat JSON-skeemaa, joka määrittelee sekä tietojen rakenteen että tarjoaa tekstimuotoisen perusdokumentaation. Näin varmistetaan, että viedyt tiedot noudattavat johdonmukaisesti skeeman sääntöjä, mikä tekee integroinnista ulkoisten järjestelmien kanssa sekä vakaata että luotettavaa.

Kunkin tapahtuman ja sen ulottuvuuksien yksityiskohdat on dokumentoitu tarkemmin tässä.

Tekniset näkökohdat

• JSON-skeemassa useimpia kenttiä ei ole määritelty pakollisiksi, mikä tarjoaa joustavuutta tulevia päivityksiä varten. Tämä suunnittelu minimoi validointivirheiden riskin, kun uusia kenttiä lisätään tai skeemaa päivitetään.
• Lähetettävien tietojen määrän vähentämiseksi ominaisuuksia, joilla ei ole arvoa (tavallisesti nolla), ei oteta mukaan, vaan ominaisuus jätetään kokonaan pois JSON-objektista.
• Tietorakenteen dokumentoinnin lisäksi skeemaa voidaan käyttää myös tekniseen validointiin, mikä voi yksinkertaistaa käsittelyputkia.

Versionointi ja yhteensopivuus

Semanttinen versiointi

Prenlytics noudattaa semanttista versiointia JSON-skeeman päivitysten hallinnassa. Tällä lähestymistavalla varmistetaan, että päivitykset ovat ennakoitavissa ja taaksepäin yhteensopivia, ellei suuria versiomuutoksia tapahdu. Versionumero rakentuu seuraavasti: MAJOR.MINOR.PATCH (esimerkiksi 1.17.4), jossa:

• MAJOR kasvaa, kun tehdään murtavia muutoksia. Nämä muutokset eivät ole taaksepäin yhteensopivia, ja ne saattavat vaatia mukautuksia integrointiin. Ilmoitamme asiakkaille hyvissä ajoin etukäteen, jos suunnitellaan merkittävää päivitystä, jotta siirtyminen olisi sujuvaa.
• MINOR kasvaa, kun lisätään uusia, taaksepäin yhteensopivia dataominaisuuksia, mukaan lukien uudet tapahtumaominaisuudet. Uusia ominaisuuksia ei koskaan vaadita JSON-skeemaan, mikä varmistaa, että nykyiset integraatiot eivät vaikuta niihin.
• PATCH kasvaa, kun tehdään pieniä muutoksia, kuten taaksepäin yhteensopivia virhekorjauksia ja tekstimuutoksia kuvauksiin.

Useiden skeemaversioiden hallinta

On tärkeää huomata, että useat skeemaversiot voivat olla aktiivisia samanaikaisesti eri alustoilla:

Web-sovellukset: Web-käyttöönotot voivat ottaa nopeasti käyttöön uusia skeemaversioita heti, kun ne julkaistaan. Kun web-alusta päivitetään, se voi alkaa lähettää tietoja uusinta skeemaversiota käyttäen.

Natiivit sovellukset: Natiivisovelluksissa (iOS ja Android) skeemaversiot on sidottu käyttäjän laitteeseen asennetun sovelluksen versioon. Koska kaikki käyttäjät eivät päivitä sovelluksiaan välittömästi, vanhemmat skeemaversiot voivat olla käytössä pitkään uuden version julkaisun jälkeen.

Tämän tukemisen helpottamiseksi tarjoamme täydellisen dokumentaation vanhoista, nykyisistä ja suunnitelluista versioista.

Skeemaversiot ja viittaukset

Tässä taulukossa esitetään sekä julkaistut että luonnosversiot Prenlytics-tietoformaatista sekä tieto siitä, milloin ne on julkaistu tai milloin ne on tarkoitus julkaista.

Asetukset

Prenlyticsin viennin määrittäminen

Prenlytics-vienti on sisäänrakennettu kaikkiin Prenly-sovellusasiakkaisiin (web, Android, iOS), joten sen aktivoiminen ei vaadi uuden version rakentamista natiivisovelluksista.

Jos olet kiinnostunut tietojen hakemisesta Prenlytics-muodossa, ota yhteyttä asiakaspalveluumme.