LeAWSKit SDK Mobile pour UnityAWS SDK for .NET. Ce guide fait référence à la version archivée du kit SDK Mobile pour Unity. Pour de plus amples informations, veuillez consulterPrésentation deAWSKit SDK Mobile pour Unity

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

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. Pour plus d'informations sur Mobile Analytics, consultez la page AWS Mobile Analytics.

Intégration d'Amazon Mobile Analytics

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 Cognito. Pour créer un nouveau groupe d'identités Cognito et générer un ID, veuillez consulter le manuel du développeur Cognito Identity.

Intégrer Mobile Analytics dans votre application

Pour accéder à Mobile Analytics à partir de Unity, vous devrez utiliser les éléments suivants à l'aide d'instructions :

using Amazon.MobileAnalytics.MobileAnalyticsManager;
using Amazon.CognitoIdentity;

Il est recommandé d'utiliser Amazon Cognito pour fournir des informations d'identification AWS temporaires à votre application. Ces identifiants permettent à l'application d'accéder à vos ressources AWS. Pour créer un fournisseur d'informations d'identification, suivez les instructions fournies à la section Amazon Cognito Identity.

Instancier unMobileAnalyticsInstance Manager contenant les informations suivantes :

Utilisation de l'MobileAnalyticsClientContextConfig pour initialiser un MobileAnalyticsManager comme illustré dans l'extrait de code suivant :

// Initialize the MobileAnalyticsManager
void Start()
{
    // ...
    analyticsManager = MobileAnalyticsManager.GetOrCreateInstance(
        new CognitoAWSCredentials(<cognitoIdentityPoolId>, <cognitoRegion>),
        <region>,
        <appId>);
    // ...
}

L'appId 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 pour Unity fournit la classe MonetizationEvent, 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, supposons que votre application est un jeu, et que vous voulez enregistrer un événement lorsqu'un utilisateur termine un niveau. Créez un »LevelComplete» événement 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

Lorsque l'application passe à l'arrière-plan, vous pouvez mettre la session en pause. Dans OnApplicationFocus, vérifiez si l'application est en pause. Si tel est le cas, appelez PauseSession, sinon appelez ResumeSession comme illustré dans l'extrait de code suivant :

void OnApplicationFocus(bool focus)
{
    if(focus)
    {
        analyticsManager.ResumeSession();
    }
    else
    {
        analyticsManager.PauseSession();
    }
}

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 peut être configuré dans le fichier awsconfig.xml. Pour plus d'informations, reportez-vous à la section Configuration de Mobile Analytics de la page Prise en main du kit SDK AWS Mobile pour Unity.