In dieser Kurzanleitung erfahren Sie, wie Sie Google Analytics zu Ihrer App hinzufügen und damit beginnen, Ereignisse zu erfassen.
Google Analytics erfasst Nutzungs- und Verhaltensdaten für Ihre App. Das SDK protokolliert zwei Hauptarten von Informationen:
- Ereignisse:Hierbei geht es darum, was in Ihrer App geschieht, also z. B. um Nutzeraktionen, Systemereignisse oder Fehler.
- Nutzereigenschaften:Attribute, mit denen Sie Nutzersegmente wie Spracheinstellungen oder geografische Standorte beschreiben.
In Analytics werden einige Ereignisse und Nutzereigenschaften automatisch protokolliert. Sie müssen dazu keinen Code hinzufügen.
Hinweis
Fügen Sie Ihrem Android-Projekt Firebase hinzu und prüfen Sie, ob Google Analytics in Ihrem Firebase-Projekt aktiviert ist:
Wenn Sie ein neues Firebase-Projekt erstellen, aktivieren Sie Google Analytics während des Workflows für die Projekterstellung.
Wenn Sie ein vorhandenes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, rufen Sie den Tab Integrationen unter
auf, um > ProjekteinstellungenGoogle Analytics zu aktivieren.
Wenn Sie Google Analytics in Ihrem Projekt aktivieren, werden Ihre Firebase-Apps mit Google Analytics-Datenstreams verknüpft.
Fügen Sie Ihrer App das Analytics SDK hinzu.
Fügen Sie in der Gradle-Datei des Moduls (auf Anwendungsebene) (in der Regel
<project>/<app-module>/build.gradle.kts
oder<project>/<app-module>/build.gradle
) die Abhängigkeit für die Analytics-Bibliothek für Android hinzu. Wir empfehlen, die Firebase Android BoM zu verwenden, um die Versionierung der Bibliothek zu steuern.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.5.1")) // Add the dependency for the Analytics library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-analytics") }
Wenn Sie Firebase Android BoM verwenden, verwendet Ihre App immer kompatible Versionen von Firebase Android-Bibliotheken.
Alternative: Firebase-Bibliotheksabhängigkeiten ohne BoM hinzufügen
Wenn Sie die Firebase BoM nicht verwenden, müssen Sie jede Firebase-Bibliotheksversion in der entsprechenden Abhängigkeitszeile angeben.
Wenn Sie mehrere Firebase-Bibliotheken in Ihrer App verwenden, empfehlen wir Ihnen dringend, die Bibliotheksversionen mithilfe der BoM zu verwalten. So wird sichergestellt, dass alle Versionen kompatibel sind.
dependencies { // Add the dependency for the Analytics library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-analytics:22.1.2") }
Deklariere das Objekt
com.google.firebase.analytics.FirebaseAnalytics
oben in deiner Aktivität:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
Initialisieren Sie sie in der
onCreate()
-Methode:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Ereignisse protokollieren
Nachdem Sie eine FirebaseAnalytics
-Instanz erstellt haben, können Sie mit der Methode logEvent()
Ereignisse protokollieren.
Bestimmte Ereignisse werden für alle Apps empfohlen, andere für bestimmte Unternehmenstypen oder Branchen. Sie sollten vorgeschlagene Ereignisse zusammen mit den zugehörigen Parametern senden, damit Ihre Berichte so detailliert wie möglich sind und Sie von künftigen Funktionen und Integrationen profitieren, sobald sie verfügbar sind. In diesem Abschnitt wird gezeigt, wie ein vordefiniertes Ereignis protokolliert wird. Weitere Informationen zum Protokollieren von Ereignissen finden Sie unter Ereignisse protokollieren.
Mit dem folgenden Code wird ein SELECT_CONTENT
-Ereignis protokolliert, wenn ein Nutzer auf ein bestimmtes Element in Ihrer App klickt.
Kotlin+KTX
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
Java
Bundle bundle = new Bundle(); bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id); bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name); bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image"); mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
Sie können die ausführliche Protokollierung aktivieren, um die Protokollierung von Ereignissen durch das SDK zu überwachen und so zu prüfen, ob Ereignisse ordnungsgemäß protokolliert werden. Dazu gehören sowohl automatisch als auch manuell aufgezeichnete Ereignisse.
Sie können das ausführliche Logging mit einer Reihe von adb
-Befehlen aktivieren:
adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC
Mit diesem Befehl werden Ihre Ereignisse im Android Studio-Logcat angezeigt. So können Sie sofort prüfen, ob Ereignisse gesendet werden.
Nächste Schritte
- Informationen zu den einzelnen Analytics-Berichten
- Prüfen Sie Ihre Ereignisse mit DebugView.
- Sehen Sie sich Ihre Daten in der Firebase-Konsole an.
- Sehen Sie sich die Anleitungen zu Ereignissen und Nutzereigenschaften an.
- Informationen zum Exportieren von Daten nach BigQuery