App Center Analytics (React Native)

Wichtig

Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie eine Migration in Betracht ziehen können.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

App Center Analytics hilft Ihnen dabei, das Benutzerverhalten und die Kundenbindung zu verstehen, um Ihre App zu verbessern. Das SDK erfasst automatisch die Sitzungsanzahl und Geräteeigenschaften wie Modell, Betriebssystemversion usw. Sie können Ihre eigenen benutzerdefinierten Ereignisse definieren, um Dinge zu messen, die für Sie wichtig sind. Alle erfassten Informationen sind im App Center-Portal verfügbar, damit Sie die Daten analysieren können.

Befolgen Sie den Abschnitt Erste Schritte , wenn Sie das SDK noch nicht in Ihrer Anwendung eingerichtet haben.

Sitzungs- und Geräteinformationen

Nachdem Sie App Center Analytics zu Ihrer App hinzugefügt haben und das SDK gestartet wurde, werden Automatisch Sitzungen und Geräteeigenschaften wie Betriebssystemversion, Modell usw. nachverfolgt.

Benutzerdefinierte Ereignisse

Verfolgen Sie Ihre eigenen benutzerdefinierten Ereignisse mit bis zu 20 Eigenschaften , um die Interaktion zwischen Ihren Benutzern und der App zu verstehen.

Nachdem Sie das SDK gestartet haben, verwenden Sie die trackEvent -Methode, um Ihre Ereignisse mit Eigenschaften nachzuverfolgen. Sie können bis zu 200 verschiedene Ereignisnamen senden. Außerdem gibt es eine maximale Beschränkung von 256 Zeichen pro Ereignisnamen und 125 Zeichen pro Ereigniseigenschaftsname und Ereigniseigenschaftswert.

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

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

Diese Funktion gibt eine Zusage zurück, der Erfolgsfall gibt eine leere Zeichenfolge zurück, und der Fehlerfall gibt den Fehler zurück.

Eigenschaften für Ereignisse sind optional. Wenn Sie nur ein Ereignis nachverfolgen möchten, verwenden Sie stattdessen folgendes:

Analytics.trackEvent('Video clicked');

Aktivieren oder Deaktivieren von App Center Analytics zur Laufzeit

Sie können App Center Analytics zur Laufzeit aktivieren und deaktivieren. Wenn Sie sie deaktivieren, erfasst das SDK keine weiteren Analyseinformationen für die App.

await Analytics.setEnabled(false);

Diese Funktion gibt eine Zusage zurück, die in void aufgelöst wird.

Um App Center Analytics erneut zu aktivieren, verwenden Sie dieselbe API, übergeben true Sie jedoch als Parameter.

await Analytics.setEnabled(true);

Der Zustand wird über Anwendungsstarts hinweg im Speicher des Geräts beibehalten.

Überprüfen, ob App Center Analytics aktiviert ist

Sie können auch überprüfen, ob App Center Analytics aktiviert ist.

const enabled = await Analytics.isEnabled();

Diese Funktion gibt eine Zusage zurück, die in aufgelöst booleanwird.

Warten, bis JS App Center Analytics aktiviert hat

Wenn Sie Analyseinformationen für Ihre App-Benutzer sammeln möchten, aber zuerst die Benutzerberechtigung erhalten möchten, haben Sie die Möglichkeit, analysen beim Start nicht zu aktivieren, sondern bis zum richtigen Zeitpunkt zu warten und stattdessen in JavaScript zu aktivieren.

  1. Öffnen Sie die Datei des Projekts, ios/YourAppName/AppDelegate.m und ersetzen Sie durch [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:true];[AppCenterReactNativeAnalytics registerWithInitiallyEnabled:false];.
  2. Öffnen Sie die Datei des Projekts, android/app/src/main/res/values/strings.xml und ersetzen Sie durch <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ALWAYS_SEND</string><string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ENABLE_IN_JS</string>.

Dies bedeutet, dass Sie app Center Analytics zuerst aktivieren müssen, indem Sie die folgende Codezeile hinzufügen, damit alle Informationen an App Center gesendet werden (auch grundlegende Sitzungsinformationen):

await Analytics.setEnabled(true);

Verwalten der Startsitzung

Standardmäßig hängt die Sitzungs-ID vom Lebenszyklus der Anwendung ab. Wenn Sie den Start einer neuen Sitzung manuell steuern möchten, führen Sie die nächsten Schritte aus:

Hinweis

Achten Sie darauf, dass jeder Aufruf der Analytics.StartSession() -API eine neue Sitzung generiert. Wenn diese API im manuellen Sitzungsnachverfolgungsmodus nicht aufgerufen wird, haben alle sendenden Protokolle einen SITZUNGS-NULL-Wert.

Hinweis

Achten Sie darauf, dass nach dem Starten einer neuen Anwendung die Sitzungs-ID neu generiert wird.

Um das SDK für die manuelle Nachverfolgung von Sitzungen zu konfigurieren, müssen Sie die nativen Analytics-APIs enableManualSessionTracker verwenden:

  • Rufen Sie [MSACAnalytics enableManualSessionTracker]; in iOS in der Delegatenmethode der App didFinishLaunchingWithOptions in AppDelegate.mauf[AppCenterReactNative register];. Fügen Sie hinzu @import AppCenterAnalytics , wenn in dieser Datei fehlt.

  • Rufen Sie Analytics.enableManualSessionTracker(); in Android in der onCreate -Methode in SoLoader.initMainApplication.javaauf. Fügen Sie import com.microsoft.appcenter.analytics.Analytics hinzu, wenn in dieser Datei fehlt.

Anschließend können Sie die startSession API in Ihrem React Native-Projekt verwenden:

Analytics.startSession();

Größe des lokalen Speichers

Standardmäßig speichert das SDK bis zu 10 MB An Protokollen im Speicher.

Kein Internetzugriff

Wenn keine Netzwerkkonnektivität vorhanden ist, speichert das SDK bis zu 10 MB An Protokollen im lokalen Speicher. Sobald der Speicher voll ist, beginnt das SDK, alte Protokolle zu verwerfen, um Platz für die neuen Protokolle zu schaffen. Sobald das Gerät wieder Zugriff auf das Internet erhält, sendet das SDK Protokolle im Batch von 50 oder nach 6 Sekunden.

Batchverarbeitung von Ereignisprotokollen

Das App Center SDK lädt Protokolle in einem Batch von 50 hoch, und wenn das SDK nicht über 50 Zu sendende Protokolle verfügt, sendet es nach 6 Sekunden immer noch Protokolle. Es können maximal drei Batches parallel gesendet werden.

Wiederholungs- und Backofflogik

Das App Center SDK unterstützt Back-Off-Wiederholungsversuche bei wiederherstellbaren Netzwerkfehlern. Im Folgenden finden Sie die Wiederholungslogik:

  • Maximal 3 Versuche pro Anforderung.
  • Jede Anforderung verfügt über einen eigenen Wiederholungszustandscomputer.
  • Alle Übertragungskanäle werden deaktiviert (bis zum nächsten App-Prozess), nachdem eine Anforderung alle Wiederholungsversuche aufgebraucht hat.

Back-off-Logik

  • Zufällige 50 %, erste Wiederholung zwischen 5 und 10, zweiter Wiederholungsversuch zwischen 2,5 und 5 Minuten, letzter Versuch zwischen 10 und 20 Minuten.
  • Wenn das Netzwerk von aus zu ein (oder von WLAN auf Mobil) wechselt, werden die Wiederholungszustände zurückgesetzt, und Anforderungen werden sofort wiederholt.