App Center Analytics (React Native)

Usługa App Center Analytics pomaga zrozumieć zachowanie użytkowników i zaangażowanie klientów w celu ulepszenia aplikacji. Zestaw SDK automatycznie przechwytuje liczbę sesji i właściwości urządzenia, takie jak model, wersja systemu operacyjnego itp. Możesz zdefiniować własne zdarzenia niestandardowe, aby mierzyć istotne elementy. Wszystkie przechwycone informacje są dostępne w portalu App Center, aby umożliwić analizę danych.

Postępuj zgodnie z sekcją Wprowadzenie , jeśli zestaw SDK nie został jeszcze skonfigurowany w aplikacji.

Informacje o sesji i urządzeniu

Po dodaniu analizy usługi App Center do aplikacji i uruchomieniu zestawu SDK automatycznie śledzi sesje i właściwości urządzenia, takie jak wersja systemu operacyjnego, model itp.

Zdarzenia niestandardowe

Śledź własne zdarzenia niestandardowe z maksymalnie 20 właściwościami , aby zrozumieć interakcję między użytkownikami a aplikacją.

Po uruchomieniu zestawu SDK użyj metody trackEvent do śledzenia swoich zdarzeń wraz z właściwościami. Możesz wysłać do 200 odrębnych nazw zdarzeń. Ponadto istnieje maksymalny limit 256 znaków na nazwę zdarzenia i 125 znaków na nazwę właściwości zdarzenia i wartość właściwości zdarzenia.

// import App Center Analytics at the top of the file.
import Analytics from 'appcenter-analytics';

Analytics.trackEvent('Video clicked', { Category: 'Music', FileName: 'favorite.avi' });

Ta funkcja zwraca obietnicę, przypadek powodzenia zwraca pusty ciąg, a przypadek błędu zwraca błąd.

Właściwości zdarzeń są opcjonalne; Jeśli chcesz śledzić zdarzenie, użyj następującego polecenia:

Analytics.trackEvent('Video clicked');

Włączanie lub wyłączanie analizy usługi App Center w czasie wykonywania

Możesz włączyć i wyłączyć analizę usługi App Center w czasie wykonywania. Jeśli go wyłączysz, zestaw SDK nie będzie zbierał żadnych dodatkowych informacji analitycznych dla aplikacji.

await Analytics.setEnabled(false);

Ta funkcja zwraca obietnicę, która rozwiązuje problem z pustką.

Aby ponownie włączyć usługę App Center Analytics, użyj tego samego interfejsu API, ale przekaż true jako parametr.

await Analytics.setEnabled(true);

Stan jest utrwalany w magazynie urządzenia w ramach uruchamiania aplikacji.

Sprawdzanie, czy usługa App Center Analytics jest włączona

Możesz również sprawdzić, czy usługa App Center Analytics jest włączona, czy nie.

const enabled = await Analytics.isEnabled();

Ta funkcja zwraca obietnicę, która rozwiązuje się na boolean.

Poczekaj, aż js włączy analizę usługi App Center

Jeśli chcesz zebrać informacje analityczne dla użytkowników aplikacji, ale chcesz najpierw uzyskać uprawnienia użytkownika, możesz nie włączyć analizy podczas uruchamiania, ale poczekaj na odpowiedni czas i włącz je w języku JavaScript.

1. Otwórz plik projektu ios/YourAppName/AppDelegate.m i zastąp ciąg [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:true]; ciągiem [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:false];.
2. Otwórz plik projektu android/app/src/main/res/values/strings.xml i zastąp ciąg <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ALWAYS_SEND</string> ciągiem <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ENABLE_IN_JS</string>.

Oznacza to, że aby jakiekolwiek informacje miały być wysyłane do App Center (nawet podstawowe informacje o sesji), musisz najpierw włączyć App Center Analytics, dodając następujący wiersz kodu:

await Analytics.setEnabled(true);

Zarządzanie sesją początkową

Domyślnie identyfikator sesji zależy od cyklu życia aplikacji. Jeśli chcesz ręcznie kontrolować rozpoczęcie nowej sesji, wykonaj następujące kroki:

Aby ręcznie skonfigurować zestaw SDK do śledzenia sesji, musisz użyć natywnych interfejsów API analizy enableManualSessionTracker :

• W systemie iOS wywołaj metodę [MSACAnalytics enableManualSessionTracker]; przed [AppCenterReactNative register]; w metodzie delegata didFinishLaunchingWithOptions aplikacji w pliku AppDelegate.m. Dodaj @import AppCenterAnalytics , jeśli brakuje go w tym pliku.

• W systemie Android wywołaj metodę Analytics.enableManualSessionTracker(); przed SoLoader.init w onCreate metodzie w MainApplication.javapliku . Dodaj import com.microsoft.appcenter.analytics.Analytics , jeśli brakuje go w tym pliku.

Następnie możesz użyć startSession API w swoim projekcie React Native.

Analytics.startSession();

Rozmiar magazynu lokalnego

Domyślnie zestaw SDK przechowuje w magazynie dzienniki o wielkości do 10 MB.

Brak dostępu do Internetu

Jeśli nie ma łączności sieciowej, SDK zapisuje dzienniki do 10 MB w pamięci lokalnej. Po zapełnieniu magazynu zestaw SDK zacznie odrzucać stare dzienniki, aby zapewnić miejsce na nowe dzienniki. Gdy urządzenie odzyska dostęp do Internetu, SDK będzie wysyłać dzienniki w partiach po 50 lub co 6 sekund.

Grupowanie logów zdarzeń

SDK App Center wysyła dzienniki w partiach po 50, a jeśli SDK nie ma 50 dzienników do wysłania, nadal wyśle dzienniki po 6 sekundach. Można wysłać maksymalnie trzy partie równolegle.

Logika ponawiania i wycofywania

Zestaw SDK usługi App Center obsługuje ponawianie prób w przypadku możliwych do odzyskania błędów sieci. Poniżej znajduje się logika ponawiania prób:

• Maksymalnie 3 próby na każde żądanie.
• Każde żądanie ma własny mechanizm stanu ponawiania.
• Wszystkie kanały transmisji są wyłączone (do następnego procesu aplikacji) po wyczerpaniu wszystkich ponownych prób przez jedno żądanie.

Logika odwlekania

• 50% losowań, najpierw ponów próbę z zakresu od 5s do 10s, drugą próbę z zakresu od 2,5 do 5 minut, ostatnia próba z zakresu od 10 do 20 minut.
• Jeśli sieć zmienia się z wyłączonej na włączoną (lub z wi-fi na mobilną), stany ponawiania są restartowane i żądania są ponawiane natychmiast.