Google Analytics SDK for Android Version 3 (alte Version) – Erste Schritte

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

Vorbereitung

Folgende Voraussetzungen müssen erfüllt sein, bevor Sie das SDK implementieren:

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:

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 in XML definierten Ressourcen verwaltet. Erstellen Sie eine Datei mit dem Namen analytics.xml im Verzeichnis res/values Ihres Projekts 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>

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. 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, sollten Sie einen niedrigen Wert wie 5s festlegen.

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 finden Sie weitere Informationen zur Implementierung von Google Analytics-Funktionen in Ihrer App:

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