The Firebase SDK 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 userbase, 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.
Prerequisites
- Install the Firebase SDK.
- Add your app to your Firebase project in the Firebase console.
- Android Studio 1.5 or later.
Add Analytics to your app
Add the dependency for Mobile app reporting in Google Analytics to your app-level build.gradle
file:
compile 'com.google.firebase:firebase-core:10.2.1'
Declare the com.google.firebase.analytics.FirebaseAnalytics
object at the top of your activity:
private FirebaseAnalytics mFirebaseAnalytics;
Then initialize it in the onCreate()
method:
// Obtain the FirebaseAnalytics instance.
mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Log events
Once you have created a FirebaseAnalytics
instance, you can
use it to log either predefined or custom events with the
logEvent()
method. You can explore the predefined
events and parameters in the FirebaseAnalytics.Event
and
FirebaseAnalytics.Param
reference documentation.
The following code logs a SELECT_CONTENT
Event
when a user clicks on a specific element in your app.
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);
Confirm Events
You can enable verbose logging to monitor logging of events by the SDK to help verify that events are being logged properly. This includes both automatically and manually logged events.
You can enable verbose logging with a series of adb commands:
adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC
This command displays your events in the Android Studio logcat, helping you immediately verify that events are being sent.
Next Steps
- See your data refresh periodically in the Firebase console.
- Explore the guides on logging events and setting user properties.