This guide shows how to add Analytics to your Android app to measure user activity to named screens. If you don't have an application yet and just want to see how Analytics works, take a look at our sample application.
Set up your project
Update your project's
AndroidManifest.xml file to include the
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.analytics"> <uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <application android:name="AnalyticsApplication"> ... </application> </manifest>
The Google Services plugin for Gradle parses
configuration information from the
google-services.json file. Add the plugin to your
project by updating your top-level
build.gradle and your app-level
build.gradle files as follows:
- Add the dependency to your project-level
- Add the plugin to the bottom of your app-level
apply plugin: 'com.google.gms.google-services'
Now, you need to add a dependency for Google Play Services. Inside your app's
Get a configuration file
Click the button below to get a configuration file to add to your project.
The configuration file provides service-specific information for your app. To get it, you must select an existing project for your app or create a new one. You'll also need to provide a package name for your app.Get a Configuration File
Add the configuration file to your project
google-services.json file you just downloaded into the
mobile/ directory of your Android Studio project. Open the Android Studio
$ mv path-to-download/google-services.json app/
$ move path-to-download/google-services.json app/
Add screen tracking
Here you’ll send a named screen view to Analytics whenever the user opens or changes screens on your app. Your code should do the following:
- Provide the shared tracker via an Application subclass.
- Override the callback method for the foreground activity.
- Provide a name for the screen and execute tracking.
You should subclass
Application and provide a helper method
that returns your application's tracker.
Activity or fragment
Open the Activity that you'd like to track.
You could also track a
Fragment, but ensure that it
correctly represents a screen view.
onCreate method of the
Fragment you want to track to obtain the shared
Override the appropriate method, such as
onResume for an
onPageSelected for a
ViewPager to log when the screen changes.
Add tracking code to every
Fragment that represents a screen.
Be sure to set a name inside every
Fragment if you want to
differentiate between screen views for your app in Analytics. All activity
recorded on the shared tracker sends the most recent screen name until replaced
or cleared (set to
Send an event
To send an event, set the screen field values on the tracker, then send the hit.
The following example uses the
HitBuilders.EventBuilder to send an
- Read the Mobile App Implementation Guide to learn how to use Google Analytics to measure user interactions and answer questions about app usage.
- Review additional configuration options such as sampling, testing and debugging, opt-out settings, etc.
- If your app needs to collect advertising identifiers, enable advertising features for the app.