App Center Analytics (MAUI und Xamarin)
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 möglicherweise eine Migration in Erwägung ziehen.
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.
Folgen Sie dem Abschnitt Erste Schritte , wenn Sie das SDK noch nicht in Ihrer Anwendung eingerichtet haben.
Nachdem Sie Ihrer App App Center Analytics hinzugefügt und das SDK gestartet haben, werden Sitzungen und Geräteeigenschaften wie Betriebssystemversion, Modell usw. automatisch nachverfolgt, ohne zusätzlichen Code zu schreiben.
Das SDK meldet automatisch den Ländercode eines Benutzers, wenn auf dem Gerät ein mobiles Datenmodem und eine SIM-Karte installiert ist. Nur-WLAN-Geräte melden standardmäßig keinen Ländercode. Um den Ländercode dieser Benutzer festzulegen, müssen Sie den Standort Ihres Benutzers selbst abrufen und die SetCountryCode:
-Methode im SDK verwenden:
AppCenter.SetCountryCode("en");
Hinweis
Damit der Ländercode in Analysesitzungen angezeigt werden kann, AppCenter.SetCountryCode
muss vor dem Aufrufen AppCenter.Start
aufgerufen werden.
Sie können Ihre eigenen benutzerdefinierten 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 verschiedene Ereignisnamen senden. Außerdem gibt es eine maximale Grenze von 256 Zeichen pro Ereignisnamen und 125 Zeichen pro Ereigniseigenschaftsname und Ereigniseigenschaftenwert.
Analytics.TrackEvent("Video clicked", new Dictionary<string, string> {
{ "Category", "Music" },
{ "FileName", "favorite.avi"}
});
Eigenschaften für Ereignisse sind völlig optional. Wenn Sie nur ein Ereignis nachverfolgen möchten, verwenden Sie stattdessen dieses Beispiel:
Analytics.TrackEvent("Video clicked");
Sie können App Center Analytics zur Laufzeit aktivieren und deaktivieren. Wenn Sie sie 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 abwarten, um andere API-Aufrufe (z IsEnabledAsync
. B. ) konsistent auszuführen.
Der Zustand wird im Speicher des Geräts bei allen Anwendungsstarts beibehalten.
Hinweis
Diese Methode darf erst nach dem Analytics
Start verwendet werden.
Sie können auch überprüfen, ob App Center Analytics aktiviert ist oder nicht.
bool isEnabled = await Analytics.IsEnabledAsync();
Hinweis
Diese Methode darf erst nach dem Analytics
Start verwendet werden. Sie wird immer vor dem Start zurückgegeben false
.
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 NULL-Sitzungswert.
Hinweis
Achten Sie darauf, dass nach dem Starten einer neuen Anwendung die Sitzungs-ID neu generiert wird.
- Rufen Sie die folgende Methode auf, bevor Sie das SDK starten:
Analytics.EnableManualSessionTracker();
- Anschließend können Sie die
StartSession
API nach verwendenAppCenter.Start
:
Analytics.StartSession();
Standardmäßig speichert das SDK bis zu 10 MB Protokolle im Speicher.
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 den Internetzugriff zurückerhalten hat, sendet das SDK Protokolle im Batch von 50 oder nach 6 Sekunden.
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.
Das App Center SDK unterstützt Back-Off-Wiederholungen 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 sind deaktiviert (bis zum nächsten App-Prozess), nachdem eine Anforderung alle Wiederholungen erschöpft hat.
Back-off-Logik
- 50% Randomisierung, erster Wiederholungsversuch zwischen 5s und 10s, zweiter Wiederholungsversuch zwischen 2,5 und 5 Minuten, letzter Versuch zwischen 10 und 20 Minuten.
- Wenn das Netzwerk von Aus zu Ein wechselt (oder von WLAN auf Mobil), werden wiederholungszustände zurückgesetzt, und Anforderungen werden sofort wiederholt.