Android 版 Google Analytics(分析)SDK 变更日志

本页记录了对 Android 版 Google Analytics(分析)SDK 所做的任何变更。我们建议您定期查看此列表,及时掌握最新信息。您还可以通过下文订阅一节中列出的 Feed 订阅变更内容。

订阅相关更新日志

包括所有数据收集、配置和报告 API。

包括网络跟踪(ga.js 和 analytics.js)、Android SDK、iOS SDK 和 Measurement Protocol。

在此版本中:

Google Analytics(分析)

  • 新增了对于非 Google Play 设备上的后台调度的支持。
  • 弃用了 Google Analytics(分析)日志记录器/LogLevel。Google Analytics(分析)现在使用的是 Android 日志记录。要启用调试日志记录,请运行 adb shell setprop log.tag.GAv4 DEBUG
  • 正在进行重构,以改进数据传输和安装广告系列归因工具。
  • 修复了广告系列解析问题,即问题 596
  • 正确报告了 Google Analytics(分析)初始化刚开始几秒内未处理的应用异常,即问题 443

Google 跟踪代码管理器

  • 没有变化。

在此版本中:

Google Analytics(分析)

Google 跟踪代码管理器

  • 修复了几个小问题。

在此版本中:

Google Analytics(分析)

  • 修复了几个小问题。

Google 跟踪代码管理器

在此版本中:

Google Analytics(分析)

  • 新增了对增强型电子商务的支持。如需了解详情,请参阅增强型电子商务开发者指南
  • 现在每次更改广告 ID 时,客户端 ID 都会重置。
  • 广告 ID 收集默认处于关闭状态。
  • 新增了用于报告异常的程序化 API。
  • 修复了文档中的几个问题。
  • 修复了几个小问题。

Google 跟踪代码管理器

  • Google 跟踪代码管理器没有变化。

在此版本中:

Google Analytics(分析)

  • Google Analytics(分析)没有变化。

Google 跟踪代码管理器

  • 新增了对 Google Analytics(分析)内容实验宏的支持。

在此版本中:* 包含的是测试版 6。* 如果针对 KitKat(API 级别 19)的应用使用 SDK,则需要进行更改以免出现运行时异常。

在此版本中:* 包含了版本 3.0 的第二个版本。* 如果针对 KitKat(API 级别 19)的应用使用 SDK,则需要进行更改以免出现运行时异常。

在此版本中:* 包含了版本 3.0 的第一个版本 * 重写了 SDK API,以使其更加与 analytics.js 保持一致。如需了解详情,请参阅 javadoc 和 /analytics/devguides/collection/android/v3/。* 移除了所有 tracksend 方法。您可以改为使用 MapBuilder 类中的 send 方法和相应的构造方法来发送命中。如需了解可用于通过 setsend 构建命中的常量列表,请参阅类 Fields。* 此外,还移除了许多各种不同的属性,包括 useHttpsanonymizeIp 等。您可以使用 set 命令设置/重置这些属性。* EasyTracker 现在扩展了 Tracker。无需调用 EasyTracker.getTracker 即可直接发出跟踪调用。* SDK 不再将会话控制标记设置为在启动时启动。现在,开发者负责决定是否需要新会话。请注意,EasyTracker 仍会像以前一样处理会话管理。* SDK 现在支持自定义日志记录类。如需了解详情,请参阅 javadoc 中的 Logger。* 新增了 dryRun 模式。* 现在可以读取 clientId。只需调用 tracker.get(Fields.CLIENT_ID) 即可。但此调用将一直保持阻止状态,直到从持久性存储中加载了 clientId。* SDK 将不再根据 HTTP 响应代码重试命中。

在此版本中:* 包含的是测试版 5。* 修复了 EasyTracker 异常解析问题。如果设置了 ga_reportUncaughtExceptions 标记,则我们不会初始化异常解析器,也因此而不会解析未捕获的异常的位置。修复此问题之后,如果将 ga_reportUncaughtExceptions 设置为 true,则崩溃和异常报告中会报告未捕获的异常的位置。

