In diesem Dokument werden die ersten Schritte mit dem Google Analytics SDK for Android Version 3 beschrieben.
Vorbereitung
Sie benötigen Folgendes, bevor Sie das SDK implementieren:
- Android-Entwickler-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 der App gesendet werden sollen
Erste Schritte
Die ersten Schritte mit dem SDK sind drei Schritte:
Wenn Sie diese Schritte ausgeführt haben, können Sie mit Google Analytics Folgendes messen:
- App-Installationen
- Aktive Nutzer und demografische Merkmale
- Bildschirme und Nutzerinteraktionen
- 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()
der einzelnen Activities
-Objekte 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>
Die Lint-Prüfung warnt Sie möglicherweise vor der Verwendung des Strichs (-) in Ihrer Tracking-ID. Sie können diese Warnung unterdrücken, indem Sie Ihrem <resources>
-Tag zusätzliche Attribute hinzufügen:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
Eine vollständige Liste der Parameter, die Sie zur Konfiguration Ihrer Implementierung verwenden können, finden Sie in der Referenz zu den analytics.xml-Parametern. Abhängig von den Anforderungen Ihrer Anwendung können Sie den Absendezeitraum ändern, um zu prüfen, ob Treffer ordnungsgemäß gesendet werden. Wenn Sie beispielsweise Echtzeitdaten sehen möchten, sollten Sie diesen auf einen niedrigen Wert wie 5s setzen.
Glückwunsch! Ihre App ist nun so eingerichtet, dass Daten an Google Analytics gesendet werden.
Nächste Schritte
Mit Google Analytics haben Sie noch viel mehr Möglichkeiten. Sie können beispielsweise 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.
- In-App-Zahlungen messen – Hier erfahren Sie, wie Sie In-App-Zahlungen und -Transaktionen messen.
- Kampagnen analysieren – Hier erfährst du, wie du die Analyse von Kampagnen implementierst, um herauszufinden, welche Kanäle und Kampagnen zu App-Installationen führen.
- Nutzertiming – Erfahren Sie, wie Sie Nutzertimings in Ihrer App messen, um beispielsweise Ladezeiten und Interaktionen mit Medien zu messen.
- Erweiterte Konfiguration – Erfahre mehr über erweiterte Konfigurationsoptionen, einschließlich der Verwendung mehrerer Tracker.
-
Analytics.xml-Parameter – Sehen Sie sich die vollständige Liste der
analytics.xml
-Konfigurationsparameter an.