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:
- Android Developer SDK (verfügbar für Windows, Mac OS X und Linux)
- Google Analytics SDK for Android Version 3 (wobei
libGoogleAnalyticsServices.jar
im/libs
-Verzeichnis und Build-Pfad Ihres Projekts enthalten ist) - Eine Android-App, mit der Sie die Google Analytics-Property implementieren können
- Mindestens eine Google Analytics-Property und eine App-Datenansicht (Profil), an die Daten von Ihrer App gesendet werden sollen
Erste Schritte
Für die ersten Schritte mit dem SDK sind drei Schritte erforderlich:
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.