

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
<a name="analytics"></a>

 [Amazon Mobile Analytics](https://aws.amazon.com/mobileanalytics/) 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
<a name="key-concepts"></a>

### Berichtstypen
<a name="report-types"></a>

Im Auslieferungszustand stellt Mobile Analytics die folgenden Berichte in der Mobile Analytics-Konsole bereit:
+ Aktive Benutzer pro Tag (Daily Active Users, DAU) und pro Monat (Monthly Active Users, MAU) sowie neue Benutzer
+ Treuefaktor (DAU geteilt durch MAU)
+ Sitzungsanzahl und mittlere Anzahl Sitzungen pro aktivem Benutzer pro Tag
+ Mittlerer Ertrag pro DAU (Average Revenue per Daily Active User, ARPDAU) und mittlerer Ertrag pro bezahlendem DAU (Average Revenue per Daily Paying Active User, ARPPDAU)
+ Kundenbindung für 1, 3 und 7 Tage sowie für 1, 2 und 3 Wochen
+ Benutzerdefinierte Ereignisse

Diese Berichte werden über sechs Berichtsregisterkarten in der Konsole bereitgestellt:
+  **Overview (Übersicht)** – Verfolgen Sie neun vordefinierte Berichte in einem übersichtlichen Dashboard, um sich schnell einen Eindruck über die Nutzung zu verschaffen: MAU, DAU, New Users (Neue Benutzer), Daily Sessions (Tägliche Sitzungen), Sticky Factor (Treuefaktor), 1-Day Retention (Kundenbindung für einen Tag), ARPDAU, Daily Paying Users (Täglich zahlende Benutzer), ARPPDAU.
+  **Active Users (Aktive Benutzer)** – Verfolgen Sie nach, wie viele Benutzer sich täglich und monatlich mit Ihrer App beschäftigen, und überwachen Sie den Treuefaktor, um Bindung, Attraktivität und Monetarisierung einschätzen zu können.
+  **Sessions (Sitzungen)** – Verfolgen Sie, wie oft Ihre App an einem bestimmten Tag verwendet wird und wie oft jeder Benutzer Ihre App im Lauf eines Tages öffnet.
+  **Retention (Kundenbindung)** – Verfolgen Sie auf täglicher und wöchentlicher Basis die Rate, mit der Kunden zur App zurückkehren.
+  **Revenue (Umsatz)** – Verfolgen Sie die In-App-Umsatz-Trends, um Bereiche zu identifizieren, in denen die Monetarisierung verbessert werden sollte.
+  **Custom events (Benutzerdefinierte Ereignisse)** – Verfolgen Sie benutzerdefinierte, für die App spezifische Benutzeraktionen.

Weitere Informationen zu Mobile Analytics und zum Arbeiten in der Mobile Analytics finden Sie in der Mobile [Mobile Analytics unter Berichtsübersicht](https://docs.aws.amazon.com/mobileanalytics/latest/ug/using-the-console.html) im Mobile Analytics.

## Projekteinrichtung
<a name="project-setup"></a>

### Prerequisites
<a name="prerequisites"></a>

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](setup.md).

### Konfigurieren der Mobile Analytics-Einstellungen
<a name="configure-mobile-analytics-settings"></a>

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;
```
+  **SessionTimeout** – Wenn die App eine Zeit im Hintergrund bleibt, die größer ist als der SessionTimeout , beendet der Mobile Analytics die aktuelle Sitzung und es wird eine neue Sitzung erstellt, wenn die App wieder in den Vordergrund kommt. Wir empfehlen die Verwendung von Werten zwischen 5 und 10. Der Standardwert lautet 5.
+  **MaxDBSize** – Die maximale Größe der Datenbank (in Bytes), die für die lokale Speicherung von Ereignissen verwendet wird. Wenn die Datenbankgröße diesen Wert überschreitet, werden weitere Ereignisse ignoriert. Wir empfehlen die Verwendung von Werten zwischen 1 MB und 10 MB. Der Standardwert ist 5 242 880 (5 MB).
+  **DBWarningThreashold** – Der Warnschwellenwert. Gültige Werte liegen zwischen 0 und 1. Wenn die Werte den Grenzwert überschreiten, werden Warnungsprotokolle erstellt. Der Standardwert lautet 0.9.
+  **MaxRequestSize** – Die maximale Größe einer HTTP-Anforderung an den Mobile Analytics. Der Wert wird in Byte angegeben und kann zwischen 1 KB und 512 KB betragen. Der Standardwert lautet 102 400 (100 KB). Verwenden Sie keine Werte, die größer als 512 KB sind, da dies dazu führen kann, dass der Service die HTTP-Anforderung ablehnt.
+  **AllowUseDataNetwork** – Ein Wert, der angibt, ob ein Service-Aufruf über ein Mobilfunknetz zulässig ist. Verwenden Sie diese Option mit Vorsicht, da sie zu erhöhter Datennutzung der Kunden führen kann.

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

## Integrieren von Mobile Analytics in die Anwendung
<a name="integrating-mobile-analytics-with-your-application"></a>

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

### Erstellen einer Anwendung in der Mobile Analytics-Konsole
<a name="create-an-app-in-the-mobile-analytics-console"></a>

Navigieren Sie zur [Amazon Mobile Analytics](https://aws.amazon.com/mobileanalytics/) 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](setup.md).

Weitere Informationen zum Arbeiten in der Mobile Analytics finden Sie unter Mobile [Mobile Analytics Console Reports Overview](https://docs.aws.amazon.com/mobileanalytics/latest/ug/using-the-console.html) im Mobile Analytics.

### Erstellen eines MobileAnalyticsManager Clients
<a name="create-a-mobileanalyticsmanager-client"></a>

Um Ihre zu MobileAnalyticsManagerinitialisieren, rufen Sie GetOrCreateInstance auf Ihrer auf `MobileAnalyticsManager`und übergeben Ihre AWS-Anmeldeinformationen, Ihre Region, Ihre Mobile Analytics und Ihr optionales Konfigurationsobjekt:

```
// 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. Dadurch wird die Seite App Management (App-Verwaltung) angezeigt, auf der alle registrierten Apps und deren App aufgelistet IDssind.

### Aufzeichnen von Monetarisierungsereignissen
<a name="record-monetization-events"></a>

AWS Mobile SDK for .NET and Xamarin 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
<a name="record-custom-events"></a>

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](https://aws.amazon.com/mobileanalytics/faqs/#custom-event-details).

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 „LevelComplete“-Ereignis, indem Sie eine neue `AmazonMobileAnalyticsEvent`-Instance erstellen:

```
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
<a name="recording-sessions"></a>

#### Xamarin iOS
<a name="xamarin-ios"></a>

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

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

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

#### Xamarin Android
<a name="xamarin-android"></a>

Für Android-Apps rufen Sie `MobileAnalyticsManager.PauseSesion` in der OnPause()-Methode und `MobileAnalyticsManager.ResumeSession` in der 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\$1mobile\$1analytics.json konfiguriert werden, indem der Eigenschaft "SESSION\$1DELTA" die Anzahl der Sekunden zugewiesen wird, die bis zum Erstellen einer neuen Sitzung verstreichen muss.