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 v3 (Legacy) - Erste Schritte

In diesem Dokument werden die ersten Schritte mit dem Google Analytics SDK für Android Version 3 beschrieben.

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, 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 zu den Methoden onStart() und onStop() von jeder Ihrer Activities hinzu, wie im folgenden Beispiel gezeigt:

package com.example.app;

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;

/**
 * An example Activity using Google Analytics and EasyTracker.
 */
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(this).activityStart(this);  // Add this method.
  }

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

3. Datei „analytics.xml“ erstellen

Wenn Sie EasyTracker verwenden, werden globale Konfigurationseinstellungen mithilfe von Ressourcen verwaltet, die in XML definiert sind. Erstellen Sie im Verzeichnis res/values Ihres Projekts eine Datei mit dem Namen analytics.xml und fügen Sie die folgenden Ressourcen hinzu:

<?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 der Lint Checker-Funktion vor der Verwendung des Bindestrichs ('-') in Ihrer Tracking-ID gewarnt. Sie können diese Warnung durch Hinzufügen zusätzlicher Attribute zu Ihrem <resources>-Tag unterdrücken:

<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. Je nach den Anforderungen Ihrer Anwendung können Sie den Sendezeitraum ändern, um zu prüfen, ob Treffer korrekt gesendet werden. Wenn Sie beispielsweise Echtzeitdaten sehen möchten, können Sie einen niedrigen Wert wie 5 Sekunden festlegen.

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 mehr darüber, wie Sie Google Analytics-Funktionen in Ihrer App implementieren können:

  • 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.
  • 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.
  • Nutzertimings: Hier erfahren Sie, wie Sie das Nutzertiming in Ihrer App messen und z. B. die Ladezeiten und die Interaktion mit Medien messen.
  • Erweiterte Konfiguration: Weitere Informationen zu erweiterten Konfigurationsoptionen, einschließlich der Verwendung mehrerer Tracker.
  • Analytics.xml-Parameter: Siehe vollständige Liste der analytics.xml-Konfigurationsparameter.