Google Analytics SDK for Android Version 2 (alte Version) – Übersicht

Mit dem Google Analytics SDK für Android können Entwickler ganz einfach Daten zur Nutzerinteraktion aus ihren Apps erfassen. In diesem Dokument erhalten Sie eine Übersicht über die Vorteile des SDK sowie eine Anleitung für die ersten Schritte zur Analyse Ihrer App mithilfe einer einzelnen Property-ID und EasyTracker.

Einführung

Mit dem Google Analytics SDK für Android können Entwickler ganz einfach Daten zum Nutzer-Engagement in ihren Apps erfassen. Anhand der Google Analytics-Berichte können sie dann Folgendes messen:

  • Die Anzahl der aktiven Nutzer, die ihre Anwendungen verwenden.
  • Von wo auf der Welt die Anwendung verwendet wird.
  • Akzeptanz und Nutzung bestimmter Funktionen
  • In-App-Käufe und -Transaktionen
  • Anzahl und Art der Abstürze der Anwendung.
  • Und viele weitere nützliche Messwerte.

Darüber hinaus bietet Ihnen das Google Analytics SDK for Android Tools, mit denen Sie den Erfolg von Mobile Marketingkampagnen überwachen können. Sie erhalten einen umfassenden Überblick über die Leistung Ihrer Marketingkanäle, von Google Play-Installationen über In-App-Käufe bis hin zu Transaktionen.

Vorbereitung

Bevor Sie mit der Implementierung des SDK beginnen, benötigen Sie Folgendes:

Erste Schritte

Die ersten Schritte mit dem SDK sind drei Schritte:

  1. AndroidManifest.xml aktualisieren
  2. EasyTracker-Methoden hinzufügen
  3. Datei analytics.xml erstellen

Wenn Sie diese Schritte ausgeführt haben, können Sie mit Google Analytics Folgendes messen:

  • App-Installationen
  • Aktive Nutzer und demografische Merkmale
  • Bildschirme und Nutzerinteraktionen
  • Abstürze und Ausnahmen

1. AndroidManifest.xml aktualisieren

Aktualisieren Sie die Datei AndroidManifest.xml, indem Sie die folgenden Berechtigungen hinzufügen:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

2. EasyTracker-Methoden hinzufügen

Fügen Sie die Sendemethoden den Methoden onStart() und onStop() der einzelnen Activities-Objekte hinzu, wie im folgenden Beispiel gezeigt:

/**
 * An example Activity in your app with Analytics
 * implemented.
 */
public class myTrackedActivity extends Activity {
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
  }

  @Override
  public void onStart() {
    super.onStart();
    ... // The rest of your onStart() code.
    EasyTracker.getInstance().activityStart(this); // Add this method.
  }

  @Override
  public void onStop() {
    super.onStop();
    ... // The rest of your onStop() code.
    EasyTracker.getInstance().activityStop(this); // Add this method.
  }
}

Beachten Sie, dass für EasyTracker Context erforderlich ist, bevor Sie die zugehörigen Methoden aufrufen können. Im obigen Beispiel würde diese Zeile:

EasyTracker.getInstance.activityStart(this);

den Kontext zu definieren. Wenn Sie jedoch EasyTracker-Aufrufe in anderen Klassen oder Methoden ausführen müssen, müssen Sie zuerst die setContext(Context ctx)-Methode von EasyTracker aufrufen:

// Set Context before using EasyTracker. Note that the SDK will
// use the application context.
EasyTracker.getInstance().setContext(this);

// EasyTracker is now ready for use.

3. Datei analytics.xml erstellen

In Version 2 des Google Analytics SDK für Android werden Konfigurationsoptionen über eine XML-Ressourcendatei mit dem Namen analytics.xml verwaltet. Sie müssen diese Datei im res/values-Verzeichnis Ihres Projekts erstellen und Ihre Tracking-ID hinzufügen. Das folgende Beispiel zeigt, wie Sie Ihre Tracking-ID hinzufügen und Activity sowie die Ausnahmemessung aktivieren:

<?xml version="1.0" encoding="utf-8" ?>

<resources>
  <!--Replace placeholder ID with your tracking ID-->
  <string name="ga_trackingId">UA-XXXX-Y</string>

  <!--Enable automatic activity tracking-->
  <bool name="ga_autoActivityTracking">true</bool>

  <!--Enable automatic exception tracking-->
  <bool name="ga_reportUncaughtExceptions">true</bool>
</resources>

Die Lint-Prüfung warnt Sie möglicherweise vor der Verwendung eines Strichs (-) in Ihrer Tracking-ID. Sie können diese Warnung unterdrücken, indem Sie Ihrem <resources>-Tag zusätzliche Attribute hinzufügen:

<resources xmlns:tools="http://schemas.android.com/tools"
tools:ignore="TypographyDashes">

Eine vollständige Liste der Parameter, die Sie zur Konfiguration Ihrer Implementierung verwenden können, finden Sie in der Referenz zu den analytics.xml-Parametern.

Glückwunsch! Ihre App ist nun so eingerichtet, dass Daten an Google Analytics gesendet werden.

Nächste Schritte

Mit Google Analytics haben Sie noch viel mehr Möglichkeiten. Sie können beispielsweise Kampagnen, In-App-Zahlungen und -Transaktionen sowie Nutzerinteraktionsereignisse messen. In den folgenden Entwicklerleitfäden erfahren Sie, wie Sie diese Funktionen Ihrer Implementierung hinzufügen:

  • Erweiterte Konfiguration – Erfahre mehr über erweiterte Konfigurationsoptionen, einschließlich der Verwendung mehrerer Tracker.
  • Kampagnen analysieren – Hier erfährst du, wie du die Analyse von Kampagnen implementierst, um herauszufinden, welche Kanäle und Kampagnen zu App-Installationen führen.
  • Ereignisse messen – Hier erfahren Sie, wie Sie mithilfe von Ereignissen Nutzerinteraktionen mit interaktiven Inhalten wie Schaltflächen, Videos und anderen Medien messen.
  • In-App-Zahlungen messen – Hier erfahren Sie, wie Sie In-App-Zahlungen und -Transaktionen messen.
  • Nutzertiming – Erfahren Sie, wie Sie Nutzertimings in Ihrer App messen, um beispielsweise Ladezeiten und Interaktionen mit Medien zu messen.
  • Analytics.xml-Parameter: Hier finden Sie die vollständige Liste der analytics.xml-Konfigurationsparameter.