Dieser Schnellstart zeigt Ihnen, wie Sie Google Analytics zu Ihrer App hinzufügen und mit der Protokollierung von Ereignissen beginnen.
Google Analytics sammelt Nutzungs- und Verhaltensdaten für Ihre App. Das SDK protokolliert zwei Haupttypen von Informationen:
- Ereignisse: Was in Ihrer App passiert, z. B. Benutzeraktionen, Systemereignisse oder Fehler.
- Benutzereigenschaften: Attribute, die Sie definieren, um Segmente Ihrer Benutzerbasis zu beschreiben, wie z. B. Sprachpräferenzen oder geografischer Standort.
Analytics protokolliert automatisch einige Ereignisse und Benutzereigenschaften ; Sie müssen keinen Code hinzufügen, um sie zu aktivieren.
Bevor Sie beginnen
Falls noch nicht geschehen, fügen Sie Firebase zu Ihrem Android-Projekt hinzu und stellen Sie sicher, dass Google Analytics in Ihrem Firebase-Projekt aktiviert ist:
Wenn Sie ein neues Firebase-Projekt erstellen, aktivieren Sie Google Analytics während des Workflows zur Projekterstellung.
Wenn Sie ein vorhandenes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, gehen Sie zur Registerkarte Integrationen Ihrer > Projekteinstellungen , um es zu aktivieren.
Wenn Sie Google Analytics in Ihrem Projekt aktivieren, werden Ihre Firebase-Apps mit Google Analytics-Datenströmen verknüpft.
Fügen Sie Ihrer App das Analytics SDK hinzu
Deklarieren Sie mithilfe der Firebase-Android-BoM die Abhängigkeit für die Analytics-Android-Bibliothek in der Gradle-Datei Ihres Moduls (auf App-Ebene) (normalerweise
app/build.gradle
).Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.1.0') // Declare 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' }
Durch die Verwendung der Firebase Android BoM verwendet Ihre App immer kompatible Versionen der Firebase Android-Bibliotheken.
(Alternative) Deklarieren Sie Abhängigkeiten der Firebase-Bibliothek, ohne die Stückliste zu verwenden
Wenn Sie die Firebase-Stückliste nicht verwenden möchten, müssen Sie jede Firebase-Bibliotheksversion in ihrer Abhängigkeitszeile angeben.
Beachten Sie, dass wir bei Verwendung mehrerer Firebase-Bibliotheken in Ihrer App dringend empfehlen, die BoM zum Verwalten von Bibliotheksversionen zu verwenden, um sicherzustellen, dass alle Versionen kompatibel sind.
dependencies { // Declare 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:21.0.0' }
Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.1.0') // Declare 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-ktx' }
Durch die Verwendung der Firebase Android BoM verwendet Ihre App immer kompatible Versionen der Firebase Android-Bibliotheken.
(Alternative) Deklarieren Sie Abhängigkeiten der Firebase-Bibliothek, ohne die Stückliste zu verwenden
Wenn Sie die Firebase-Stückliste nicht verwenden möchten, müssen Sie jede Firebase-Bibliotheksversion in ihrer Abhängigkeitszeile angeben.
Beachten Sie, dass wir bei Verwendung mehrerer Firebase-Bibliotheken in Ihrer App dringend empfehlen, die BoM zum Verwalten von Bibliotheksversionen zu verwenden, um sicherzustellen, dass alle Versionen kompatibel sind.
dependencies { // Declare 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-ktx:21.0.0' }
Deklarieren Sie das Objekt
com.google.firebase.analytics.FirebaseAnalytics
oben in Ihrer Aktivität:Java
private FirebaseAnalytics mFirebaseAnalytics;
Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Initialisieren Sie es in der Methode
onCreate()
:Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Starten Sie die Protokollierung von Ereignissen
Nachdem Sie eine FirebaseAnalytics
-Instanz erstellt haben, können Sie mit der Protokollierung von Ereignissen mit der Methode logEvent()
beginnen.
Bestimmte Ereignisse werden für alle Apps empfohlen ; andere werden für bestimmte Geschäftstypen oder Branchen empfohlen. Sie sollten vorgeschlagene Ereignisse zusammen mit ihren vorgeschriebenen Parametern senden, um sicherzustellen, dass möglichst viele Details in Ihren Berichten verfügbar sind, und um von zukünftigen Funktionen und Integrationen zu profitieren, sobald sie verfügbar sind. Dieser Abschnitt demonstriert das Protokollieren eines vordefinierten Ereignisses. Weitere Informationen zum Protokollieren von Ereignissen finden Sie unter Protokollereignisse .
Der folgende Code protokolliert ein SELECT_CONTENT
Ereignis, wenn ein Benutzer auf ein bestimmtes Element in Ihrer App klickt.
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);
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") }
Sie können die ausführliche Protokollierung aktivieren, um die Protokollierung von Ereignissen durch das SDK zu überwachen und so zu überprüfen, ob Ereignisse ordnungsgemäß protokolliert werden. Dies umfasst sowohl automatisch als auch manuell protokollierte Ereignisse.
Sie können die ausführliche Protokollierung 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
Dieser Befehl zeigt Ihre Ereignisse im Logcat von Android Studio an, sodass Sie sofort überprüfen können, ob Ereignisse gesendet werden.
Nächste Schritte
- Verwenden Sie die DebugView , um Ihre Ereignisse zu überprüfen.
- Untersuchen Sie Ihre Daten in der Firebase-Konsole.
- Erkunden Sie die Leitfäden zu Ereignissen und Benutzereigenschaften.
- Erfahren Sie, wie Sie Ihre Daten nach BigQuery exportieren.