Mit dem Google Analytics SDK für Android können Entwickler ganz einfach Daten zu Nutzerinteraktionen aus ihren Apps erheben. Dieses Dokument bietet einen Überblick über den Wert des SDK sowie eine Anleitung für die ersten Schritte zum Analysieren Ihrer App mithilfe einer einzelnen Property-ID und EasyTracker.
Einleitung
Mit dem Google Analytics SDK for Android können Entwickler ganz einfach Daten zum Nutzer-Engagement in ihren Apps erheben. Mit Google Analytics-Berichten können Entwickler dann Folgendes messen:
- Die Anzahl der aktiven Nutzer, die ihre Anwendungen verwenden.
- Von wo auf der Welt die Anwendung verwendet wird.
- Akzeptanz und Nutzung bestimmter Funktionen
- In-App-Käufe und -Transaktionen
- Anzahl und Art der App-Abstürze.
- Und viele andere nützliche Messwerte.
Darüber hinaus bietet Ihnen das Google Analytics SDK for Android Tools, mit denen Sie den Erfolg Ihrer mobilen Marketingkampagnen überwachen können. Sie erhalten einen umfassenden Überblick über die Leistung Ihrer Marketingkanäle – von Google Play-Installationen über In-App-Käufe und -Transaktionen.
Vorbereitung
Bevor Sie mit der Implementierung des SDK beginnen, benötigen Sie Folgendes:
- Android Developer SDK (verfügbar für Windows, Mac OS X und Linux)
- Google Analytics SDK for Android Version 2 (wobei
libGoogleAnalyticsV2.jar
im/libs
-Verzeichnis und Build-Pfad Ihres Projekts enthalten ist) - Eine Android-App, mit der Sie Version 2 des Google Analytics SDK für Android implementieren können
- Eine neue Google Analytics-App-Property und -Datenansicht (Profil).
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:
/** * 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. } }
Beachten Sie, dass für EasyTracker Context
erforderlich ist, bevor die Methoden aufgerufen werden können. Im obigen Beispiel führt diese Zeile wie folgt aus:
EasyTracker.getInstance.activityStart(this);
sorgt dafür, dass der Kontext entsteht. Wenn Sie jedoch EasyTracker-Aufrufe in anderen Klassen oder Methoden ausführen müssen, müssen Sie zuerst die setContext(Context ctx)
-Methode von EasyTracker 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 for Android werden Konfigurationsoptionen über eine XML-Ressourcendatei verwaltet, die in diesem Leitfaden analytics.xml
genannt wird. Sie müssen diese Datei im res/values
-Verzeichnis Ihres Projekts erstellen und Ihre Tracking-ID hinzufügen. Das folgende Beispiel zeigt, wie Sie eine Tracking-ID hinzufügen und die Activity
- und 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>
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.
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 erfahren Sie, wie Sie diese Funktionen zu Ihrer Implementierung hinzufügen:
- Erweiterte Konfiguration – Hier erfahren Sie mehr über erweiterte Konfigurationsoptionen, einschließlich der Verwendung mehrerer Tracker.
- Kampagnen messen – Hier erfahren Sie, wie Sie die Kampagnenanalyse implementieren und so herausfinden, welche Kanäle und Kampagnen zu App-Installationen führen.
- 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.
- Nutzertiming – Erfahren Sie, wie Sie das Nutzertiming in Ihrer App messen, um beispielsweise Ladezeiten oder Interaktionen mit Medien zu messen.
- Analytics.xml-Parameter: Hier finden Sie die vollständige Liste der
analytics.xml
-Konfigurationsparameter.