本迁移指南介绍了 SDK 版本 2 的新变化，并为开发者提供从 v1.x 实现进行迁移的提示。不需要从 v1.x 实现迁移的开发者可以立即开始使用版本 2。
简介
Google Analytics（分析）最近发布了经过更新的 Android 版 Google Analytics（分析）SDK 第 2 版。SDK 版本 2 支持新功能，并引入了专为应用开发者设计的新报告界面。
我们建议所有现有的 Google Analytics（分析）开发者迁移到 Android 版 Google Analytics（分析）SDK 第 2 版，以便充分利用新的功能和报告。
版本 2 中的新功能
Android 版 Google Analytics（分析）SDK 第 2 版引入了专为应用开发者设计的全新报告体验、强大的全新维度和指标，等等。开发者使用版本 2 可获得如下结果：
- 为应用开发者提供的更强大的报告
- 我们为应用开发者重新设计了标准报告，添加了“互动流”和“Google Play 来源”等新报告，以帮助开发者更深入地了解用户获取和体验。 请阅读我们的 账号配置最佳做法，详细了解如何针对版本 2 配置媒体资源。
- 新的应用维度和指标
- SDK 版本 2 中引入了应用特有的新维度和指标，包括屏幕名称和屏幕浏览量、应用名称、应用版本等。
- 衡量崩溃和异常
- Android 版 Google Analytics（分析）SDK 引入了异常衡量和异常命中类型。使用异常衡量功能，您可以衡量崩溃和非严重异常的次数和类型。要了解如何实现异常衡量，请参阅异常开发者指南。
- 自定义维度和指标
- 创建自定义维度，以新的方式细分数据。 详细了解自定义维度和指标。
- 衡量社交互动
- 衡量用户与嵌入式社交插件和微件的互动，深入了解社交在应用中的价值。 详细了解如何衡量社交互动。
准备工作
所有开发者都需要在开始迁移之前完成以下两个步骤：
- 下载 Android 版 Google Analytics（分析）SDK v2
- 创建应用数据视图（配置文件），用于访问新的应用报告和数据。
完成上述步骤后，请根据您的迁移路径执行以下步骤。
从 EasyTracker 迁移
您需要执行以下三个步骤，才能将您的应用从 EasyTracker 库的 v1 版迁移到 v2 版：
1. 更新 GoogleAnalytics.xml 中的参数
迁移到版本 2 时，请更新 GoogleAnalytics.xml 资源文件中的参数，其中一些参数自 v1.x 以来发生了变化，并且版本 2 中增加了新参数。
下表显示了版本 2 中更新的参数：
| v1.x 参数名称 | v2.x 参数名称 |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | 已弃用 |
如需了解详情，请 参阅全新和更新后的 EasyTracker 参数。
2. 更新方法名称
尽管 EasyTracker 版本 2 中的大部分语法仍保持不变，但方法名称和语法之间存在一些显著差异，您将需要更新实现：
- 在版本 2 中，
trackPageView()为sendView()。如需了解详情，请参阅屏幕跟踪开发者指南 - 电子商务的实现已经简化。了解如何在版本 2 中实现电子商务衡量。
- 自定义变量已替换为自定义维度和指标。对
setCustomVar()的所有调用都应进行更新，以便利用新功能。 了解如何实现自定义维度和指标。
3. 更新广播接收器（Google Play 广告系列跟踪）
使用 v1.x 实现 Google Play 广告系列跟踪的开发者请注意，接收器的类路径已更改。有关详情，请参阅 Google Play 广告系列跟踪指南。
从自定义实现进行迁移
如果您没有在 Android 版 Google Analytics（分析）SDK v1.x 中使用 EasyTracker 库，建议您从版本 2 开始使用 EasyTracker。
EasyTracker 库现已包含在 SDK 中，建议所有开发者使用。 开始在 Google Analytics（分析）SDK v2 中使用 EasyTracker。
如果您有高级数据收集需求，例如在一次实现中使用多个媒体资源 ID，请参阅高级配置指南，详细了解如何使用 2.x 版 SDK 的高级功能。