Analytics are key to measuring the success of your project or application and are a great way of identifying your users trends and demographics. Have you released an app and wondered who your users actually are? Well with analytics you could find out where your users are situated, what ages they are etc. The leader in this field is Google Analytics - this can be embedded into your mobile application, website and even your blog.
After a few frustrating attempts at integrating Google Analytics into an existing app I thought I should post a guide on how to do this.
1. Download the Google play services library and add it to your project.
You can do this by right clicking on the project you want to add analytics to in eclipse, choosing properties and then the Android tab. In the Library section, select Add and choose google-play-services_lib and select Apply.
2. Add the required permissions to AndroidManifest.xml.
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
These are required so your app can send the analytics content.
3. Add Metadata to your application. This should be added under the application tab.
<meta-data
android:name="com.google.android.gms.version"
android:value="@integer/google_play_services_version"/>
<meta-data
android:name="com.google.android.gms.analytics.globalConfigResource"
android:resource="@xml/global_tracker"/>
We'll add global_tracker later.
4. Create the analytics application helper class.
importcom.google.android.gms.analytics.Logger;
importcom.google.android.gms.analytics.Tracker;
importcom.google.android.gms.analytics.GoogleAnalytics;
importandroid.app.Application;
import java.util.HashMap;
// The following line should be changed to include the correct property id.
private static final String PROPERTY_ID = "YOUR_ANALYTICS_ID";
public static int GENERAL_TRACKER = 0;
public enum TrackerName {
APP_TRACKER, // Tracker used only in this app.
GLOBAL_TRACKER, // Tracker used by all the apps from a company. eg: roll-up tracking.
ECOMMERCE_TRACKER, // Tracker used by all ecommerce transactions from a company.
}
HashMap mTrackers = newHashMap();
public YourApplication () {
super();
}
synchronized Tracker getTracker(TrackerName trackerId) {
if (!mTrackers.containsKey(trackerId)) {
GoogleAnalytics analytics = GoogleAnalytics.getInstance(this);
analytics.getLogger().setLogLevel(Logger.LogLevel.VERBOSE);
Tracker t = (trackerId == TrackerName.APP_TRACKER) ? analytics.newTracker(PROPERTY_ID)
: (trackerId == TrackerName.GLOBAL_TRACKER) ? analytics.newTracker(
R.xml.global_tracker)
: analytics.newTracker(R.xml.ecommerce_tracker);
t.enableAdvertisingIdCollection(true);
mTrackers.put(trackerId, t);
}
return mTrackers.get(trackerId);
}
}
5. Update AndroidManfiest.xml to include your application, e.g.:
<application
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme"
6. Create the tracker xml files.
Under the res section in your project create an xml folder. Create two xml files in this named ecommerce_tracker.xml and one called global_tracker.xml. Contents below - remember to substitute in your analytics tracking ids. These can be created following instructions here.
ecommerce_tracker.xml
<xml version="1.0"encoding="utf-8"?>
<resources>
<integer name="ga_sessionTimeout">60<integer>
<string name="ga_trackingId">**INSERT TRACKING CODE HERE**<string>
<resources>
global_tracker.xml
<xml version="1.0"encoding="utf-8"?>
<resources>
<integer name="ga_sessionTimeout">300<integer>
<bool name="ga_autoActivityTracking">true<bool>
<screenName name="**Path to Your Application e.g. com.company.YourApplication**">**YOUR NAME**</screenName>
<string name="ga_trackingId">** INSERT TRACKING CODE HERE ** string>
<resources>
Note the trackers are described as follows by Google:
APP_TRACKER, // Tracker used only in this app.
GLOBAL_TRACKER, // Tracker used by all the apps from a company. eg: roll-up tracking.
ECOMMERCE_TRACKER, // Tracker used by all ecommerce transactions from a company.
GLOBAL_TRACKER, // Tracker used by all the apps from a company. eg: roll-up tracking.
ECOMMERCE_TRACKER, // Tracker used by all ecommerce transactions from a company.
7. Send the screens
Add the following code to your onCreate method in your activity. This will send the screen views to Google Analytics.
// Get tracker.
Tracker t = ((YourApplication) getApplication()).getTracker(TrackerName.APP_TRACKER);
// Enable Display Features so you can see demographics in Google Analytics
t.enableAdvertisingIdCollection(true);
// Set screen name.
t.setScreenName("** YOUR SCREEN NAME **");
// Send a screen view.
t.send(newHitBuilders.AppViewBuilder().build());
8. Update onStart and onStop
Add the following:
@Override
protected void onStart() {
super.onStart();
GoogleAnalytics.getInstance(this).reportActivityStart(this);
}
@Override
protected void onStop() {
super.onStop();
GoogleAnalytics.getInstance(this).reportActivityStop(this);
}
9. View results in Google Analytics.
You are now done and once users start using your app you should be able to see real time updates in Google Analytics. Note that the analytics aren't exactly real time - but it's good enough!
Let me know if this helps you out or if you have any further questions and I'll try and help where I can.
EDIT: 11/01/2015 - updated section 7 to allow you to display demographics in Google Analytics.
EDIT: 11/01/2015 - updated section 7 to allow you to display demographics in Google Analytics.