In diesem Dokument wird eine alte Version des Android SDK beschrieben. Wenn Sie Analytics noch nicht verwendet haben, verwenden Sie das neueste SDK. Weitere Informationen

Google Analytics SDK for Android v2 (Legacy) – Übersicht

Mit dem Google Analytics SDK für Android können Entwickler ganz einfach Daten zu Nutzerinteraktionen aus ihren Apps erfassen. Dieses Dokument bietet eine Übersicht über den Wert des SDK sowie eine Anleitung zum Einstieg in die Analyse deiner App mit einer einzigen Property-ID und einem EasyTracker.

Einführung

Mit dem Google Analytics SDK für Android können Entwickler ganz einfach Daten zu Nutzerinteraktionen aus ihren Apps erfassen. Mit Google Analytics-Berichten können Entwickler:

  • Die Anzahl der aktiven Nutzer, die ihre Anwendungen verwenden.
  • Aus der ganzen Welt, in der die Anwendung verwendet wird.
  • Akzeptanz und Nutzung bestimmter Funktionen
  • In-App-Käufe und -Transaktionen
  • Anzahl und Typ der Anwendungsabstürze.
  • Und viele weitere nützliche Messwerte.

Außerdem bietet das Google Analytics SDK für Android dir Tools, mit denen du den Erfolg mobiler Marketingkampagnen überwachen kannst. Du erhältst über einen kompletten Einblick in die Leistung deiner Marketingkanäle – von Google Play-Installationen über In-App-Käufe bis hin zu Transaktionen.

Vorbereitung

Prüfen Sie vor der Implementierung des SDK Folgendes:

Erste Schritte

Die ersten Schritte mit dem SDK sind drei:

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

Wenn Sie diese Schritte ausgeführt haben, können Sie Folgendes mit Google Analytics 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“ mit den folgenden Berechtigungen:

<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 zu den Methoden onStart() und onStop() von jeder 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.
  }
}

Für EasyTracker ist Context erforderlich, bevor Sie die zugehörigen Methoden aufrufen können. Im Beispiel oben gilt: 

EasyTracker.getInstance.activityStart(this);

den Kontext. Wenn Sie jedoch EasyTracker-Aufrufe in anderen Klassen oder Methoden ausführen möchten, müssen Sie zuerst die EasyTracker-Methode setContext(Context ctx) 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 namens analytics.xml in diesem Leitfaden verwaltet. Sie müssen diese Datei im Verzeichnis res/values Ihres Projekts erstellen und Ihre Tracking-ID hinzufügen. Das folgende Beispiel zeigt, wie Sie Ihre Tracking-ID hinzufügen und Activity und 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>

Möglicherweise werden Sie von Ihrem Lint Checker vor der Verwendung des Bindestrichs ('-') in Ihrer Tracking-ID gewarnt. Sie können diese Warnung unterdrücken, indem Sie dem <resources>-Tag weitere Attribute hinzufügen:

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

Eine vollständige Liste der Parameter, mit denen Sie die Implementierung konfigurieren können, finden Sie in der Parameterreferenz zu analytics.xml.

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

Nächste Schritte

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

  • Erweiterte Konfiguration: Weitere Informationen zu erweiterten Konfigurationsoptionen, einschließlich der Verwendung mehrerer Tracker.
  • Kampagnen messen: Hier erfahren Sie, wie Sie die Analyse von Kampagnen implementieren, um zu verstehen, welche Kanäle und Kampagnen zu App-Installationen führen.
  • Ereignisse messen – Hier erfahren Sie, wie Sie das Nutzer-Engagement mit interaktiven Inhalten wie Schaltflächen, Videos und anderen Medien mithilfe von Ereignissen messen.
  • In-App Payments messen: Informationen zum Messen von In-App-Zahlungen und -Transaktionen.
  • Nutzertimings: Hier erfahren Sie, wie Sie das Nutzertiming in Ihrer App messen und z. B. die Ladezeiten und die Interaktion mit Medien messen.
  • Analytics.xml-Parameter: Siehe vollständige Liste der analytics.xml-Konfigurationsparameter.