Le SDKAWS mobile pour Xamarin est désormais inclus dans leAWS SDK for .NET. Ce guide fait référence à la version archivée du SDK mobile pour Xamarin.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Amazon Mobile Analytics

Amazon Mobile Analytics est un service qui vous permet de recueillir, de visualiser, de comprendre et d'extraire les données d'utilisation de votre application à grande échelle. Mobile Analytics capture facilement les données des appareils standard et les événements personnalisés, et génère automatiquement des rapports à votre place. Outre les rapports consolidés mentionnés ci-dessous, vous pouvez également configurer vos données de manière à les exporter automatiquement dans Redshift et S3 pour des analyses complémentaires.

Avec Amazon Mobile Analytics, vous pouvez suivre les comportements des clients, regrouper des mesures, générer des visualisations de données et identifier des tendances pertinentes.

Concepts clés

Types de rapport

Par défaut, Mobile Analytics fournit les rapports suivants dans la console Mobile Analytics :

Ces rapports sont fournis par l'intermédiaire de six onglets dans la console :

Pour en savoir plus sur les rapports Mobile Analytics et sur l'utilisation de la console correspondante, consultez la page Vue d'ensemble des rapports de la console Mobile Analytics dans le Manuel du développeur Mobile Analytics.

Configuration du projet

Prérequis

Pour utiliser Mobile Analytics dans votre application, vous devez ajouter le kit SDK à votre projet. Pour ce faire, suivez les instructions de la section Configurer le kit SDK AWS Mobile pour .NET et Xamarin.

Configurer les paramètres Mobile Analytics

Mobile Analytics définit certains paramètres qui peuvent être configurés dans le fichier awsconfig.xml :

var config = new MobileAnalyticsManagerConfig();
config.AllowUseDataNetwork = true;
config.DBWarningThreshold = 0.9f;
config.MaxDBSize = 5242880;
config.MaxRequestSize = 102400;
config.SessionTimeout = 5;

Les paramètres ci-dessus constituent les valeurs par défaut pour chaque élément de configuration.

Intégration de Mobile Analytics avec votre application

Les sections ci-dessous expliquent comment intégrer Mobile Analytics à votre application.

Créer une application dans la console Mobile Analytics

Accédez à la console Amazon Mobile Analytics et créez une application. Notez la valeur appId car vous en aurez besoin par la suite. Lorsque vous créez une application dans la console Mobile Analytics, vous devez spécifier l'ID de votre groupe d'identités. Pour savoir comment créer un pool d'identités, consultez la section Configurer le kit SDK AWS Mobile pour .NET et Xamarin.

Pour en savoir plus sur l'utilisation de la console Mobile Analytics, consultez la page Vue d'ensemble des rapports de la console Mobile Analytics dans le Manuel du développeur Mobile Analytics.

Création d'unMobileAnalyticsClient Manager

Pour initialiser vos recettesMobileAnalyticsResponsable, appelezGetOrCreateInstanceSur vos recettesMobileAnalyticsManager, en indiquant vos informations d'identification AWS, votre région, votre ID d'application Mobile Analytics et votre objet de configuration facultatif :

// Initialize the MobileAnalyticsManager
analyticsManager = MobileAnalyticsManager.GetOrCreateInstance(
  cognitoCredentials,
  RegionEndpoint.USEast1,
  APP_ID,
  config
);

L'APP_ID est généré pour vous par l'Assistant de création d'applications. Ces deux valeurs doivent correspondre à celles de la console Mobile Analytics. L'APP_ID permet de grouper vos données dans la console Mobile Analytics. Après avoir créé une application dans la console Mobile Analytics, vous pouvez trouver son ID en accédant à la console Mobile Analytics, puis en cliquant sur l'icône en forme de roue dentée dans le coin supérieur droit de l'écran. La page de gestion des applications s'affiche. Elle répertorie toutes les applications enregistrées et leur ID.

Enregistrer les événements de monétisation

Le kit SDK AWS Mobile pour .NET et Xamarin fournit l'optionMonetizationEvent, qui vous permet de générer des événements de monétisation pour suivre les achats effectués au sein d'applications mobiles. L'extrait de code suivant montre comment créer un événement de monétisation :

// Create the monetization event object
MonetizationEvent monetizationEvent = new MonetizationEvent();

// Set the details of the monetization event
monetizationEvent.Quantity = 3.0;
monetizationEvent.ItemPrice = 1.99;
monetizationEvent.ProductId = "ProductId123";
monetizationEvent.ItemPriceFormatted = "$1.99";
monetizationEvent.Store = "Your-App-Store";
monetizationEvent.TransactionId = "TransactionId123";
monetizationEvent.Currency = "USD";

// Record the monetiziation event
analyticsManager.RecordEvent(monetizationEvent);

Enregistrer les événements personnalisés

Mobile Analytics vous permet de définir des événements personnalisés. Vous définissez entièrement les événements personnalisés. Ils vous aident à suivre les actions utilisateur propres à votre application ou à votre jeu. Pour plus d'informations sur les événements personnalisés, consultez la page Evénements personnalisés.

Pour cet exemple, nous supposons que notre application est un jeu, et que nous voulons enregistrer un événement lorsqu'un utilisateur termine un niveau. Créez un »LevelComplete» en créant un nouveauAmazonMobileAnalyticsEventinstance :

CustomEvent customEvent = new CustomEvent("LevelComplete");

// Add attributes
customEvent.AddAttribute("LevelName","Level1");
customEvent.AddAttribute("CharacterClass","Warrior");
customEvent.AddAttribute("Successful","True");

// Add metrics
customEvent.AddMetric("Score",12345);
customEvent.AddMetric("TimeInLevel",64);

// Record the event
analyticsManager.RecordEvent(customEvent);

Sessions d'enregistrement

Xamarin iOS

Lorsque l'application passe à l'arrière-plan, vous pouvez mettre la session en pause. Pour les applications iOS, dans leAppDelegatefichier .cs, remplacerDidEnterBackgroundetWillEnterForegroundAppelezMobileAnalyticsManager.PauseSesionetMobileAnalyticsManager.ResumeSessioncomme illustré dans l'extrait suivant :

public override void DidEnterBackground(UIApplication application)
{
  // ...
  _manager.PauseSesson();
  // ...
}

public override void WillEnterForeground(UIApplication application)
{
  // ...
  _manager.ResumeSession();
  // ...
}

Xamarin Android

Pour les applications Android, appelezMobileAnalyticsManager.PauseSesiondans leOnPause() méthode etMobileAnalyticsManager.ResumeSessiondans leOnResume() comme illustré dans l'extrait de code suivant :

protected override void OnResume()
{
  _manager.ResumeSession();
  base.OnResume();
}

protected override void OnPause()
{
  _manager.PauseSession();
  base.OnPause();
}

Par défaut, si l'utilisateur sort de l'application pendant moins de 5 secondes, puis y revient, sa session reprend. Si l'utilisateur quitte l'application pendant 5 secondes ou plus, une nouvelle session est créée. Ce paramètre est configurable dans le fichier de configuration aws_mobile_analytics.json en définissant la propriété « SESSION_DELTA » sur le délai (en secondes) devant précéder la création d'une nouvelle session.