App Center Analytics (Apache Cordova)

Article
03/17/2024

Important

La mise hors service de Visual Studio App Center est prévue pour le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à sa mise hors service complète, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager la migration.

En savoir plus sur les chronologies et les alternatives de support.

Notes

Le support de Cordova Apps a pris fin en avril 2022. Pour plus d’informations, consultez le blog App Center.

App Center Analytics vous aide à comprendre le comportement des utilisateurs et l’engagement des clients pour améliorer votre application. Le Kit de développement logiciel (SDK) capture automatiquement le nombre de sessions et les propriétés de l’appareil, comme le modèle, la version du système d’exploitation, etc. Vous pouvez définir vos propres événements personnalisés pour mesurer les éléments qui vous importent. Toutes les informations capturées sont disponibles dans le portail App Center pour vous permettre d’analyser les données.

Suivez la section Prise en main si vous n’avez pas encore configuré le Kit de développement logiciel (SDK) dans votre application.

Informations sur la session et l’appareil

Une fois que vous avez ajouté App Center Analytics à votre application et que le SDK est démarré, il effectue automatiquement le suivi des sessions et des propriétés de l’appareil, telles que la version du système d’exploitation, le modèle, etc.

Événements personnalisés

Vous pouvez suivre vos propres événements personnalisés avec jusqu’à 20 propriétés pour comprendre l’interaction entre vos utilisateurs et l’application.

Une fois que vous avez démarré le Kit de développement logiciel (SDK), utilisez la trackEvent méthode pour suivre vos événements avec des propriétés. Vous pouvez envoyer jusqu’à 200 noms d’événements distincts. En outre, il existe une limite maximale de 256 caractères par nom d’événement et de 125 caractères par nom de propriété d’événement et valeur de propriété d’événement.

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);

Cette fonction utilise le troisième paramètre comme rappel de réussite qui retourne une chaîne vide et le quatrième paramètre comme rappel d’erreur qui retourne une erreur.

Les propriétés des événements sont entièrement facultatives. Si vous souhaitez simplement suivre un événement, utilisez plutôt cet exemple :

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

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

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

Activer ou désactiver App Center Analytics au moment de l’exécution

Vous pouvez activer et désactiver App Center Analytics au moment de l’exécution. Si vous le désactivez, le Kit de développement logiciel (SDK) ne collecte plus d’informations analytiques pour l’application.

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

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

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

Cette fonction utilise le deuxième paramètre comme rappel de réussite qui retourne une chaîne vide et le troisième paramètre comme rappel d’erreur qui retourne une erreur. Pour réactiver App Center Analytics, utilisez la même API, mais passez true en tant que paramètre.

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

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

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

L’état est conservé dans le stockage de l’appareil au cours des lancements d’application.

Vérifier si App Center Analytics est activé

Vous pouvez également case activée si App Center Analytics est activé.

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

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

AppCenter.Analytics.isEnabled(success, error);

Cette fonction utilise le premier paramètre comme rappel de réussite qui retourne un et le boolean deuxième paramètre comme rappel d’erreur qui retourne une erreur.

Attendez que JS active App Center Analytics

Dans certains cas, une application peut souhaiter demander aux utilisateurs s’ils souhaitent partager des informations d’analyse. Dans ce cas, vous devez remplacer la préférence APPCENTER_ANALYTICS_ENABLE_IN_JS par true dans votre config.xml

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

Cela signifie que pour que toutes les informations soient envoyées à App Center (même les informations de session de base), le développeur doit d’abord activer App Center Analytics à l’intérieur de l’application en ajoutant la ligne suivante à son code.

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

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

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

Taille du stockage local

Par défaut, le SDK stocke jusqu’à 10 Mo de journaux dans le stockage.

Aucun accès à Internet

Lorsqu’il n’existe aucune connectivité réseau, le SDK enregistre jusqu’à 10 Mo de journaux dans le stockage local. Une fois le stockage saturé, le SDK commence à ignorer les anciens journaux pour libérer de l’espace pour les nouveaux journaux. Une fois que l’appareil a rétabli l’accès à Internet, le SDK envoie les journaux dans le lot de 50 ou après toutes les 3 secondes.

Traitement par lot des journaux des événements

Le Kit de développement logiciel (SDK) App Center charge les journaux dans un lot de 50 et si le SDK n’a pas 50 journaux à envoyer, il envoie toujours les journaux après 3 secondes. Il peut y avoir un maximum de trois lots envoyés en parallèle.

Logique de nouvelle tentative et d’interruption

Le Kit de développement logiciel (SDK) App Center prend en charge les nouvelles tentatives de sauvegarde sur les erreurs réseau récupérables. Voici la logique de nouvelle tentative :

3 tentatives maximum par demande.
Chaque requête a sa propre machine d’état de nouvelle tentative.
Tous les canaux de transmission sont désactivés (jusqu’au processus d’application suivant) après qu’une requête a épuisé toutes ses nouvelles tentatives.

Logique d’authentification

Randomisation à 50 %, première nouvelle tentative entre 5 et 10s, deuxième tentative entre 2,5 et 5 minutes, dernière tentative entre 10 et 20 minutes.
Si le réseau bascule de off à on (ou du wi-fi au mobile), les états de nouvelle tentative sont réinitialisés et les demandes sont retentées immédiatement.