在此版本中:* 包含的是测试版 4。* SDK 现在将遵循采样率设置。如果您之前将采样率设置为除 100% 之外的其他值,则现在会发现一些 Google Analytics(分析)指标与 Beta 版 3 相比相应地有所降低。* track 方法更改成了 send(例如,trackView 现在称为 sendView)。* 通过 Transaction.setCurrencyCode 新增了本地货币支持 * 默认使用 HTTPS,而不是 HTTP。* 如果没有网络连接,SDK 将不会尝试调度命中。* 在尝试处理安装广告系列数据时避免出现 ANR。* 从 SDK 中移除了 TrackedActivity 类。* 从主界面线程中移出了 SDK 初始化。* 改进了 SDK 从已损坏的 SQLite 数据库中恢复的能力。* 修复了其他几个崩溃和问题。

在此版本中:

  • 修复了几个问题:
    • 修复了从 1.5 版之前的 SDK CV 迁移到 1.5 SDK 自定义变量时出现的问题。
    • 遵守用户的后台数据限制设置。

在此版本中:

  • 修复了几个问题:

    • 修复了内存泄露的问题。
    • 事件现在包含最后跟踪的网页浏览量 (utmp)。
  • 新增了几项功能:

    • 支持 50 个自定义变量(注意:此功能仅面向 Google Analytics Premium 用户提供)。

在此版本中:

  • 新增了对自定义维度和指标的支持。
  • 新增了对社交互动跟踪的支持。
  • StandardExceptionParser 类设为公开。
  • 修复了 SDK 初始化期间偶尔崩溃的问题。
  • 修复了一些设备上 INSTALL_REFERRER 广播被忽略的问题。
  • 修复了 GoogleTracker 类中的 ConcurrentModificationExceptions
  • 修复了其他问题并增强了几个功能

在此版本中:

  • 简化了 EasyTracker 界面。
  • 将调度控制移至新类 GAServiceManager
  • 更新为使用最新的线上传输格式。
  • sampleRate 改为使用双精度浮点数。
  • 限制了过度跟踪。
  • 启用选择退出后,系统会删除未调度的跟踪信息。
  • 系统将删除 30 天以上未调度的跟踪信息。
  • 修复了其他问题并增强了几个功能。

在此版本中:

  • 移除了 startSession 方法。请改用 setStartSession
  • EasyTracker 中新增了 ga_sessionTimeout 参数。
  • 实现了节电模式。
  • GAITracker 中新增了 trackView 方法,该方法不使用任何参数。
  • 修复了阻止在命中上发送异常参数的问题。
  • 舍弃了无法从数据库读取的命中,而不是永久阻止调度所有命中。
  • 更新为使用最新的线上传输格式。
  • 实现了计时命中类型。
  • 实现了电子商务命中类型(交易和商品)。

在此版本中:

  • 文档:

    • ReadMe.txt 已更新为指向可以获取文档的网站。

在此版本中:

  • 修复了几个问题:
    • 修复了 Google Play 中的目标网址自动跟踪的处理问题。
    • 允许对 setReferrer 的引荐来源网址参数进行网址编码。

在此版本中:

  • 修复了几个问题:
    • 捕获并处理了几个 SQLiteExceptions
    • 修复了在调用 startNewSession 前调用的 stopSession 中的 NullPointerException 问题(如果调用的话)。
    • 解决了 HTC Thunderbolt 和 Motorola Droid Bionic 设备上的内存不足错误。
    • 取消了调度方法中不必要的数据库访问权限。

在此版本中:

  • 修复了几个问题:
    • 修复了一般广告系列引荐跟踪中的问题。
    • 修复了干扰广告系列跟踪的 anonymizeIp 标记。

在此版本中:

  • 修复了几个问题:
    • 修复了数据库处理方面的几个问题。
    • 修复了使用自定义变量时出现的异常。
    • 存储应用的上下文,而不是向应用传递的上下文。
    • 不会再意外创建虚拟会话。
  • 新增了几项功能:
    • 新增了随时设置广告系列引荐的功能
    • 新增了 sampleRate 标记
    • 新增了 anonymizeIp 标记

在此版本中:

  • 修复了几个问题:

    • 修复了格式有误的 userAgent 字符串。
  • 新增了几项功能:

    • 新增了对电子商务跟踪的支持
    • 新增了 debug 标记
    • 新增了 dryRun 标记

在此版本中:

  • 修复了几个问题:

    • 修复了错误的空格编码。
    • SQLiteExceptions 不再会导致应用崩溃。
  • 新增了几项功能:

    • 新增了对自定义变量的支持