Google Analytics ist die Analyse-Engine von Firebase. Wenn Sie Analytics und Crashlytics zusammen in Ihrer App verwenden, erhalten Sie Funktionen, die Ihnen helfen, Probleme zu erzeugen und Absturzdaten detaillierter zu verfolgen, z. B. absturzfreie Benutzer, Breadcrumbs, die bestimmte Ereignisse vor einem Absturz verfolgen, und BigQuery, wo Sie können die wichtigsten Kennzahlen Ihrer App visualisieren.
In dieser Anleitung wird beschrieben, wie Sie Analytics zu einer App hinzufügen, in der Crashlytics eingerichtet ist (falls Sie dies noch nicht getan haben, fügen Sie Crashlytics zu Ihrer App hinzu ).
Schritt 1: Fügen Sie eine Firebase-Konfigurationsdatei hinzu
Fügen Sie die Firebase Android-Konfigurationsdatei zu Ihrer App hinzu:
Öffnen Sie Ihre Projekteinstellungen. Wählen Sie auf der Karte „Ihre Apps“ den Paketnamen der App aus, für die Sie eine Konfigurationsdatei benötigen.
Klicken Sie auf „Google-services.json herunterladen“ , um Ihre Firebase-Android-Konfigurationsdatei (
google-services.json
) zu erhalten.- Sie können Ihre Firebase Android-Konfigurationsdatei jederzeit erneut herunterladen.
- Stellen Sie sicher, dass der Konfigurationsdatei keine zusätzlichen Zeichen wie
(2)
angehängt sind.
Verschieben Sie Ihre Konfigurationsdatei in das Modulverzeichnis (App-Ebene) Ihrer App.
Um Firebase-Produkte in Ihrer App zu aktivieren, fügen Sie das Google-Services-Plugin zu Ihren Gradle-Dateien hinzu.
Fügen Sie in Ihrer Gradle-Datei auf Stammebene (Projektebene) (
<project>/build.gradle.kts
oder<project>/build.gradle
) Regeln hinzu, um das Gradle-Plugin für Google-Dienste einzuschließen. Überprüfen Sie auch, ob Sie über das Maven-Repository von Google verfügen.Kotlin
plugins { id("com.android.application") version "7.3.0" apply false // ... // Add the dependency for the Google services Gradle plugin id("com.google.gms.google-services") version "4.4.0" apply false }
Groovy
plugins { id 'com.android.application' version '7.3.0' apply false // ... // Add the dependency for the Google services Gradle plugin id 'com.google.gms.google-services' version '4.4.0' apply false }
Wenden Sie in der Gradle-Datei Ihres Moduls (App-Ebene) (normalerweise
<project>/<app-module>/build.gradle.kts
oder<project>/<app-module>/build.gradle
) das Gradle-Plugin für Google-Dienste an.Kotlin
plugins { id("com.android.application") // Add the Google services Gradle plugin id("com.google.gms.google-services") // ... }
Groovy
plugins { id 'com.android.application' // Add the Google services Gradle plugin id 'com.google.gms.google-services' // ... }
Schritt 2: Fügen Sie das Analytics SDK zu Ihrer App hinzu
Fügen Sie in Ihrer Modul-Gradle-Datei (auf App-Ebene) (normalerweise
<project>/<app-module>/build.gradle.kts
oder<project>/<app-module>/build.gradle
) die Abhängigkeit für die Analytics-Bibliothek hinzu für Android. Wir empfehlen die Verwendung der Firebase Android BoM zur Steuerung der Bibliotheksversionierung.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:32.7.0")) // 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' }
Durch die Verwendung der Firebase Android BoM verwendet Ihre App immer kompatible Versionen der Firebase Android-Bibliotheken.
Suchen Sie nach einem Kotlin-spezifischen Bibliotheksmodul? Ab Oktober 2023 (Firebase BoM 32.5.0) können sich sowohl Kotlin- als auch Java-Entwickler auf das Hauptbibliotheksmodul verlassen (Einzelheiten finden Sie in den FAQ zu dieser Initiative ).(Alternative) Fügen Sie Firebase-Bibliotheksabhängigkeiten hinzu , 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: Wenn Sie mehrere Firebase-Bibliotheken in Ihrer App verwenden, empfehlen wir dringend, die BoM zum Verwalten der Bibliotheksversionen zu verwenden, um sicherzustellen, 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:21.5.0' }
Deklarieren Sie das
com.google.firebase.analytics.FirebaseAnalytics
-Objekt oben in Ihrer Aktivität:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
Initialisieren Sie es in der
onCreate()
-Methode:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Nächste Schritte
- Verwenden Sie DebugView, um Ihre Ereignisse zu überprüfen.
- Erkunden Sie Ihre Daten in der Firebase-Konsole.
- Entdecken Sie die Leitfäden zu Ereignissen und Benutzereigenschaften.
- Erfahren Sie, wie Sie Ihre Daten nach BigQuery exportieren.