DieAWSMobile SDK for Unity ist jetzt imAWS SDK for .NETaus. Dieser Leitfaden verweist auf die archivierte Version des Mobile SDK for Unity. Weitere Informationen finden Sie unterWas ist ?AWSMobile SDK for Unity?

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon Mobile Analytics

Mit Amazon Mobile Analytics können Sie das Kundenverhalten verfolgen, Daten generieren, Kennzahlen zusammenstellen, Datenvisualisierungen generieren und aussagekräftige Muster identifizieren. Weitere Informationen zu Mobile Analytics erhalten Sie unter AWS Mobile Analytics.

Integrieren von Amazon Mobile Analytics

Die folgenden Abschnitte erläutern, wie Mobile Analytics in die App integriert werden kann.

Erstellen einer Anwendung in der Mobile Analytics-Konsole

Navigieren Sie zur Amazon Mobile Analytics-Konsole und erstellen Sie eine App. Notieren Sie sich den appId-Wert, da Sie ihn später benötigen werden.

Beim Erstellen einer App in der Mobile Analytics-Konsole müssen Sie eine Cognito-Identitäten-Pool-ID angeben. Informationen zum Erstellen eines neuen Cognito-Identitäten-Pools und zum Generieren einer ID finden Sie im Entwicklerhandbuch von Cognito Identity.

Integrieren von Mobile Analytics in die App

Um mit Unity auf Mobile Analytics zuzugreifen, benötigen Sie die folgenden Verwendungsanweisungen:

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

Eine bewährte Methode besteht darin, Amazon Cognito zu verwenden, um temporäre AWS-Anmeldeinformationen für die Anwendung bereitzustellen. Diese Anmeldeinformationen ermöglichen der Anwendung den Zugriff auf die AWS-Ressourcen. Befolgen Sie zum Erstellen eines Anmeldeinformationsanbieters die Anweisungen unter Amazon Cognito-Identität.

Instanziieren Sie einMobileAnalyticsManager-Instance mit den folgenden Daten:

Verwenden derMobileAnalyticsClientContextConfig zur Initialisierung eines MobileAnalyticsManager Instance wie im folgenden Code-Ausschnitt gezeigt:

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

Die appId wird verwendet, um die Daten in der Mobile Analytics-Konsole zu gruppieren. Sie können die App-ID nach dem Erstellen der App in der Mobile Analytics-Konsole ermitteln, indem Sie zur Mobile Analytics-Konsole navigieren und oben rechts auf dem Bildschirm auf das Zahnradsymbol klicken. Dadurch wird die Seite "App Management" angezeigt, die alle registrierten Apps und deren App-IDs auflistet.

Aufzeichnen von Monetarisierungsereignissen

SDK for Unity stellt die Klasse MonetizationEvent bereit, mit der Sie Monetarisierungsereignisse generieren können, um in der Mobilgeräte-Anwendung getätigte Käufe zu verfolgen. Der folgende Code-Ausschnitt zeigt, wie ein Monetarisierungsereignis erstellt wird:

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

Aufzeichnen benutzerdefinierter Ereignisse

Mit Mobile Analytics können Sie benutzerdefinierte Ereignisse definieren. Benutzerdefinierte Ereignisse werden vollständig von Ihnen definiert. Sie dienen der Verfolgung von Benutzeraktionen, die für die jeweilige App oder das Spiel spezifisch sind. Weitere Informationen zu benutzerdefinierten Ereignissen erhalten Sie unter Custom-Events. In diesem Beispiel gehen wir davon aus, dass es sich bei der App um ein Spiel handelt und Sie ein Ereignis aufzeichnen möchten, wenn ein Benutzer einen Level abschließt. Erstelle ein“LevelComplete“ Event durch Erstellen eines neuenAmazonMobileAnalyticsEventinstanz:

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

Aufzeichnen von Sitzungen

Wenn die Anwendung den Fokus abgibt, kann die Sitzung angehalten werden. Prüfen Sie in OnApplicationFocus, ob die App angehalten wurde. Wenn dies der Fall ist, rufen Sie PauseSession und andernfalls ResumeSession auf (siehe folgenden Code-Ausschnitt):

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

Wenn der Benutzer den Fokus von der App entfernt und für weniger als 5 Sekunden einem anderen Prozess übergibt, bevor er wieder der App zugewiesen wird, wird die Sitzung fortgesetzt. Übergibt der Benutzer den Fokus für 5 Sekunden oder mehr an einen anderen Prozess, wird eine neue Sitzung erstellt. Diese Einstellung kann in der Datei awsconfig.xml konfiguriert werden. Weitere Informationen finden Sie im Abschnitt "Konfigurieren von Mobile Analytics" in Erste Schritte mit AWS Mobile SDK for Unity.