Erste Schritte mit Google Analytics

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:

  • Veranstaltungen: Was in Ihrer Anwendung geschieht, wie Benutzeraktionen, Systemereignisse oder Fehler.
  • Benutzereigenschaften: Attribute definieren Sie Segmente Ihrer Nutzerbasis zu beschreiben, wie bevorzugte Sprache oder geographische Lage.

Analytics automatisch protokolliert einige Ereignisse und Benutzereigenschaften ; Sie müssen keinen Code hinzufügen, um sie zu aktivieren.

Bevor Sie beginnen

Wenn Sie nicht bereits haben, fügen Sie Firebase zu dem Android - Projekt und stellen Sie sicher , dass Google Analytics in Ihrem Projekt Firebase aktiviert ist:

  • Wenn Sie ein neues Firebase-Projekt erstellen, aktivieren Sie Google Analytics während des Workflows zur Projekterstellung.

  • Wenn Sie ein vorhandenes Projekt Firebase verwenden , die nicht von Google Analytics nicht aktiviert ist , gehen Sie auf die Integrations Registerkarte Ihrer > Projekteinstellungen 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

  1. Mit Hilfe der Firebase Android BoM , erklärt die Abhängigkeit für die Analytics Android - Bibliothek in Ihrem Modul (app-Ebene) Gradle Datei ( in der Regel app/build.gradle ).

    Java

    dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:29.0.3')

    // 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 des Firebase Android BoM werden, Ihre App immer kompatible Versionen der Firebase Android - Bibliotheken verwenden.

    (Alternative) Deklarieren Firebase Bibliothek Abhängigkeiten , ohne die BoM mit

    Wenn Sie die Firebase-Stückliste nicht verwenden möchten, müssen Sie jede Firebase-Bibliotheksversion in ihrer Abhängigkeitszeile angeben.

    Beachten Sie, dass , wenn Sie mehrere Firebase Bibliotheken in Ihrer Anwendung verwenden wir mit der BoM empfehlen Bibliothek Versionen zu verwalten, die sicherstellt , 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:20.0.2'
}

    Kotlin+KTX

    dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:29.0.3')

    // 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 des Firebase Android BoM werden, Ihre App immer kompatible Versionen der Firebase Android - Bibliotheken verwenden.

    (Alternative) Deklarieren Firebase Bibliothek Abhängigkeiten , ohne die BoM mit

    Wenn Sie die Firebase-Stückliste nicht verwenden möchten, müssen Sie jede Firebase-Bibliotheksversion in ihrer Abhängigkeitszeile angeben.

    Beachten Sie, dass , wenn Sie mehrere Firebase Bibliotheken in Ihrer Anwendung verwenden wir mit der BoM empfehlen Bibliothek Versionen zu verwalten, die sicherstellt , 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:20.0.2'
}

  2. Deklarieren Sie das com.google.firebase.analytics.FirebaseAnalytics Objekt an der Spitze Ihrer Aktivität:

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

  3. Initialisieren im onCreate() Methode:

    Java

    // Obtain the FirebaseAnalytics instance.
mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
    MainActivity.java

    Kotlin+KTX

    // Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analytics
    MainActivity.kt

Starten Sie die Protokollierung von Ereignissen

Nachdem Sie eine erstellt haben FirebaseAnalytics Instanz, können Sie beginnen , Ereignisse zu protokollieren mit dem logEvent() Methode.

Bestimmte Ereignisse werden für alle Anwendungen 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 zeigt die Anmeldung ein vordefiniertes Ereignis, um weitere Informationen über die Protokollierung von Ereignissen finden Sie Protokollereignisse .

Der folgende Code protokolliert eine SELECT_CONTENT Ereignis , wenn ein Benutzer klickt auf ein bestimmtes Element in Ihrer Anwendung.

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);
MainActivity.java

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")
}
MainActivity.kt

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 mit einer Reihe von ausführlichen Protokollierung aktivieren adb Befehle ein :

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