Google Analytics SDK for Android: Migrating from v1.x to v2.x

This migration guide describes what's new in version 2 of the SDK, and
provides developers with tips to migrate from a v1.x implementation.
Developers who do not need to migrate from a v1.x implementation can
Get Started with Version 2 now.

Introduction

Google Analytics recently released the updated Google Analytics
SDK for Android
version 2. Version 2 of the SDK contains
support for new features and a new reporting interface designed specifically for
app developers.

We recommend that all existing Google Analytics developers
migrate to version 2 of the Google Analytics SDK for
Android
to take advantage of the new features
and reports.

What's New in Version 2

The Google Analytics SDK for Android
version 2 introduces a new reporting
experience designed for app developers, powerful new dimensions and metrics,
and much more. Here's a look at what developers get with version 2:

More powerful reports for app developers

The standard reports have been redesigned for app
developers, adding new reports like Engagement Flow and Google Play Sources
to help developers gain new insight into user acqusition and experience.
Read our
Account Configuration Best Practices to learn more about how best to
configure your property for version 2.

New app dimensions and metrics

New app-specific dimensions and metrics have been introduced with
version 2 of the SDK, including Screen Name and Screen Views, App Name,
App version, and many more.

Measure crashes and exceptions

The Google Analytics SDK for Android
introduces exception measurement and
the exception hit type. Using exception measurement, you can measure the
number and type of crashes and non-fatal exceptions. To learn how to
implement exception measurement, see the
Exceptions Developer Guide.

If you have advanced data collections needs, such as using multiple property
IDs in a single implementation, read the Advanced Configuration Guide
to learn more about using advanced features of v2.x of the SDK.