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

Mit dem Google Analytics SDK für Android können Entwickler ganz einfach Daten zu Nutzerinteraktionen aus ihren Apps erheben. Dieses Dokument bietet einen Überblick über den Wert des SDK sowie eine Anleitung für die ersten Schritte zum Analysieren Ihrer App mithilfe einer einzelnen Property-ID und EasyTracker.

Einleitung

Mit dem Google Analytics SDK for Android können Entwickler ganz einfach Daten zum Nutzer-Engagement in ihren Apps erheben. Mit Google Analytics-Berichten können Entwickler 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 App-Abstürze.
  • Und viele andere nützliche Messwerte.

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

Vorbereitung

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

Erste Schritte

Für die ersten Schritte mit dem SDK sind drei Schritte erforderlich:

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

Danach können Sie mit Google Analytics Folgendes messen:

  • App-Installationen
  • Aktive Nutzer und demografische Merkmale
  • Bildschirme und Nutzer-Engagement
  • 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() jedes Ihrer Activities 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 die Methoden aufgerufen werden können. Im obigen Beispiel führt diese Zeile wie folgt aus: 

EasyTracker.getInstance.activityStart(this);

sorgt dafür, dass der Kontext entsteht. 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 for Android werden Konfigurationsoptionen über eine XML-Ressourcendatei verwaltet, die in diesem Leitfaden analytics.xml genannt wird. Sie müssen diese Datei im res/values-Verzeichnis Ihres Projekts erstellen und Ihre Tracking-ID hinzufügen. Das folgende Beispiel zeigt, wie Sie eine Tracking-ID hinzufügen und die Activity- und 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 Strichstrichs („-“) in Ihrer Tracking-ID. Sie können diese Warnung unterdrücken, indem Sie dem <resources>-Tag zusätzliche Attribute hinzufügen:

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

In der Parameterreferenz zu analytics.xml finden Sie eine vollständige Liste der Parameter, die Sie zur Konfiguration Ihrer Implementierung verwenden können.

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

Nächste Schritte

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

  • Erweiterte Konfiguration – Hier erfahren Sie mehr über erweiterte Konfigurationsoptionen, einschließlich der Verwendung mehrerer Tracker.
  • Kampagnen messen – Hier erfahren Sie, wie Sie die Kampagnenanalyse implementieren und so herausfinden, 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.
  • Messung von In-App-Zahlungen – Hier erfahren Sie, wie Sie In-App-Zahlungen und -Transaktionen messen.
  • Nutzertiming – Erfahren Sie, wie Sie das Nutzertiming in Ihrer App messen, um beispielsweise Ladezeiten oder Interaktionen mit Medien zu messen.
  • Analytics.xml-Parameter: Hier finden Sie die vollständige Liste der analytics.xml-Konfigurationsparameter.