Freigeben über

App Center Analytics (MAUI und Xamarin)

Von Bedeutung

Visual Studio App Center wurde am 31. März 2025 eingestellt, mit Ausnahme der Analyse- und Diagnosefeatures, die bis zum 30. Juni 2026 weiterhin unterstützt werden. Weitere Informationen

App Center Analytics hilft Ihnen, 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 eigene benutzerdefinierte 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.

Folgen Sie dem 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 und das SDK gestartet haben, werden Automatisch Sitzungen und Geräteeigenschaften wie Betriebssystemversion, Modell usw. nachverfolgt, ohne zusätzlichen Code zu schreiben.

Ländercode

Das SDK meldet automatisch den Ländercode eines Benutzers, wenn das Gerät über ein mobiles Datenmodem und eine SIM-Karte verfügt. Nur WLAN-Geräte melden standardmäßig keinen Ländercode. Um den Ländercode dieser Benutzer festzulegen, müssen Sie den Standort Des Benutzers selbst abrufen und die SetCountryCode: Methode im SDK verwenden:

AppCenter.SetCountryCode("en");

Hinweis

Damit der Ländercode in Analytics-Sitzungen angezeigt wird, muss AppCenter.SetCountryCode vor AppCenter.Start aufgerufen werden.

Benutzerdefinierte Ereignisse

Sie können eigene benutzerdefinierte Ereignisse mit bis zu 20 Eigenschaften nachverfolgen, 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 unterschiedliche Ereignisnamen senden. Außerdem gibt es ein Maximum von 256 Zeichen pro Ereignisname und 125 Zeichen pro Ereigniseigenschaftsname und Ereigniseigenschaftswert.

Analytics.TrackEvent("Video clicked", new Dictionary<string, string> {
	{ "Category", "Music" },
	{ "FileName", "favorite.avi"}
});

Eigenschaften für Ereignisse sind vollständig optional – wenn Sie nur ein Ereignis nachverfolgen möchten, verwenden Sie stattdessen dieses Beispiel:

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 es deaktivieren, sammelt das SDK keine weiteren Analyseinformationen für die App.

Analytics.SetEnabledAsync(false);

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

Analytics.SetEnabledAsync(true);

Sie müssen diesen Aufruf nicht warten, um andere API-Aufrufe (z IsEnabledAsync. B. ) konsistent zu machen.

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

Hinweis

Diese Methode darf nur verwendet werden, nachdem Analytics gestartet wurde.

Überprüfen, ob App Center Analytics aktiviert ist

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

bool isEnabled = await Analytics.IsEnabledAsync();

Hinweis

Diese Methode darf nur verwendet werden, nachdem Analytics gestartet wurde; vor dem Start wird aber immer false zurückgegeben.

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 folgenden Schritte aus:

Hinweis

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

Hinweis

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

  • Rufen Sie die folgende Methode vor dem SDK-Start auf:
Analytics.EnableManualSessionTracker();
  • Anschließend können Sie die StartSession API nach dem AppCenter.Start verwenden.
Analytics.StartSession();

Größe des lokalen Speichers

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

Kein Internetzugang

Wenn keine Netzwerkkonnektivität vorhanden ist, speichert das SDK bis zu 10 MB Protokolle im lokalen Speicher. Sobald der Speicher voll ist, verwirft das SDK alte Protokolle, um Platz für die neuen Protokolle zu schaffen. Sobald das Gerät den Internetzugriff zurück erhält, sendet das SDK Protokolle im Batch von 50 oder nach allen 6 Sekunden.

Ereignisprotokolle im Batchmodus

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

Wiederholungs- und Back-off-Logik

Das App Center SDK unterstützt Back-off-Wiederholungen bei wiederherstellbaren Netzwerkfehlern. Nachfolgend finden Sie die Wiederholungslogik:

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

Rückzug-Logik

  • 50% Randomisierung, erster Versuch zwischen 5 und 10 Sekunden, zweiter Versuch zwischen 2,5 und 5 Minuten, letzter Versuch zwischen 10 und 20 Minuten.
  • Wenn das Netzwerk von "aus" nach "ein" (oder von wi-fi zu "mobil") umgeschaltet wird, werden Wiederholungszustände zurückgesetzt, und Anforderungen werden sofort wiederholt.
  • Last updated on