Android 版 Google Analytics(分析)SDK:从 v1.x 迁移到 v2.x

本迁移指南介绍了 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 引入了异常衡量和异常命中类型。您可以使用异常衡量来衡量崩溃和非严重异常的数量和类型。如需了解如何实现异常衡量,请参阅异常开发者指南
自定义维度和指标
创建自定义维度,以新的方式细分数据。 详细了解自定义维度和指标
衡量社交互动
通过衡量用户与嵌入式社交插件和微件的互动情况,更深入地了解应用中的社交价值。 详细了解如何衡量社交互动。

准备工作

在开始迁移之前,所有开发者都需要执行以下两个步骤:

  1. 下载 Android 版 Google Analytics(分析)SDK v2
  2. 创建应用数据视图(配置文件)以用于访问新的应用报告和数据。

完成上述步骤后,针对迁移路径执行以下步骤。

从 EasyTracker 迁移

要将应用从 EasyTracker 库的 v1 迁移到 v2,您需要完成三个步骤:

  1. 更新 GoogleAnalytics.xml 资源文件中的参数
  2. 更新方法名称
  3. 更新您的广播接收器(Google Play 广告系列跟踪)

1. 更新 GoogleAnalytics.xml 中的参数

迁移到版本 2 时,更新 GoogleAnalytics.xml 资源文件中的参数,因为其中一些参数自 v1.x 以来发生了变化,并且在版本 2 中添加了新参数。

下表显示了版本 2 中更新的参数:

v1.x 参数名称v2.x 参数名称
ga_api_keyga_trackingId
ga_auto_activity_trackingga_autoActivityTracking
ga_dryRun已弃用

如需了解详情,请查看全新和更新后的 EasyTracker 参数

2. 更新方法名称

尽管 EasyTracker 版本 2 中的大部分语法仍保持不变,但方法名称和语法仍存在一些显著差异,需要您更新实现:

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 的高级功能。