Hide

Event Tracking - Android SDK

This developer guide describes how to measure events in your app using the Google Analytics SDK for Android v3.

  1. Overview
  2. Implementation

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()
  );
}