App Center Analytics (Apache Cordova)

Artikel
03/15/2024

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.

Hinweis

Der Support für Cordova-Apps wurde im April 2022 eingestellt. Weitere Informationen finden Sie im App Center-Blog.

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

Sobald 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

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 Beschränkung von 256 Zeichen pro Ereignisnamen und 125 Zeichen pro Ereigniseigenschaftsname und Ereigniseigenschaftswert.

var success = function() {
    console.log("Event tracked");
}

var error = function(error) {
    console.error(error);
}
AppCenter.Analytics.trackEvent('Video clicked', { Category: 'Music', FileName: 'favorite.avi' }, success, error);

Diese Funktion verwendet den dritten Parameter als Erfolgsrückruf, der eine leere Zeichenfolge und den vierten Parameter als Fehlerrückruf zurückgibt, der einen Fehler zurückgibt.

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

var success = function() {
    console.log("Event tracked");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.trackEvent('Video clicked', success, error);

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 Analyseinformationen mehr für die App.

var success = function() {
    console.log("Analytics disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(false, success, error);

Diese Funktion verwendet den zweiten Parameter als Erfolgsrückruf, der eine leere Zeichenfolge und den dritten Parameter als Fehlerrückruf zurückgibt, der einen Fehler zurückgibt. Um App Center Analytics erneut zu aktivieren, verwenden Sie dieselbe API, übergeben true Sie jedoch als Parameter.

var success = function() {
    console.log("Analytics enabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(true, success, error);

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.

var success = function(result) {
    console.log("analytics " + (result) ? "enabled" : "disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.isEnabled(success, error);

Diese Funktion verwendet den ersten Parameter als Erfolgsrückruf, der einen und den boolean zweiten Parameter als Fehlerrückruf zurückgibt, der einen Fehler zurückgibt.

Warten, bis JS App Center Analytics aktiviert hat

In einigen Fällen möchte eine Anwendung Benutzer möglicherweise fragen, ob sie Analyseinformationen freigeben möchten. In diesem Fall sollten Sie die Einstellung APPCENTER_ANALYTICS_ENABLE_IN_JStrue in Ihrem config.xml

<preference name="APPCENTER_ANALYTICS_ENABLE_IN_JS" value="true" />

Dies bedeutet, dass der Entwickler zuerst App Center Analytics innerhalb der App aktivieren muss, indem er die folgende Zeile zu seinem Code hinzufügt, damit informationen an App Center gesendet werden (auch grundlegende Sitzungsinformationen).

var success = function() {
    console.log("analytics disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(true, success, error);

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 3 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 3 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.