Google is committed to advancing racial equity for Black communities. See how.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Beginnen Sie 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:

  • Ereignisse: Was passiert in Ihrer App, z. B. Benutzeraktionen, Systemereignisse oder Fehler.
  • Benutzereigenschaften: Attribute, die Sie definieren, um Segmente Ihrer Benutzerbasis zu beschreiben, z. B. Spracheinstellung oder geografischer Standort.

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

Bevor Sie beginnen

Wenn Sie dies noch nicht getan haben, 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 haben, für das Google Analytics nicht aktiviert ist, können Sie Google Analytics auf der Registerkarte Integrationen unter Ihren > Projekteinstellungen aktivieren.

Wenn Sie Google Analytics in Ihrem Projekt aktivieren, werden Ihre Firebase-Apps mit Google Analytics-Datenströmen verknüpft.

Fügen Sie das Analytics SDK zu Ihrer App hinzu

  1. Fügen Sie die Abhängigkeit für die Google Analytics-Android-Bibliothek zu Ihrer Gradle-Datei (normalerweise app/build.gradle ) Ihres Moduls (App-Ebene) app/build.gradle :

    Java

    implementation 'com.google.firebase:firebase-analytics:17.5.0'
    

    Kotlin + KTX

    implementation 'com.google.firebase:firebase-analytics-ktx:17.5.0'
    
  2. 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
  3. Initialisieren Sie es mit der onCreate() -Methode:

    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 logEvent() -Methode beginnen, Ereignisse zu protokollieren.

Bestimmte Ereignisse werden für alle Apps empfohlen . andere werden für bestimmte Geschäftstypen oder Branchen empfohlen. Sie sollten vorgeschlagene Ereignisse zusammen mit den vorgeschriebenen Parametern senden, um maximale verfügbare Details in Ihren Berichten sicherzustellen und von zukünftigen Funktionen und Integrationen zu profitieren, sobald diese verfügbar sind. In diesem Abschnitt wird die Protokollierung eines vordefinierten Ereignisses veranschaulicht . Weitere Informationen zum Protokollieren von Ereignissen finden Sie unter Protokollieren von Ereignissen .

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 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

Mit diesem Befehl werden Ihre Ereignisse im Android Studio-Protokoll angezeigt, sodass Sie sofort überprüfen können, ob Ereignisse gesendet werden.

Nächste Schritte