Get started with Google Analytics

This quickstart shows you how to add Google Analytics to your app and begin logging events.

Google Analytics collects usage and behavior data for your app. The SDK logs two primary types of information:

• Events:What is happening in your app, such as user actions, system events, or errors.
• User properties:Attributes you define to describe segments of your user base, such as language preference or geographic location.

Analytics automatically logs some events and user properties ; you don't need to add any code to enable them.

Before you begin

If you haven't already, add Firebase to your Android project and make sure that Google Analytics is enabled in your Firebase project:

• If you're creating a new Firebase project, enable Google Analytics during the project creation workflow.

• If you're using an existing Firebase project that doesn't have Google Analytics enabled, go to the Integrations tab of your settings > Project settings to enable it.

When you enable Google Analytics in your project, your Firebase apps are linked to Google Analytics data streams.

Add the Analytics SDK to your app

1. In your module (app-level) Gradle file (usually <project>/<app-module>/build.gradle.kts or <project>/<app-module>/build.gradle ), add the dependency for the Analytics library for Android. We recommend using the Firebase Android BoM to control library versioning.

    dependencies 
     
    { 
     
     // Import the BoM 
   for the Firebase platform 
     
    implementation 
    ( 
    platform 
    ( 
    "com.google.firebase:firebase-bom:34.4.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" 
    ) 
    } 
   

   By using the Firebase Android BoM , your app will always use compatible versions of Firebase Android libraries.

   (Alternative)   Add Firebase library dependencies  without  using the BoM

   If you choose not to use the Firebase BoM , you must specify each Firebase library version in its dependency line.

   Note that if you use multiple Firebase libraries in your app, we strongly recommend using the BoM to manage library versions, which ensures that all versions are compatible.

    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:23.0.0" 
    ) 
    } 
   

2. Declare the com.google.firebase.analytics.FirebaseAnalytics object at the top of your activity:

   Kotlin

    private 
     
    lateinit 
     
    var 
     
    firebaseAnalytics 
    : 
     
    FirebaseAnalytics 
    MainActivity 
    
    
    . 
    kt