配置参数

本文档将提供 Android 版 Google Analytics(分析)SDK v4 中可用配置参数的完整列表参考。

概览

在 Android 版 Google Analytics(分析)SDK v4 中,您可以对 XML 配置文件中定义的全局参数和跟踪器专有参数进行配置。下表列出了您可以使用的所有参数。

参数

参数类型Purpose
ga_anonymizeIp boolean 如果为 true,则告知 Google Analytics(分析)匿名化处理跟踪器对象发送的信息,即在存储前移除 IP 地址的最后一个八位位组。请注意,这会稍微降低地理位置报告的准确性。默认值为 false
ga_appName string 您的应用的名称,用于报告中的应用名称维度。可以在软件包中找到默认值。
ga_appVersion string 您的应用的版本,用于报告中的应用版本维度。默认情况下将采用在软件包中检测到的版本值。
ga_autoActivityTracking boolean 如果为 true,则将自动跟踪视图(活动)。默认值为 false
ga_dispatchPeriod integer 自动调度的频率,以秒为单位。默认值为 30 分钟(1,800)秒。
ga_dryRun boolean 如果为 true,请启用试运行模式。在 dry run 模式中,普通代码路径将照常在本地执行,但匹配将不会被发送到 Google Analytics(分析)服务器。这可用于调试对 Google Analytics(分析)SDK 的调用,而不会影响到服务器上记录的数据。默认值为 false
ga_reportUncaughtExceptions boolean 如果设为 true,则每次您的应用中出现未捕获的异常时,Google Analytics(分析)都会自动记录 Exception。默认值为 false
ga_sampleFrequency string 要使用的采样率,可以是 0.0 到 100.0 之间的任何值。 默认值为 100.0
ga_sessionTimeout integer 您的应用在后台停留多长时间(以秒为单位)才能将该会话视为结束。将此值设为负数会导致 SDK 不启动新会话。不过,会话超时设置仍可在 Google Analytics(分析)管理界面中进行管理;有关详情,请参阅 会话和广告系列超时处理。默认持续时间为 30 秒。
ga_trackingId string 您要向其发送数据的 Google Analytics(分析)跟踪 ID。ID 中的短划线必须未经编码。不提供此值即可停用跟踪功能。