Das AWS Mobile SDK für Xamarin ist jetzt in der enthalten. AWS SDK für .NET Dieses Handbuch bezieht sich auf die archivierte Version des Mobile SDK für Xamarin.

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

Amazon Mobile Analytics ist ein Service für die Erfassung, Visualisierung, Analyse und Extraktion von App-Nutzungsdaten in großem Umfang. Mobile Analytics erfasst problemlos Standardgerätedaten und benutzerdefinierte Ereignisse und stellt automatisch Berichte für Sie zusammen. Zusätzlich zu den unten aufgeführten zusammenfassenden Berichten können Sie das automatische Exportieren der Daten nach Redshift und S3 zur weiteren Analyse einrichten.

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

Die wichtigsten Konzepte

Berichtstypen

Im Auslieferungszustand stellt Mobile Analytics die folgenden Berichte in der Mobile Analytics-Konsole bereit:

Diese Berichte werden über sechs Berichtsregisterkarten in der Konsole bereitgestellt:

Weitere Informationen zu Mobile Analytics-Berichten und zum Arbeiten in der Mobile Analytics-Konsole erhalten Sie unter Mobile Analytics Console Reports Overview im Entwicklerhandbuch von Mobile Analytics.

Projekteinrichtung

Voraussetzungen

Um Mobile Analytics in der Anwendung verwenden zu können, müssen Sie das SDK in das Projekt aufnehmen. Befolgen Sie zu diesem Zweck die Anweisungen unter Einrichten von AWS Mobile SDK for .NET and Xamarin.

Konfigurieren der Mobile Analytics-Einstellungen

Mobile Analytics definiert einige Einstellungen, die in der Datei awsconfig.xml konfiguriert werden können:

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

Die oben gezeigten Einstellungen sind Standardwerte für die betreffenden Konfigurationselemente.

Integrieren von Mobile Analytics in die Anwendung

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 Identitäten-Pool-ID angeben. Anweisungen zum Erstellen eines Identitäten-Pools erhalten Sie unter Einrichten von AWS Mobile SDK for .NET and Xamarin.

Weitere Informationen zum Arbeiten in der Mobile Analytics-Konsole erhalten Sie unter Mobile Analytics Console Reports Overview im Entwicklerhandbuch von Mobile Analytics.

Erstellen Sie einen MobileAnalyticsManager Client

Um Ihr zu initialisieren MobileAnalyticsManager, rufen Sie Ihr GetOrCreateInstance MobileAnalyticsManager auf und geben Sie Ihre AWS-Anmeldeinformationen, Ihre Region, Ihre Mobile Analytics Analytics-Anwendungs-ID und Ihr optionales Konfigurationsobjekt ein:

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

Die APP_ID wird bei Ausführung des Assistenten zur App-Erstellung generiert. Beide Werte müssen denen in der Mobile Analytics-Konsole entsprechen. Die APP_ID 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. Daraufhin wird die Seite App Management angezeigt, auf der alle registrierten Apps und ihre Apps IDs aufgelistet sind.

Aufzeichnen von Monetarisierungsereignissen

Das AWS Mobile SDK for .NET and Xamarin bietet den MonetizationEvent Kurs, mit dem Sie Monetarisierungsereignisse generieren können, um Käufe innerhalb mobiler Anwendungen nachzuverfolgen. 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. Wir möchten als Ereignis aufzeichnen, wenn ein Benutzer einen Level abschließt. Erstellen Sie ein Ereignis „LevelComplete“, indem Sie eine neue Instanz erstellen: AmazonMobileAnalyticsEvent

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

Xamarin iOS

Wenn die Anwendung den Fokus abgibt, kann die Sitzung angehalten werden. Für iOS-Apps in der AppDelegate .cs-Datei Override DidEnterBackground und WillEnterForeground to call MobileAnalyticsManager.PauseSesion und MobileAnalyticsManager.ResumeSession wie im folgenden Codeausschnitt gezeigt:

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

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

Xamarin Android

Rufen Sie MobileAnalyticsManager.PauseSesion für Android-Apps die OnPause () -Methode und MobileAnalyticsManager.ResumeSession die OnResume () -Methode auf, wie im folgenden Codeausschnitt gezeigt:

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

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

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 Konfigurationsdatei aws_mobile_analytics.json konfiguriert werden, indem der Eigenschaft "SESSION_DELTA" die Anzahl der Sekunden zugewiesen wird, die bis zum Erstellen einer neuen Sitzung verstreichen muss.