Eksport danych Prenlytics

Wprowadzenie

Prenlytics to potężny framework eksportowy zaprojektowany do bezpiecznego przesyłania wzbogaconych surowych danych statystycznych w formacie JSON do zewnętrznego punktu końcowego API. Przepływ ten jest dostosowany do potrzeb klientów, którzy muszą zintegrować szczegółowe analizy oparte na zdarzeniach bezpośrednio z własnymi systemami, oferując bogaty i elastyczny format danych, który można łatwo włączyć do własnych baz danych klienta lub innych aplikacji.

Oferujemy również elastyczność w zakresie konwersji i przekazywania danych do niestandardowych formatów za pośrednictwem integracji backend-to-backend. Niezależnie od tego, czy potrzebujesz danych w określonym formacie, czy też chcesz, aby były one wysyłane bezpośrednio do systemu innej firmy, rozwiązanie to może być dostosowane do Twoich dokładnych wymagań.

Szczegóły wdrożenia

Przesyłanie danych

Klienci Prenly Reader wysyłają dane statystyczne do dedykowanej usługi zaplecza Prenlytics, która została zaprojektowana specjalnie do obsługi dużego obciążenia i intensywności ruchu związanego z przetwarzaniem danych statystycznych na dużą skalę. Ten backend działa niezależnie od standardowych interfejsów API Prenly, aby zapewnić płynne działanie nawet w warunkach dużego natężenia ruchu.

Dokumentacja schematu JSON

Wszystkie eksportowane dane są zgodne ze schematem JSON, który definiuje zarówno strukturę danych, jak i zapewnia podstawową dokumentację tekstową. Gwarantuje to, że eksportowane dane są konsekwentnie zgodne z zasadami schematu, dzięki czemu integracja z systemami zewnętrznymi jest stabilna i niezawodna.

Szczegóły dotyczące każdego zdarzenia i jego wymiarów są bardziej szczegółowo udokumentowane tutaj.

Uwagi techniczne

• W schemacie JSON większość pól nie jest zdefiniowana jako wymagana, co zapewnia elastyczność dla przyszłych aktualizacji. Taka konstrukcja minimalizuje ryzyko błędów walidacji w przypadku dodania nowych pól lub aktualizacji schematu.
• Aby zmniejszyć ilość wysyłanych danych, właściwości bez wartości (zwykle reprezentowane jako null) nie będą uwzględniane - zamiast tego właściwość jest całkowicie pomijana w obiekcie JSON.
• Oprócz dokumentowania struktury danych, schemat może być również używany do walidacji technicznej, co może uprościć potoki przetwarzania.

Wersjonowanie i kompatybilność

Semantyczne wersjonowanie

Prenlytics stosuje semantyczne wersjonowanie do zarządzania aktualizacjami schematu JSON. Takie podejście zapewnia, że aktualizacje są przewidywalne i kompatybilne wstecz, chyba że nastąpi poważna zmiana wersji. Numer wersji ma strukturę MAJOR.MINOR.PATCH (na przykład 1.17.4), gdzie:

• MAJOR wzrasta, gdy wprowadzane są zmiany przełamujące. Zmiany te nie są kompatybilne wstecz i mogą wymagać dostosowania integracji. Powiadomimy klientów z dużym wyprzedzeniem, jeśli planowana jest duża aktualizacja, aby zapewnić płynne przejście.
• MINOR wzrasta, gdy dodawane są nowe, wstecznie kompatybilne właściwości danych, w tym nowe właściwości zdarzeń. Nowe właściwości nigdy nie będą wymagane w schemacie JSON, zapewniając, że istniejące integracje pozostaną nienaruszone.
• PATCH zwiększa się, gdy wprowadzane są niewielkie zmiany, w tym poprawki błędów kompatybilne wstecz i zmiany tekstowe w opisach.

Zarządzanie wieloma wersjami schematu

Należy pamiętać, że wiele wersji schematu może być aktywnych jednocześnie na różnych platformach:

Aplikacje internetowe: Wdrożenia internetowe mogą szybko przyjąć nowe wersje schematu, gdy tylko zostaną wydane. Gdy platforma internetowa zostanie zaktualizowana, może rozpocząć wysyłanie danych przy użyciu najnowszej wersji schematu.

Aplikacje natywne: W przypadku aplikacji natywnych (iOS i Android) wersje schematu są powiązane z wersją aplikacji zainstalowanej na urządzeniu użytkownika. Ponieważ nie wszyscy użytkownicy natychmiast aktualizują swoje aplikacje, starsze wersje schematów mogą pozostać w użyciu długo po wydaniu nowej wersji.

Aby uprościć obsługę tego, zapewniamy pełną dokumentację starych, aktualnych i planowanych wersji.

Wersje schematów i odniesienia

Ta tabela przedstawia zarówno wydane, jak i robocze wersje formatu danych Prenlytics, a także czas ich wydania lub planowanego wydania.

Konfiguracja

Konfiguracja eksportu Prenlytics

Eksport Prenlytics jest wbudowany we wszystkich klientach aplikacji Prenly (web, Android, iOS), więc jego aktywacja nie wymaga tworzenia nowych wersji aplikacji natywnych.

Jeśli jesteś zainteresowany pobieraniem danych w formacie Prenlytics, skontaktuj się z naszym działem pomocy.