App Center Analytics (React Native)

2025-05-05

Viktigt!

Visual Studio App Center drogs tillbaka den 31 mars 2025, förutom analys- och diagnostikfunktionerna, som fortsätter att stödjas fram till den 30 juni 2026. Läs mer.

App Center Analytics hjälper dig att förstå användarbeteende och kundengagemang för att förbättra din app. SDK samlar automatiskt in sessionsantal och enhetsegenskaper som modell, operativsystemversion osv. Du kan definiera dina egna anpassade händelser för att mäta saker som är viktiga för dig. All information som samlas in är tillgänglig i App Center-portalen så att du kan analysera data.

Följ avsnittet Komma igång om du inte har konfigurerat SDK:t i ditt program ännu.

Information om sessioner och enheter

När du har lagt till App Center Analytics i din app och SDK:n har startats spårar den automatiskt sessioner och enhetsegenskaper som OS-version, modell osv.

Anpassade händelser

Spåra dina egna anpassade händelser med upp till 20 egenskaper för att förstå interaktionen mellan dina användare och appen.

När du har startat SDK använder du trackEvent metoden för att spåra händelser med egenskaper. Du kan skicka upp till 200 distinkta händelsenamn. Det finns också en maxgräns på 256 tecken per händelsenamn och 125 tecken per händelseegenskapsnamn och händelseegenskapsvärde.

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

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

Den här funktionen returnerar ett löfte, framgångsfallet returnerar en tom sträng och felfallet returnerar felet.

Egenskaper för händelser är valfria. Om du bara vill spåra en händelse använder du detta i stället:

Analytics.trackEvent('Video clicked');

Aktivera eller inaktivera App Center Analytics vid körning

Du kan aktivera och inaktivera App Center Analytics under körning. Om du inaktiverar det samlar SDK inte in mer analysinformation för appen.

await Analytics.setEnabled(false);

Den här funktionen returnerar ett löfte som löser sig till void.

Om du vill aktivera App Center Analytics igen använder du samma API men skickar true som en parameter.

await Analytics.setEnabled(true);

Tillståndet sparas i enhetens lagring mellan programstarter.

Kontrollera om App Center Analytics är aktiverat

Du kan också kontrollera om App Center Analytics är aktiverat eller inte.

const enabled = await Analytics.isEnabled();

Den här funktionen returnerar ett löfte som löses till en boolean.

Vänta tills JS har aktiverat App Center Analytics

Om du vill samla in analysinformation för dina appanvändare men vill få användarbehörighet först kan du välja att inte aktivera analys vid start, utan vänta tills rätt tid och aktivera den i JavaScript i stället.

Öppna projektets ios/YourAppName/AppDelegate.m fil och ersätt [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:true]; med [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:false];.
Öppna projektets android/app/src/main/res/values/strings.xml fil och ersätt <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ALWAYS_SEND</string> med <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ENABLE_IN_JS</string>.

Det innebär att för att all information ska skickas till App Center (även grundläggande sessionsinformation) måste du först aktivera App Center Analytics genom att lägga till följande kodrad:

await Analytics.setEnabled(true);

Hantera startsessionen

Som standard beror sessions-ID:t på programmets livscykel. Om du vill styra starten av en ny session manuellt följer du nästa steg:

Anmärkning

Var uppmärksam på att varje anrop av Analytics.StartSession() API genererar en ny session. Om det här API:et inte anropas i läget för manuell sessionsspårare har alla sändande loggar ett null-sessionsvärde.

Anmärkning

Var uppmärksam på att sessions-ID:t kommer att återskapas när ett nytt program startas.

Om du vill konfigurera SDK för spårningssession manuellt måste du använda api:erna för intern analys enableManualSessionTracker :

I iOS kallar du [MSACAnalytics enableManualSessionTracker]; före [AppCenterReactNative register]; i appens didFinishLaunchingWithOptions delegatmetod i AppDelegate.m. Lägg till @import AppCenterAnalytics om det saknas i filen.
Anropa Analytics.enableManualSessionTracker(); före SoLoader.init i onCreate-metoden i MainApplication.java på Android. Lägg till import com.microsoft.appcenter.analytics.Analytics om det saknas i filen.

Sedan kan du använda API:et startSession i ditt React Native-projekt:

Analytics.startSession();

Lokal lagringsstorlek

Som standard lagrar SDK upp till 10 MB loggar i lagringen.

Ingen internetåtkomst

När det inte finns någon nätverksanslutning sparar SDK upp till 10 MB loggar i den lokala lagringen. När lagringen är full börjar SDK:n ta bort gamla loggar för att ge plats åt de nya loggarna. När enheten får internetåtkomst tillbaka skickar SDK:n loggar i batchen på 50 eller efter var 6:e sekund.

Batchbearbetning av händelseloggar

App Center SDK laddar upp loggar i en batch på 50 och om SDK:t inte har 50 loggar att skicka skickar det fortfarande loggar efter 6 sekunder. Det kan finnas högst tre batchar som skickas parallellt.

Logik för återförsök och avstigning

App Center SDK stöder back-off-återförsök vid återställningsbara nätverksfel. Nedan visas logiken för återförsök:

3 försök maximalt per begäran.
Varje begäran har en egen återförsökstillståndsmaskin.
Alla överföringskanaler är inaktiverade tills nästa gång appen körs, efter att alla omförsök för en begäran har förbrukats.

Återgångslogik

50% randomisering, första försöket mellan 5 och 10 sekunder, andra försöket mellan 2,5 och 5 minuter, sista försöket mellan 10 och 20 minuter.
Om nätverket växlar från av till på (eller från wi-fi till mobil) återställs återförsökstillstånden och begäranden görs om omedelbart.

Dela via