本迁移指南介绍了 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),请参阅高级配置指南,详细了解如何使用 SDK v2.x 的高级功能。