This developer guide describes how to measure events in your app using the Google Analytics SDK for Android v3.
Overview
Events are a useful way to collect data about a user's interaction with interactive components of your app, like button presses or the use of a particular item in a game.
An event consists of four fields that you can use to describe a user's interaction with your app content:
Field Name | Tracker Field | Type | Required | Description |
---|---|---|---|---|
Category | Fields.EVENT_CATEGORY
|
String
|
Yes | The event category |
Action | Fields.EVENT_ACTION
|
String
|
Yes | The event action |
Label | Fields.EVENT_LABEL
|
String
|
No | The event label |
Value | Fields.EVENT_VALUE
|
Long
|
No | The event value |
Implementation
To send an event to Google Analytics, use
MapBuilder.createEvent()
and send the hit, as in this example:
@Override public void onClick(View v) { // May return null if a EasyTracker has not yet been initialized with a // property ID. EasyTracker easyTracker = EasyTracker.getInstance(this); // MapBuilder.createEvent().build() returns a Map of event fields and values // that are set and sent with the hit. easyTracker.send(MapBuilder .createEvent("ui_action", // Event category (required) "button_press", // Event action (required) "play_button", // Event label null) // Event value .build() ); }