本迁移指南介绍了 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 的高级功能。