App Center Analytics (React Native)

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Chociaż możesz nadal używać programu Visual Studio App Center do momentu jego pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

• Android
• iOS
• React Native
• Windows
• MAUI/Xamarin
• Unity
• macOS
• tvOS
• Cordova

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 Centrum aplikacji, aby analizować dane.

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

Informacje o sesji i urządzeniu

Po dodaniu usługi App Center Analytics 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 trackEvent metody , aby śledzić zdarzenia za pomocą właściwości. Można 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 sukcesu zwraca pusty ciąg, a przypadek błędu zwraca błąd.

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

Analytics.trackEvent('Video clicked');

Włączanie lub wyłączanie analizy centrum aplikacji w czasie wykonywania

Możesz włączać i wyłączać analizę centrum aplikacji w czasie wykonywania. Jeśli ją wyłączysz, zestaw SDK nie będzie zbierać dodatkowych informacji analitycznych dotyczących aplikacji.

await Analytics.setEnabled(false);

Ta funkcja zwraca obietnicę, która rozwiązuje problem z unieważnieniem.

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

await Analytics.setEnabled(true);

Stan jest utrwalany w magazynie urządzenia w przypadku 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 jest rozpoznawana booleanjako .

Oczekiwanie na włączenie usługi App Center Analytics przez js

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 właściwy czas i włącz je w języku JavaScript.

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

Oznacza to, że aby wszystkie informacje, które mają być wysyłane do Centrum aplikacji (nawet podstawowe informacje o sesji), należy najpierw włączyć analizę centrum aplikacji przez dodanie następującego wiersza 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:

Uwaga

Zwróć uwagę, że każde wywołanie interfejsu API Analytics.StartSession() spowoduje wygenerowanie nowej sesji. Jeśli w trybie ręcznego śledzenia sesji ten interfejs API nie zostanie wywołany, wszystkie dzienniki wysyłające będą miały wartość sesji o wartości null.

Uwaga

Zwróć uwagę, że po uruchomieniu nowej aplikacji identyfikator sesji zostanie ponownie wygenerowany.

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 metodzie MainApplication.java. Dodaj import com.microsoft.appcenter.analytics.Analytics , jeśli brakuje go w tym pliku.

Następnie możesz użyć interfejsu startSession API w projekcie React Native:

Analytics.startSession();

Rozmiar magazynu lokalnego

Domyślnie zestaw SDK przechowuje do 10 MB dzienników w magazynie.

Brak dostępu do Internetu

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

Przetwarzanie wsadowe dzienników zdarzeń

Zestaw SDK centrum aplikacji przekazuje dzienniki w partii 50, a jeśli zestaw SDK nie ma 50 dzienników do wysłania, nadal będzie wysyłać dzienniki po 6 sekundach. Może istnieć maksymalnie trzy partie wysyłane 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 przedstawiono logikę ponawiania prób:

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

Logika wycofywania

• Losowanie 50%, najpierw ponów próbę z zakresu od 5 do 10, ponawianie próby między 2,5 a 5 minutami, ostatnia próba między 10 a 20 minutami.
• Jeśli sieć przełącza się z wyłączenia do włączonego (lub z sieci Wi-Fi do urządzeń przenośnych), stany ponawiania są resetowane i żądania są natychmiast ponawiane.