Lire en anglais

Partager via


App Center Analytics (MAUI et Xamarin)

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.

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 démarré le SDK, il effectue automatiquement le suivi des sessions et des propriétés de l’appareil comme la version du système d’exploitation, le modèle, etc. sans écrire de code supplémentaire.

Indicatif de pays

Le Kit de développement logiciel (SDK) signale automatiquement le code de pays d’un utilisateur si un modem de données mobiles et une carte SIM sont installés sur l’appareil. Les appareils Wi-Fi uniquement ne signalent pas d’indicatif de pays par défaut. Pour définir le code de pays de ces utilisateurs, vous devez récupérer l’emplacement de l’utilisateur vous-même et utiliser la SetCountryCode: méthode dans le Kit de développement logiciel (SDK) :

AppCenter.SetCountryCode("en");

Notes

Pour que le code de pays s’affiche sur les sessions Analytics, AppCenter.SetCountryCode doit être appelé avant d’appeler AppCenter.Start.

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

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

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

Analytics.TrackEvent("Video clicked");

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 d’analyse pour l’application.

Analytics.SetEnabledAsync(false);

Pour réactiver App Center Analytics, utilisez la même API, mais passez true en tant que paramètre.

Analytics.SetEnabledAsync(true);

Vous n’avez pas besoin d’attendre cet appel pour rendre les autres appels d’API (par IsEnabledAsyncexemple) cohérents.

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

Notes

Cette méthode ne doit être utilisée qu’après Analytics le démarrage.

Vérifier si App Center Analytics est activé

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

bool isEnabled = await Analytics.IsEnabledAsync();

Notes

Cette méthode ne doit être utilisée qu’après Analytics le démarrage. Elle est toujours retournée false avant le démarrage.

Gérer démarrer la session

Par défaut, l’ID de session dépend du cycle de vie de l’application. Si vous souhaitez contrôler manuellement le début d’une nouvelle session, suivez les étapes suivantes :

Notes

Faites attention à ce que chaque appel de l’API Analytics.StartSession() génère une nouvelle session. Si en mode suivi de session manuel, cette API ne sera pas appelée, alors tous les journaux d’envoi auront une valeur de session Null.

Notes

Faites attention au fait qu’après le lancement d’une nouvelle application, l’ID de session est régénéré.

  • Appelez la méthode suivante avant le démarrage du Kit de développement logiciel (SDK) :
Analytics.EnableManualSessionTracker();
  • Vous pouvez ensuite utiliser l’API StartSession après :AppCenter.Start
Analytics.StartSession();

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