Esportazione dei dati Prenlytics

Introduzione

Prenlytics è un potente framework di esportazione progettato per trasmettere in modo sicuro dati statistici grezzi arricchiti in formato JSON a un endpoint api esterno. Questo flusso è pensato per i clienti che hanno bisogno di integrare analisi dettagliate basate su eventi direttamente nei propri sistemi, offrendo un formato di dati ricco e flessibile, facile da incorporare nei database o in altre applicazioni del cliente.

Offriamo anche la flessibilità di convertire e inoltrare i dati in formati personalizzati tramite integrazioni backend-to-backend. Sia che abbiate bisogno di dati in un formato specifico o che vogliate inviarli direttamente a un sistema di terze parti, questa soluzione può essere adattata alle vostre esigenze.

Dettagli sull'implementazione

Trasferimento dei dati

I client di Prenly Reader inviano i dati statistici a un servizio backend dedicato di Prenlytics, progettato appositamente per gestire l'elevato carico e l'intensità di traffico associati all'elaborazione di dati statistici su larga scala. Questo backend opera in modo indipendente dalle API standard di Prenly per garantire prestazioni ottimali anche in condizioni di traffico intenso.

Documentazione dello schema JSON

Tutti i dati esportati aderiscono a uno schema JSON che definisce la struttura dei dati e fornisce una documentazione testuale di base. Ciò garantisce che i dati esportati seguano costantemente le regole dello schema, rendendo l'integrazione con sistemi esterni stabile e affidabile.

I dettagli relativi a ciascun evento e alle sue dimensioni sono documentati in modo più specifico qui.

Considerazioni tecniche

• Nello schema JSON, la maggior parte dei campi non è definita come obbligatoria, in modo da garantire flessibilità per gli aggiornamenti futuri. Questo design riduce al minimo il rischio di errori di validazione in caso di aggiunta di nuovi campi o di aggiornamento dello schema.
• Per ridurre la quantità di dati inviati, le proprietà senza valore (normalmente rappresentate come null) non vengono incluse, ma vengono omesse completamente dall'oggetto JSON.
• Oltre a documentare la struttura dei dati, lo schema può essere utilizzato anche per la validazione tecnica, semplificando le pipeline di elaborazione.

Versioni e compatibilità

Versioni semantiche

Prenlytics segue il versioning semantico per gestire gli aggiornamenti dello schema JSON. Questo approccio garantisce che gli aggiornamenti siano prevedibili e retrocompatibili, a meno che non si verifichi un cambio di versione importante. Il numero di versione è strutturato come MAJOR.MINOR.PATCH (ad esempio 1.17.4), dove:

• MAJOR aumenta quando vengono introdotte modifiche di rottura. Queste modifiche non sono retrocompatibili e possono richiedere modifiche all'integrazione. In caso di aggiornamento importante, i clienti verranno avvisati con largo anticipo per garantire una transizione senza problemi.
• MINOR aumenta quando vengono aggiunte nuove proprietà di dati compatibili con il passato, comprese nuove proprietà di eventi. Le nuove proprietà non saranno mai richieste nello schema JSON, per garantire che le integrazioni esistenti non siano interessate.
• PATCH aumenta quando vengono apportate piccole modifiche, tra cui la correzione di bug retrocompatibili e modifiche testuali nelle descrizioni.

Gestione di più versioni dello schema

È importante notare che più versioni dello schema possono essere attive contemporaneamente su piattaforme diverse:

Applicazioni Web: Le distribuzioni web possono adottare rapidamente le nuove versioni dello schema non appena vengono rilasciate. Quando la piattaforma web viene aggiornata, può iniziare a inviare i dati utilizzando l'ultima versione dello schema.

Applicazioni native: Per le applicazioni native (iOS e Android), le versioni dello schema sono legate alla versione dell'applicazione installata sul dispositivo dell'utente. Poiché non tutti gli utenti aggiornano immediatamente le loro applicazioni, le vecchie versioni dello schema possono rimanere in uso anche dopo il rilascio di una nuova versione.

Per semplificare il supporto, forniamo una documentazione completa delle versioni vecchie, attuali e previste.

Versioni dello schema e riferimenti

Questa tabella mostra le versioni rilasciate e in bozza del formato dati di Prenlytics, nonché la data di rilascio o la data prevista per il rilascio.

Configurazione

Impostazione dell'esportazione Prenlytics

L'esportazione di Prenlytics è integrata in tutti i client delle applicazioni Prenly (web, Android, iOS), pertanto la sua attivazione non richiede la creazione di nuove versioni delle applicazioni native.

Se siete interessati a recuperare i dati nel formato Prenlytics, contattate il nostro helpdesk.