Google Analytics(分析)- 所有 API 更新日志

本页面记录了对所有 Google Analytics(分析)API 和 SDK 所做的变更,其中包括所有数据收集、报告和配置 API 的更新日志。 我们建议您定期查看此列表,及时掌握最新信息。您还可以通过下文订阅一节中列出的 Feed 订阅内容变更信息。

订阅相关更新日志

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

这是 User Activity API 的初始版本

  • 借助 User Activity API,您可以检索指定日期范围内与单个 Client ID 或 User ID 相关联的所有数据。某些媒体资源所有者希望直接向用户提供自动访问用户自己的数据的权限,该 API 主要用于为这些所有者提供支持。如需了解详情,请参阅 User Activity API 指南

Management API 中的用户数据保留设置

现在,可以使用 WebProperty 资源中新增的“dataRetentionTtl”和“dataRetentionResetOnNewActivity”字段以编程方式配置用户数据保留设置。

这是 User Deletion API 的初始版本:

  • 借助 User Deletion API,Google Analytics(分析)客户可以从项目或网站媒体资源中删除指定最终用户的数据。可以使用 Firebase 项目或 Google Analytics(分析)媒体资源发出用户删除请求。如需了解详情,请参阅 User Deletion API 概览

Management API 中的写入操作

Management API 中针对网站媒体资源、数据视图(配置文件)和目标资源的写入操作(例如,create、update、delete、patch)不再需要列入白名单。Management API 中所有写入操作的默认每日限制为每天 50 次写入。如需了解详情,请参阅限制和配额页面。

在此版本中,适用于 Google Analytics(分析)Reporting API v4 的基于资源的配额系统可供所有 Analytics 360 (Premium) 客户使用。

此版本引入了对 Google Analytics(分析)Real Time API 配额和限制所做的变更。

使用 Google Analytics(分析)Real Time Reporting API 调用,每个数据视图(配置文件)每天可执行 1 万次调用,与其他 Google Analytics(分析)API 调用数量限制相当。现在,Google Analytics(分析)Real Time Reporting API 调用是单独统计的,这意味着使用 Google Analytics(分析)Real Time Reporting API,每个数据视图(配置文件)每天可执行 1 万次调用,并且使用其他 Google Analytics(分析)API,每个数据视图(配置文件)每天可再执行 1 万次调用。如需了解详情,请参阅限制和配额页面。

此变更提供了一种更为精细且支持故障安全的配额管理方法,因此,在使用 Google Analytics(分析)Real Time Reporting API 进行频繁调用时,不会在当天剩余时间内意外阻止单个配置文件的所有其他 Google Analytics(分析)API 调用。

此版本为 Google Analytics(分析)Reporting API v4 新增了基于资源的配额系统的预览功能,这样一来,Analytics 360 (Premium) 客户可以使用更高的抽样阈值。

新增了“android-app://”网址作为有效的引荐来源。

此版本弃用了相关产品功能以及相关的维度和指标;如需查看完整的定义列表,请参阅维度和指标参考。如需详细了解数据移除,请查看数据弃用政策

此版本弃用了以下维度和指标:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

此版本为 API 新增了一个维度;如需查看完整的定义列表,请参阅维度和指标参考。此版本还移除了一些已弃用的维度和指标;如需了解完整的数据移除流程,请查看 Google Analytics(分析)API 数据弃用政策

时间

  • 新增了维度 ga:dateHourMinute,其中包含 ga:datega:hourga:minute

数据移除

此版本移除了以下已弃用的维度和指标:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

此版本更新了 API 中的现有指标和维度。如需查看完整的定义列表,请参阅维度和指标参考

用户指标

更新了“用户数”和“活跃用户数”指标的计算方法,以期更高效地统计用户数。您可能会发现指标与之前略有不同。如需了解详情,请参阅为“用户数”指标识别用户的方式

受计算方法更新影响的用户指标如下:

  • ga:users - 所请求时间段内的用户总数。
  • ga:1dayusers - 所请求时间段内每一天对应的过去 1 天内的活跃用户总数。
  • ga:7dayusers - 所请求时间段内每一天对应的过去 7 天内的活跃用户总数。
  • ga:14dayusers - 所请求时间段内每一天对应的过去 14 天内的活跃用户总数。
  • ga:30dayusers - 所请求时间段内每一天对应的过去 30 天内的活跃用户总数。

唯一身份事件数

ga:uniqueEvents 的弃用期即将结束。2017 年 3 月 26 日之后,我们会更新 ga:uniqueEvents 的定义并从 API 中移除不公开指标 ga:uniqueEventsTemporary。如需了解详情,请参阅唯一身份事件数帮助文档

此版本为 API 新增了一个维度,改进了错误消息,并开始实施之前公布的对 AdSense 维度和指标所做的变更。

用户维度

  • 维度 - ga:userBucket - 对于任何指定用户,“用户范围”维度(1 到 100 的值)会指明用户所分配到的范围。如需了解详情,请参阅测试再营销广告系列一文。

错误消息

在请求尚未满足条件的数据时,API 之前会返回错误的错误消息 Unknown dimension(s):Unknown metric(s):,而现在会返回以下消息:Restricted metric(s): ... can only be queried under certain conditions.

AdSense 维度和指标

未关联 AdSense 帐号的数据视图将受到限制,无法用于查询 AdSense 维度和指标。如果通过未关联 AdSense 帐号的数据视图查询此类维度和指标,则会导致错误。

自定义指标

这是一个问题修复版本;此版本修复了在未设置 min_value 时无法创建类型为 TIME自定义指标的问题。现在,在未设置 min_value 时发出请求可创建自定义指标,其中 min_value 默认为 0

这是一个问题修复版本,此版本修复了 AdSense 维度和指标存在的问题,并公布了即将对此类维度和指标进行的更改。

AdSense 维度和指标

此版本修复了自 2017 年 1 月 7 日起出现的问题:如果通过未关联 AdSense 帐号的数据视图查询 AdSense 维度和指标,系统会返回“Unknown Metric”(未知指标)错误。

即将进行的更改

在 2017 年 1 月 31 日当天或之后,未关联 AdSense 帐号的数据视图将受到限制,无法用于查询 AdSense 维度和指标。如果通过未关联 AdSense 帐号的数据视图查询此类维度和指标,则会导致错误。

此版本为 API 新增了以下指标。如需查看完整的定义列表,请参阅维度和指标参考

计算指标

此版本新增了对计算指标的支持。

  • 指标 - ga:calcMetric_ - 所请求计算指标的值,其中 是指用户指定的计算指标的名称。请注意,ga:calcMetric_ 的数据类型可以是浮点数、整数、货币、时间或百分比。如需了解详情,请参阅计算指标简介

此版本为 API 新增了一个指标,同时弃用了一个现有指标。如需查看完整的定义列表,请参阅维度和指标参考

事件跟踪

ga:uniqueEvents 的定义将发生变化,以便更准确地反映唯一身份事件的数量。为了使这项变更生效,我们将根据数据弃用政策从技术层面上弃用当前的 ga:uniqueEvents 指标。如果您想试用新定义,则可以引用不公开指标 ga:uniqueEventsTemporary,该指标能够更准确地计算唯一身份事件的数量。此外,我们还将引入新指标 ga:uniqueDimensionCombinations,该指标可保留 ga:uniqueEvents 的当前定义。在适当的弃用期(约 6 个月)之后,我们会移除不公开指标 ga:uniqueEventsTemporary,届时原始指标 ga:uniqueEvents 将正确表示唯一身份事件的数量。如需了解详情,请参阅唯一身份事件数帮助文档

唯一身份事件数

  • 指标 - ga:uniqueEvents - ga:uniqueEvents 的定义即将发生变化,以便更准确地反映唯一身份事件的数量。如果您想要保留现有定义,请改用 ga:uniqueDimensionCombinations。如需了解详情,请参阅唯一身份事件数帮助文档
  • 指标 - ga:uniqueDimensionCombinations -“唯一维度集数”对报告中每个维度的唯一维度值组合进行计数。这样您就可以进行组合(串联)的维度后处理,从而可以更灵活地生成报告,而不必更新您的跟踪实现,或使用其他自定义维度区间。如需了解详情,请参阅唯一身份事件数帮助文档

转换测试 - 不公开

  • 指标 - ga:uniqueEventsTemporary - 唯一身份事件数;这将是 ga:uniqueEvents 的新定义。您可以在变更发生之前使用此指标了解新定义。请注意,此指标为不公开指标,不会显示在维度和指标参考中。

在此版本中:

Google Analytics(分析)

  • 解决了 iOS 10 兼容性问题,并修复了几个问题。

在此版本中:

Google Analytics(分析)

  • 修复了崩溃问题。

此版本为 API 新增了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考

DoubleClick Bid Manager

  • 维度 - ga:dbmClickAdvertiser - 与 Google Analytics(分析)会话匹配的 DBM 点击所对应的 DBM 广告客户名称(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmClickAdvertiserId - 与 Google Analytics(分析)会话匹配的 DBM 点击所对应的 DBM 广告客户 ID(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmClickCreativeId - 与 Google Analytics(分析)会话匹配的 DBM 点击所对应的 DBM 广告素材 ID(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmClickExchange - 与 Google Analytics(分析)会话匹配的 DBM 点击所对应的 DBM 交易平台名称(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmClickExchangeId - 与 Google Analytics(分析)会话匹配的 DBM 点击所对应的 DBM 交易平台 ID(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmClickInsertionOrder - 与 Google Analytics(分析)会话匹配的 DBM 点击所对应的 DBM 广告订单名称(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmClickInsertionOrderId - 与 Google Analytics(分析)会话匹配的 DBM 点击所对应的 DBM 广告订单 ID(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmClickLineItem - 与 Google Analytics(分析)会话匹配的 DBM 点击所对应的 DBM 订单项名称(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmClickLineItemId - 与 Google Analytics(分析)会话匹配的 DBM 点击所对应的 DBM 订单项 ID(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmClickSite - 与 Google Analytics(分析)会话匹配的 DBM 点击所对应的 DBM 网站(DBM 广告素材在其中展示并带来了点击)名称(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmClickSiteId - 与 Google Analytics(分析)会话匹配的 DBM 点击所对应的 DBM 网站(DBM 广告素材在其中展示并带来了点击)ID(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmLastEventAdvertiser - 与 Google Analytics(分析)会话相关联的 DBM 最终事件(DBM 回溯期内发生的展示或点击)所对应的 DBM 广告客户名称(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmLastEventAdvertiserId - 与 Google Analytics(分析)会话相关联的 DBM 最终事件(DBM 回溯期内发生的展示或点击)所对应的 DBM 广告客户 ID(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmLastEventCreativeId - 与 Google Analytics(分析)会话相关联的 DBM 最终事件(DBM 回溯期内发生的展示或点击)所对应的 DBM 广告素材 ID(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmLastEventExchange - 与 Google Analytics(分析)会话相关联的 DBM 最终事件(DBM 回溯期内发生的展示或点击)所对应的 DBM 交易平台名称(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmLastEventExchangeId - 与 Google Analytics(分析)会话相关联的 DBM 最终事件(DBM 回溯期内发生的展示或点击)所对应的 DBM 交易平台 ID(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmLastEventInsertionOrder - 与 Google Analytics(分析)会话相关联的 DBM 最终事件(DBM 回溯期内发生的展示或点击)所对应的 DBM 广告订单名称(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmLastEventInsertionOrderId - 与 Google Analytics(分析)会话相关联的 DBM 最终事件(DBM 回溯期内发生的展示或点击)所对应的 DBM 广告订单 ID(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmLastEventLineItem - 与 Google Analytics(分析)会话相关联的 DBM 最终事件(DBM 回溯期内发生的展示或点击)所对应的 DBM 订单项名称(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmLastEventLineItemId - 与 Google Analytics(分析)会话相关联的 DBM 最终事件(DBM 回溯期内发生的展示或点击)所对应的 DBM 订单项 ID(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmLastEventSite - 与 Google Analytics(分析)会话相关联的 DBM 最终事件(DBM 回溯期内发生的展示或点击)所对应的 DBM 网站(DBM 广告素材在其中展示并带来了点击)名称(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dbmLastEventSiteId - 与 Google Analytics(分析)会话相关联的 DBM 最终事件(DBM 回溯期内发生的展示或点击)所对应的 DBM 网站(DBM 广告素材在其中展示并带来了点击)ID(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 指标 - ga:dbmCPA - DBM 收入 eCPA(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 指标 - ga:dbmCPC - DBM 收入智能点击付费(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 指标 - ga:dbmCPM - DBM 收入有效每千次展示费用(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 指标 - ga:dbmCTR - DBM 点击率(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 指标 - ga:dbmClicks - DBM 总点击次数(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 指标 - ga:dbmConversions - DBM 总转化次数(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 指标 - ga:dbmCost - DBM 费用(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 指标 - ga:dbmImpressions - DBM 总展示次数(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 指标 - ga:dbmROAS - DBM 广告支出回报率(仅适用于 Analytics 360,需要与 DBM 集成)。
  • 维度 - ga:dsAdGroup - DS 广告组(仅适用于 Analytics 360,需要与 DS 集成)。
  • 维度 - ga:dsAdGroupId - DS 广告组 ID(仅适用于 Analytics 360,需要与 DS 集成)。
  • 维度 - ga:dsAdvertiser - DS 广告客户(仅适用于 Analytics 360,需要与 DS 集成)。
  • 维度 - ga:dsAdvertiserId - DS 广告客户 ID(仅适用于 Analytics 360,需要与 DS 集成)。
  • 维度 - ga:dsAgency - DS 代理机构(仅适用于 Analytics 360,需要与 DS 集成)。
  • 维度 - ga:dsAgencyId - DS 代理机构 ID(仅适用于 Analytics 360,需要与 DS 集成)。
  • 维度 - ga:dsCampaign - DS 广告系列(仅适用于 Analytics 360,需要与 DS 集成)。
  • 维度 - ga:dsCampaignId - DS 广告系列 ID(仅适用于 Analytics 360,需要与 DS 集成)。
  • 维度 - ga:dsEngineAccount - DS 引擎帐号(仅适用于 Analytics 360,需要与 DS 集成)。
  • 维度 - ga:dsEngineAccountId - DS 引擎帐号 ID(仅适用于 Analytics 360,需要与 DS 集成)。
  • 维度 - ga:dsKeyword - DS 关键字(仅适用于 Analytics 360,需要与 DS 集成)。
  • 维度 - ga:dsKeywordId - DS 关键字 ID(仅适用于 Analytics 360,需要与 DS 集成)。
  • ga:dsCPC - DS 每次点击费用,由广告客户支付(仅适用于 Analytics 360,需要与 DS 集成)。
  • ga:dsCTR - DS 点击率(仅适用于 Analytics 360,需要与 DS 集成)。
  • ga:dsClicks - DS 点击次数(仅适用于 Analytics 360,需要与 DS 集成)。
  • ga:dsCost - DS 费用(仅适用于 Analytics 360,需要与 DS 集成)。
  • ga:dsImpressions - DS 展示次数(仅适用于 Analytics 360,需要与 DS 集成)。
  • ga:dsProfit - DS 个人资料(仅适用于 Analytics 360,需要与 DS 集成)。
  • ga:dsReturnOnAdSpend - DS 广告支出回报率(仅适用于 Analytics 360,需要与 DS 集成)。
  • ga:dsRevenuePerClick - DS 每次点击收入(仅适用于 Analytics 360,需要与 DS 集成)。

此版本为 API 新增了一个维度。如需查看完整的定义列表,请参阅维度和指标参考

交易 ID

  • 维度 - mcf:transactionId - 电子商务跟踪方法提供给购物车中的购买的交易 ID。

此版本为 API 新增了一个维度。此外,还针对可一起查询的维度组合新增了一些限制。如需查看完整的定义列表,请参阅维度和指标参考

地理位置网络

  • 维度 - ga:continentId - 用户所处大洲的 ID,依据用户的 IP 地址或地理位置 ID 得出。

限制

以下群组中所列的维度无法与其他群组中的维度一起查询:

  • 访问购物信息组
    • ga:checkoutOptions
    • ga:shoppingStage
  • GWO 实验组
    • ga:experimentVariant
    • ga:experimentId
  • 兴趣组
    • ga:interestOtherCategory
  • 有购买意向的受众群体的兴趣组
    • ga:interestInMarketCategory
  • 内部推广活动组:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • 品牌兴趣组:
    • ga:interestAffinityCategory

此版本引入了新的限制和配额。如需了解详情,请参阅限制和配额

报告错误

此版本开始对失败的 (5XX) 报告请求数实施限制。

  • 每个配置文件每个项目每小时不得超过 10 次失败的请求。
  • 每个配置文件每个项目每天不得超过 50 次失败的请求。

数据透视限制

此版本开始对数据透视请求数实施限制:

  • 现在,一个报告请求最多可以有 2 个数据透视
  • 一个数据透视最多可以有 4 个维度
  • 数据透视维度属于对请求中所允许维度总数的限制。
  • 数据透视指标属于对请求中所允许指标总数的限制。

此版本为 API 新增了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考

地理位置网络

  • 维度 - ga:metroId - 特定媒体市场区域 (DMA)(所到达流量的来源)的三位数代码,依据用户的 IP 地址或地理位置 ID 得出。

DFP 广告管理系统

  • 指标 - ga:dfpImpressions - 在网站上每展示一个广告,系统就会报告一次 DFP 广告展示。例如,如果包含两个广告单元的网页获得一次浏览,我们就会显示两次广告单元展示(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:dfpCoverage - 覆盖率是指返回至少一个广告的广告请求数占广告请求总数的百分比。一般来说,通过覆盖率您可以确定 DFP 帐号在哪些网站上无法提供定位广告。(广告展示次数/广告请求总数)* 100(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:dfpMonetizedPageviews - 此指标用于衡量与关联的 DFP 帐号中的广告一同展示的媒体资源所带来的网页浏览总数。请注意,单个网页可以包含多个广告单元(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:dfpImpressionsPerSession - DFP 广告展示次数与 Google Analytics(分析)会话次数的比率(广告展示次数/Google Analytics(分析)会话次数)(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:dfpViewableImpressionsPercent - 可见广告展示次数占总广告展示次数的百分比。当广告显示在用户的浏览器中并可能会被用户看到时,我们就将这次展示视为一次可见的展示(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:dfpClicks - 用户在网站上点击 DFP 广告的次数(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:dfpCTR - 带来 DFP 广告点击的网页浏览量所占的百分比(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:dfpRevenue - DFP 收入是根据所投放的展示次数估算的广告总收入(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:dfpRevenuePer1000Sessions - 每 1,000 次 Google Analytics(分析)会话带来的 DFP 广告估算收入总额。请注意,此指标的计算依据是网站的会话数而不是广告展示次数(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:dfpECPM - 有效每千次网页浏览费用,是指每 1,000 次网页浏览量的 DFP 收入(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:backfillImpressions - 补余广告展示次数是指通过 DFP 投放的所有 AdSense 或 Ad Exchance 补余广告展示次数的总和。在网站上每展示一个广告,系统就会报告一次广告展示。例如,如果包含两个广告单元的网页获得一次浏览,我们就会显示两次广告单元展示(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:backfillCoverage - 补余广告覆盖率是指返回至少一个广告的补余广告请求数占广告请求总数的百分比。一般来说,通过覆盖率您可以确定发布商帐号在哪些网站上无法提供定位广告。(广告展示次数/广告请求总数)* 100。如果同时通过 AdSense 和 Ad Exchange 帐号投放补余广告,则此指标表示这两个补余广告帐号的相应值的加权平均值(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:backfillMonetizedPageviews - 此指标用于衡量与关联的补余广告帐号中的至少一个广告一同展示的媒体资源所带来的网页浏览总数。请注意,一次创收的网页浏览可以包含多次广告展示(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:backfillImpressionsPerSession - 补余广告展示次数与 Google Analytics(分析)会话次数的比率(广告展示次数/Google Analytics(分析)会话次数)。如果同时通过 AdSense 和 Ad Exchange 投放补余广告,则此指标表示这两个补余广告帐号的相应值的加权平均值(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:backfillViewableImpressionsPercent - 可见补余广告展示次数占总广告展示次数的百分比。当补余广告显示在用户的浏览器中并可能会被用户看到时,我们就将这次展示视为一次可见的展示。如果同时通过 AdSense 和 Ad Exchange 投放补余广告,则此指标表示这两个补余广告帐号的相应值的加权平均值(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:backfillClicks - 用户在网站上点击补余广告的次数。如果同时通过 AdSense 和 Ad Exchange 投放补余广告,则此指标表示这两个补余广告帐号的相应值的加权平均值(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:backfillCTR - 带来广告点击的补余广告展示次数所占的百分比。如果同时通过 AdSense 和 Ad Exchange 投放补余广告,则此指标表示这两个补余广告帐号的相应值的加权平均值(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:backfillRevenue - 补余广告带来的估算收入总额。如果同时通过 AdSense 和 Ad Exchange 投放补余广告,则此指标表示这两个补余广告帐号的相应值的加权平均值(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:backfillRevenuePer1000Sessions - 每 1,000 次 Google Analytics(分析)会话带来的补余广告估算收入总额。请注意,此指标的计算依据是网站的会话数而不是广告展示次数。如果同时通过 AdSense 和 Ad Exchange 投放补余广告,则此指标表示这两个补余广告帐号的相应值的加权平均值(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。
  • 指标 - ga:backfillECPM - 有效每千次网页浏览费用,是指每 1,000 次网页浏览量的 DFP 补余广告收入。如果同时通过 AdSense 和 Ad Exchange 投放补余广告,则此指标表示这两个补余广告帐号的相应值的加权平均值(已启用 DFP 关联,但未启用“隐藏 DFP 收入”)。

此版本新增了属性 addedInApiVersion

在 API 版本中添加

  • addedInApiVersion 是一个数字表示的属性,可用于检查是否可在指定版本的报告 API 中使用某个列;如需了解详情,请参阅 Metadata API - 开发者指南

此版本公布了新版 API,即 Google Analytics(分析)Reporting API V4。这一新 API 是以编程方式访问 Google Analytics(分析)报告数据的最先进方法。

主要功能

Google Analytics(分析)在功能强大的数据报告基础架构的基础上构建而成。借助该 API,开发者可以使用 Google Analytics(分析)平台的强大功能。Google Analytics(分析)Reporting API V4 的一些主要功能如下所示:

  • 指标表达式 - 该 API 不仅可用于请求内置指标,还可用于请求数学指标表达式。例如,目标达成次数/会话数在请求中可以表示为 ga:goal1completions/ga:sessions
  • 多个日期范围 - 支持请求两个日期范围,因此您可以在单个请求中比较两个日期范围内的数据。
  • 同类群组和生命周期价值 - 该 API 包含丰富的词汇,可用于请求“同类群组”和“生命周期价值”报告。
  • 多个细分 - 您现在可以在单个请求中请求多个细分。

使用入门

如需了解有关 API 使用入门的全部详细信息,请参阅开发者文档

配额政策

Google Analytics(分析)Reporting API V4 随附自己的配额和限制;这是一个全新的 API,因此这些限制和配额可能会发生变动。

迁移

除了迁移指南外,我们还在 GitHub 上提供了 Python 兼容性库

维度和指标

此版本还新增了一组专门针对 Google Analytics(分析)Reporting API V4 的维度和指标。如需查看完整的列表定义,请参阅维度和指标浏览器

  • 维度 - ga:cohort - 用户所属的同类群组的名称,以同类群组的定义为依据。根据同类群组的定义方式,一位用户可以属于多个同类群组,类似于一位用户可以属于多个细分。

  • 维度 - ga:cohortNthDay - 相对于同类群组定义日期,以 0 为起点的日期偏移。例如,如果将同类群组的首次访问日期定义为 2015-09-01,那么对于 2015-09-04,ga:cohortNthDay 将是 3。

  • ga:cohortNthMonth - 相对于同类群组定义日期,以 0 为起点的月份偏移。

  • 维度 - ga:cohortNthWeek - 相对于同类群组定义日期,以 0 为起点的周偏移。

  • 维度 - ga:acquisitionTrafficChannel - 赢得用户的流量渠道,提取自用户的第一个会话。在赢得用户之时,基于默认的渠道分组规则计算流量渠道(如果在数据视图一级有的话)。

  • 维度 - ga:acquisitionSource - 赢得用户的来源,来自于用户的第一个会话。

  • 维度 - ga:acquisitionMedium - 赢得用户的媒介,来自于用户的第一个会话。

  • 维度 - ga:acquisitionSourceMedium - ga:userAcquisitionSource 和 ga:acquisitionMedium 的组合值。

  • 维度 - ga:acquisitionCampaign - 赢得用户的广告系列,来自于用户的第一个会话。

  • 指标 - ga:cohortActiveUsers - 此指标适用于偏移维度(ga:cohortNthDayga:cohortNthWeekga:cohortNthMonth)以 0 为起点的情况,用于指明在与同类群组第 N 个时间段(天、周、月)相对应的时间范围内该同类群组中活跃的用户数。例如,ga:cohortNthWeek = 1 表示第二周(同类群组中)活跃的用户数。如果请求没有包含任何 ga:cohortNthDayga:cohortNthWeekga:cohortNthMonth,此指标的值与 ga:cohortTotalUsers 相同。

  • 指标 - ga:cohortTotalUsers - 属于同类群组的用户数,也称为同类群组规模。

  • 指标 - ga:cohortAppviewsPerUser - 同类群组中每位用户的应用浏览次数。

  • 指标 - ga:cohortGoalCompletionsPerUser - 同类群组中每位用户的目标达成次数。

  • 指标 - ga:cohortPageviewsPerUser - 同类群组中每位用户的网页浏览次数。

  • 指标 - ga:cohortRetentionRate - 同类群组留存率。

  • 指标 - ga:cohortRevenuePerUser - 同类群组中每位用户带来的收入。

  • 指标 - ga:cohortVisitDurationPerUser - 同类群组中每位用户的会话时长。

  • 指标 - ga:cohortSessionsPerUser - 同类群组中每位用户的会话数。

  • 指标 - ga:cohortTotalUsersWithLifetimeCriteria - 此指标适用于请求具有 ga:acquisitionTrafficChannelga:acquisitionSourcega:acquisitionMediumga:acquisitionCampaign 维度的情况,用于表示通过当前渠道、来源、媒介或广告系列赢得的同类群组中用户的数量。例如,ga:acquisitionTrafficChannel=Direct 表示直接赢得的同类群组中用户的数量。如果上述维度都不存在,则其值等于 ga:cohortTotalUsers

  • 指标 - ga:cohortAppviewsPerUserWithLifetimeCriteria - 同类群组中“流量获取”维度下每位用户的应用浏览次数。

  • 指标 - ga:cohortGoalCompletionsPerUserWithLifetimeCriteria - 同类群组中“流量获取”维度下每位用户的目标达成次数。

  • 指标 - ga:cohortPageviewsPerUserWithLifetimeCriteria - 同类群组中“流量获取”维度下每位用户的网页浏览次数。

  • 指标 - ga:cohortRevenuePerUserWithLifetimeCriteria - 同类群组中“流量获取”维度下每位用户带来的收入。

  • 指标 - ga:cohortSessionsPerUserWithLifetimeCriteria - 同类群组中“流量获取”维度下每位用户的会话时长。

社交数据中心的维度和指标已弃用,在 2016 年 4 月 30 日之后将仅针对历史数据生成报告;在此日期之后,将不会显示任何新数据。根据数据弃用政策,我们将在 2016 年 9 月 30 日之后移除这些维度和指标。

如需查看完整的定义列表,请参阅维度和指标参考

社交活动

这些维度和指标已弃用,并将在 2016 年 9 月 30 日之后被移除。如需详细了解数据移除,请查看数据弃用政策

  • 维度 - ga:socialActivityEndorsingUrl - 对于社交数据中心活动,这是指社交活动的网址(例如,Google+ 帖子的网址、博客评论的网址等)。
  • 维度 - ga:socialActivityDisplayName - 对于社交数据中心活动,这是指社交网络用户发布的社交活动的名称。
  • 维度 - ga:socialActivityPost - 对于社交数据中心活动,这是指社交网络用户发布的社交活动的内容(例如,在 Google+ 中发布的消息的内容)。
  • 维度 - ga:socialActivityTimestamp - 对于社交数据中心活动,这是指社交活动在社交网络上发生的时间。
  • 维度 - ga:socialActivityUserHandle - 对于社交数据中心活动,这是指发起社交活动的用户的社交网络称呼(例如名称或 ID)。
  • 维度 - ga:socialActivityUserPhotoUrl - 对于社交数据中心活动,这是指与用户的社交网络个人资料相关联的照片的网址。
  • 维度 - ga:socialActivityUserProfileUrl - 对于社交数据中心活动,这是指相关联的用户社交网络个人资料的网址。
  • 维度 - ga:socialActivityTagsSummary - 对于社交数据中心活动,这是指与社交活动相关联的一组标签(以英文逗号分隔)。
  • 维度 - ga:socialActivityAction - 对于社交数据中心活动,这表示与社交活动相关的社交操作类型(例如,投票、评论、+1 等)。
  • 维度 - ga:socialActivityNetworkAction - 对于社交数据中心活动,这是指社交操作和发起社交活动的社交网络的类型。
  • 维度 - ga:socialActivityContentUrl - 对于社交数据中心活动,这是指相关社交网络用户分享的网址。
  • 指标 - ga:socialActivities - 在社交数据中心合作伙伴网络上分享或提及某个内容网址的活动的总数。

此版本为 API 新增了一个维度。如需查看完整的定义列表,请参阅维度和指标参考

平台或设备

  • 维度 - ga:browserSize - 用户浏览器的视口尺寸。“浏览器窗口尺寸”是一个会话级维度,可捕获视口的初始尺寸(以像素为单位),表示形式为宽度 x 高度。例如,1920x960。

非抽样报告

Unsampled Reports API 不再具有每天 100 份报告的限制。该 API 使用与通过网页界面创建非抽样报告时相同的每媒体资源、每一天令牌系统。

非抽样报告

对于当前用户无法访问的非抽样报告,我们将不再在 Management API 响应消息中提供相应的下载链接。此行为现在与界面信息中心功能一致(在界面信息中心只有报告所有者才能看到已生成文档的下载链接)。

数据视图(配置文件)

此版本为数据视图(配置文件)资源新增了 botFilteringEnabled 属性。此属性可指明是否为数据视图(配置文件)启用了漫游器过滤。如需了解详情,请参阅数据视图(配置文件)参考文档

非抽样报告

此版本为非抽样报告新增了 delete 方法。如需了解详情,请参阅“非抽样报告:delete”参考文档

在此版本中:

Google Analytics(分析)

  • 没有变化。

Google 跟踪代码管理器

  • 修复了在运行单元测试时会导致崩溃的问题

细分

这是一个问题修复版本;此版本修复了以下问题:在调用细分 list 方法时会导致包含定义中货币值的细分错误地显示。

此版本为 API 新增了一个参数。

包含空行

  • 此版本新增了可选参数 include-empty-rows;该参数设置为 false 时,系统将从响应中省略不包含任何数据的行。默认值为 true,这是一项非重大变更,因此不需要进行代码更新。如需了解详情,请参阅 Core Reporting API 参考文档

在此版本中:

Google Analytics(分析)

  • 新增了对位码的支持。

Google 跟踪代码管理器

  • 新增了对位码的支持。

此版本为 API 新增了一些指标。如需查看完整的定义列表,请参阅维度和指标参考

用户

  • 指标 - ga:1dayUsers - 所请求时间段内每一天对应的过去 1 天内的活跃用户总数。要查询此指标,必须将 ga:nthDay、ga:date 或 ga:day 中至少一个指定为维度。在指定日期内,返回值将是过去 1 天内的唯一身份用户总数(截至指定日期)。
  • 指标 - ga:7dayUsers - 所请求时间段内每一天对应的过去 7 天内的活跃用户总数。要查询此指标,必须将 ga:nthDay、ga:date 或 ga:day 中至少一个指定为维度。在指定日期内,返回值将是过去 7 天内的唯一身份用户总数(截至指定日期)。
  • 指标 - ga:14dayUsers - 所请求时间段内每一天对应的过去 14 天内的活跃用户总数。要查询此指标,必须将 ga:nthDay、ga:date 或 ga:day 中至少一个指定为维度。在指定日期内,返回值将是过去 14 天内的唯一身份用户总数(截至指定日期)。
  • 指标 - ga:30dayUsers - 所请求时间段内每一天对应的过去 30 天内的活跃用户总数。要查询此指标,必须将 ga:nthDay、ga:date 或 ga:day 中至少一个指定为维度。在指定日期内,返回值将是过去 30 天内的唯一身份用户总数(截至指定日期)。

细分

这是一个问题修复版本;此版本修复了以下问题:在调用细分 list 方法时,会导致将非公开细分固定到多个数据视图(配置文件)的用户获得 500 错误响应。

此版本为 API 新增了一些指标。如需查看完整的定义列表,请参阅维度和指标参考

DoubleClick Ad Exchange (AdX)

  • 指标 - ga:adxCTR - 带来 AdX 广告点击的网页浏览量所占的百分比。
  • 指标 - ga:adxClicks - 用户在您的网站上点击 AdX 广告的次数。
  • 指标 - ga:adxCoverage - 覆盖率是指返回至少一个广告的广告请求数占广告请求总数的百分比。一般来说,通过覆盖率您可以确定 AdX 帐号在哪些网站上无法提供定位广告。(广告展示次数/广告请求总数)* 100
  • 指标 - ga:adxECPM - 有效每千次网页浏览费用,是指每 1,000 次网页浏览量的 AdX 收入。
  • 指标 - ga:adxImpressions - 在您的网站上每展示一个广告,系统就会报告一次 AdX 广告展示。例如,如果包含两个广告单元的网页获得一次浏览,我们就会显示两次广告单元展示。
  • 指标 - ga:adxImpressionsPerSession - AdX 广告展示次数与 Google Analytics(分析)会话次数的比率(广告展示次数/Google Analytics(分析)会话次数)。
  • 指标 - ga:adxMonetizedPageviews - 创收的网页浏览量,用于衡量与关联的 AdX 帐号中的广告一同展示的媒体资源所带来的网页浏览总数。注意:单个网页可以包含多个广告单元。
  • 指标 - ga:adxRevenue - AdX 广告带来的估算收入总额。
  • 指标 - ga:adxRevenuePer1000Sessions - 每 1,000 次 Google Analytics(分析)会话带来的 AdX 估算收入总额。请注意,此指标的计算依据是您网站的会话数而不是广告展示次数。
  • 指标 - ga:adxViewableImpressionsPercent - 可见广告展示次数占总广告展示次数的百分比。当广告显示在用户的浏览器中并可能会被用户看到时,我们就将这次展示视为一次可见的展示。

此版本向 Provisioning API TOS 网址新增了一个附加参数:

  • 新增的网址参数 provisioningSignup=false 修复了在为没有任何 Google Analytics(分析)帐号的用户配置 Google Analytics(分析)帐号时出现的问题。开发者应更新其代码,以将此参数添加到 TOS 网址。

批量处理

在此版本中,除了常规的批量处理支持之外,我们还新增了对 User Permissions API 的特殊支持。批量处理用户权限请求将获得显著的性能提升,同时减少了配额使用量。

数据视图(配置文件)

在此版本中,数据视图(配置文件)currency 属性现在默认为 USD(如果执行 insert 操作时未设置该属性)。此外,针对之前未使用 currency 属性创建的数据视图(配置文件)执行 getlist 操作也将返回 USD。

此版本弃用了现有维度或指标。如需查看完整的定义列表,请参阅维度和指标参考

已弃用的维度

以下维度已弃用。如需详细了解数据移除,请查看数据弃用政策

  • 维度 - ga:adSlotPosition - 请改用 ga:adSlot
  • 维度 - ga:nextPagePath - 请改用 ga:pagePath
  • 维度 - ga:nextContentGroupXX - 请改用 ga:contentGroupXX

在此版本中:

Google Analytics(分析)

  • 修复了在使用 setCampaignParametersFromUrl 时会导致崩溃的问题,即问题 636

Google 跟踪代码管理器

  • 没有变化。

过滤器

在此版本中,已弃用的过滤器字段 IS_MOBILEIS_TABLET 最终被移除,并应替换为 DEVICE_CATEGORY=mobileDEVICE_CATEGORY=tablet。将过滤器字段设置为使用 IS_MOBILEIS_TABLET 的 insert、update 和 patch 请求将返回错误。

在此版本中:

Google Analytics(分析)

  • 没有变化。

Google 跟踪代码管理器

此版本为 API 新增了一个维度。如需查看维度和指标的完整列表,请参阅维度和指标参考

AdWords

  • 维度 - ga:adQueryWordCount - 搜索查询中的字数。

过滤器

此版本新增了以下支持:向所有过滤器详细信息部分添加了 fieldIndex 属性,以便针对过滤器字段使用自定义维度。例如,现在可以使用 "field": "CUSTOM_DIMENSION""fieldIndex": "1" 设置过滤器表达式,以便针对第一个自定义维度进行过滤。

目标

此版本还解决了使用 "comparisonValue": "0" 创建目标会失败的问题。

  • 如需详细了解如何在 Management API 中使用目标,请参阅目标开发者指南

  • 如需查看目标资源的完整参数列表,请参阅目标参考

在此版本中:

Google Analytics(分析)

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

Google 跟踪代码管理器

  • 没有变化。

在此版本中:

Google Analytics(分析)

  • 在 iOS 8.0 及更高版本上使用 nativeBounds 时报告屏幕分辨率。这解决了问题 504
  • 新增了对于点击方面的广告系列参数的支持。
  • 除了设备操作系统版本之外,还报告 iOS 硬件型号。这解决了问题 408
  • 在 iOS 7.1 及更高版本上报告 iAd 安装归因工具。这需要 iAd 框架。
  • 新增了针对 appview 命中类型的弃用警告。
  • sqlite3 现在是必要库。

Google 跟踪代码管理器

  • 修复了 TAGDispatcher 中的 nil 字符串崩溃问题。

此版本新增了一个字段。如要了解完整的字段列表,请查看字段参考

传输

  • 借助传输字段,您可以设置发送命中所使用的机制。

其他更改

  • useBeacon 选项已弃用。
  • 问题修复

在此版本中:

Google Analytics(分析)

Google 跟踪代码管理器

  • 修复了几个小问题。

在此版本中,dailyUpload 资源最终被停用和移除。dailyUpload 资源已于 2014 年 6 月 20 日被正式弃用;所有费用数据导入现在均应使用“上传”资源完成。

此版本为 API 新增了一些维度。如需查看维度和指标的完整列表,请参阅维度和指标参考

平台或设备

  • 维度 - ga:dataSource - 命中的数据来源。从 ga.js 和 analytics.js 发送的命中在报告中显示为“web”,从移动 SDK 发送的命中在报告中显示为“app”。这些值可被替换。
  • 维度 - ga:searchAfterDestinationPage - 用户在您的网站上执行内部搜索后访问的网页。

这是一个问题修复版本:

  • 此版本修复了在 Real Time Reporting API 查询中强制执行过滤限制时出现的问题。发出 rt:activeUsers 请求并对事件一级维度进行过滤会导致错误,并返回 badRequest 原因和显示 OR operator not supported for a hit level filter 的消息。如需详细了解查询限制,请参阅 Real Time Reporting API 开发者指南

此版本新增了一个命中参数。如要了解完整的参数列表,请查看参数参考

数据源

  • 借助 ds 数据源参数,您可以设置相关命中的数据源。

此版本新增了一个字段。如要了解完整的字段列表,请查看字段参考

数据源

  • 借助数据源字段,您可以设置相关命中的数据源。

此版本新增了一个命中参数。如要了解完整的参数列表,请查看参数参考

地理位置替换

此版本为 API 新增了一些维度和指标,并弃用了两个现有指标。如需查看完整的定义列表,请参阅维度和指标参考

电子商务

  • 指标 - ga:transactionsPerUser - 总交易次数/用户总数。
  • 指标 - ga:revenuePerUser - 交易产生的销售收入总额(不含运费和税费)/用户总数。

用户

  • 指标 - ga:sessionsPerUser - 会话总数/用户总数。

地理位置网络

  • 维度 - ga:cityId - 用户所在城市的 ID,依据 IP 地址或地理位置 ID 得出。
  • 维度 - ga:countryIsoCode - 用户所在国家/地区的 ISO 代码,依据 IP 地址或地理位置 ID 得出。这些值以 ISO-3166-1 alpha-2 代码的形式提供。
  • 维度 - ga:regionId - 用户所在区域的 ID,依据 IP 地址或地理位置 ID 得出。在美国,区域是指某个州,如“纽约州”。
  • 维度 - ga:regionIsoCode - 用户所在区域的 ISO 代码,依据 IP 地址或地理位置 ID 得出。这些值以 ISO-3166-2 代码的形式提供。
  • 维度 - ga:subContinentCode - 用户所在次大陆的代码,依据 IP 地址或地理位置 ID 得出。例如,“波利尼西亚”或“北欧”。这些值以 UN M.49 代码的形式提供。

DoubleClick Campaign Manager

  • 指标 - ga:dcmROAS - DCM 广告支出回报率 (ROAS)(仅适用于 Premium 版)。

已弃用的指标

以下指标已弃用。如需详细了解数据移除,请查看数据弃用政策:弃用了指标 - ga:dcmROI - 请改用 ga:dcmROAS。弃用了指标 - ga:dcmMargen - 请改用 ga:dcmROAS

现在,所有集合的 list 方法响应中均包含 items 属性的空列表(如果集合中未包含任何资源)。之前,系统会从响应中省略 items 属性。如需详细了解 Google Analytics(分析)配置数据的查询和响应,请参阅 API 参考文档

新增了 DEVICE_CATEGORY 过滤器字段;IS_MOBILEIS_TABLET 现已弃用。请使用 DEVICE_CATEGORY=mobileDEVICE_CATEGORY=tablet

在此版本中:

Google Analytics(分析)

  • 修复了在调度信标时无法发送所有信标的问题。
  • 更新了 CuteAnimals 示例应用,以便演示应用转入后台时如何调度。
  • 新增了对其他增强型电子商务字段的支持。
  • 移除了在针对 iOS SDK 8.0 进行编译时发出的、有关 GAIHit 和 GAIProperty 类缺失的警告消息;移除了以上类。
  • 现在可在单个 HTTPS 请求中调度多个信标,信标的调度效率更高了。
  • 在某些情况下,会压缩请求以节省流量套餐使用量。

Google 跟踪代码管理器

  • 弃用了基于 TAGContainerFuture 的 openContainerWithId。如果在 UIAppDelegate 生命周期的一些阶段调用 get,则在 iOS8 上使用此 API 会引发错误。
  • 新增了对 Google Universal Analytics 代码的增强型电子商务的自定义指标和自定义维度的支持。
  • 修复了已有可选产品的增强型电子商务操作仍要求提供产品的问题。
  • 支持在 Google Universal Analytics 代码上使用广告 ID 功能。
  • 更新了 CuteAnimals 示例应用,以演示如何在应用转入后台时发送数据。

数据视图(配置文件)资源现在包含 enhancedECommerceTracking 属性,该属性可指明增强型电子商务是已启用 (true) 还是已停用 (false)。

此版本为 API 新增了一个指标,并弃用了两个现有指标。如需查看完整的定义列表,请参阅维度和指标参考

AdWords

  • 指标 - ga:ROAS - 广告支出回报率 (ROAS) 是指交易收入总额和目标价值之和除以产生的广告费用得出的比率。

已弃用的维度和指标

以下维度和指标已弃用。如需详细了解数据移除,请查看数据弃用政策:弃用了指标 - ga:ROI - 请改用 ga:ROAS。弃用了指标 - ga:margin - 请改用 ga:ROAS

此版本新增了一个维度。如需查看完整的定义列表,请参阅维度和指标参考

时间

  • 维度 - rt:minutesAgo - 命中发生后经过的分钟数。

此版本为 API 新增了一些指标。如需查看完整的定义列表,请参阅维度和指标参考

AdSense

  • 指标 - ga:adsenseCoverage - 返回至少一个广告的广告请求数占广告请求总数的百分比。
  • 指标 - ga:adsenseViewableImpressionPercent - 可见展示次数占总展示次数的百分比。

在此版本中:

Google Analytics(分析)

  • 修复了几个小问题。

Google 跟踪代码管理器

此版本为 API 新增了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考

转化路径

  • 维度 - mcf:dcmAd - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 广告名称。
  • 维度 - mcf:dcmAdPath - 转化路径,其中的互动通过 DCM 广告体现。
  • 维度 - mcf:dcmAdType - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 广告类型名称。
  • 维度 - mcf:dcmAdvertiser - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 广告客户名称。
  • 维度 - mcf:dcmAdvertiserPath - 转化路径,其中的互动通过 DCM 广告客户体现。
  • 维度 - mcf:dcmCampaign - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 广告系列名称。
  • 维度 - mcf:dcmCampaignPath - 转化路径,其中的互动通过 DCM 广告系列体现。
  • 维度 - mcf:dcmCreative - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 广告素材名称。
  • 维度 - mcf:dcmCreativePath - 转化路径,其中的互动通过 DCM 广告素材体现。
  • 维度 - mcf:dcmCreativeVersion - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 广告素材版本。
  • 维度 - mcf:dcmCreativeVersionPath - 转化路径,其中的互动通过 DCM 广告素材版本体现。
  • 维度 - mcf:dcmNetwork - 使用的广告网络。
  • 维度 - mcf:dcmPlacement - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 网站展示位置名称。
  • 维度 - mcf:dcmPlacementPath - 转化路径,其中的互动通过 DCM 展示位置体现。
  • 维度 - mcf:dcmSite - 与 Google Analytics(分析)转化匹配的 DCM 事件(展示或点击)所对应的 DCM 网站(DCM 广告素材展示在其中)名称。
  • 维度 - mcf:dcmSitePath - 转化路径,其中的互动通过 DCM 网站体现。
  • 指标 - mcf:firstImpressionConversions - DCM 广告系列展示是 30 天回溯期内发生的首次转化互动时的转化次数。该维度同时包含目标达成次数和交易次数。
  • 指标 - mcf:firstImpressionValue - DCM 广告系列展示是 30 天回溯期内发生的首次转化互动时的转化价值。该维度同时包含目标达成次数和交易次数。
  • 指标 - mcf:impressionAssistedConversions - DCM 广告系列展示出现在转化路径上但并非最终转化互动时的转化次数。该维度同时包含目标达成次数和交易次数。
  • 指标 - mcf:impressionAssistedValue - DCM 广告系列展示出现在转化路径上但并非最终转化互动时的转化价值。该维度同时包含目标达成次数和交易次数。

此版本新增了一个会话指标、一个流量来源维度以及 DoubleClick Campaign Manager 维度和指标。

维度和指标

如需查看完整的定义列表,请参阅维度和指标参考

会话

  • 指标 - ga:hits - 发送到 Google Analytics(分析)的命中总数。该指标汇总了所有命中类型(例如,网页浏览、事件、计时等)。

流量来源

  • 维度 - ga:campaignCode - utm_id 广告系列跟踪参数的值(使用人工广告系列跟踪时)。

DoubleClick Campaign Manager

  • 维度 - ga:dcmClickAd - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 广告名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickAdId - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 广告 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickAdType - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 广告类型名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickAdTypeId - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 广告类型 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickAdvertiser - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 广告客户名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickAdvertiserId - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 广告客户 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickCampaign - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 广告系列名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickCampaignId - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 广告系列 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickCreative - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 广告素材名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickCreativeId - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 广告素材 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickCreativeType - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 广告素材类型名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickCreativeTypeId - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 广告素材类型 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickCreativeVersion - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 广告素材版本(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickRenderingId - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 呈现 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickSite - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的网站(DCM 广告素材在其中展示并带来了点击)名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickSiteId - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 网站(DCM 广告素材在其中展示并带来了点击)ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickSitePlacement - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 网站展示位置名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickSitePlacementId - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM 网站展示位置 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmClickSpotId - 与 Google Analytics(分析)会话匹配的 DCM 点击所对应的 DCM Floodlight 配置 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmFloodlightActivity - 与 Floodlight 转化相关联的 DCM Floodlight 活动名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmFloodlightActivityAndGroup - 与 Floodlight 转化相关联的 DCM Floodlight 活动名称和组名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmFloodlightActivityGroup - 与 Floodlight 转化相关联的 DCM Floodlight 活动组名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmFloodlightActivityGroupId - 与 Floodlight 转化相关联的 DCM Floodlight 活动组 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmFloodlightActivityId - 与 Floodlight 转化相关联的 DCM Floodlight 活动 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmFloodlightAdvertiserId - 与 Floodlight 转化相关联的 DCM Floodlight 广告客户 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmFloodlightSpotId - 与 Floodlight 转化相关联的 DCM Floodlight 配置 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventAd - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 广告名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventAdId - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 广告 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventAdType - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 广告类型名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventAdTypeId - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 广告类型 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventAdvertiser - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 广告客户名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventAdvertiserId - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 广告客户 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventAttributionType - 有两个可能的值:ClickThrough 和 ViewThrough。如果与 Google Analytics(分析)会话关联的 DCM 最终事件为点击,则该值为 ClickThrough。如果与 Google Analytics(分析)会话关联的 DCM 最终事件为广告展示,则该值为 ViewThrough(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventCampaign - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 广告系列名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventCampaignId - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 广告系列 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventCreative - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 广告素材名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventCreativeId - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 广告素材 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventCreativeType - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 广告素材类型名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventCreativeTypeId - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 广告素材类型 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventCreativeVersion - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 广告素材版本(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventRenderingId - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 呈现 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventSite - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的网站(DCM 广告素材在其中展示并带来了点击)名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventSiteId - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 网站(DCM 广告素材在其中展示并带来了点击)ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventSitePlacement - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 网站展示位置名称(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventSitePlacementId - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM 网站展示位置 ID(仅适用于 Premium 版)。
  • 维度 - ga:dcmLastEventSpotId - 与 Google Analytics(分析)会话相关联的 DCM 最终事件(DCM 回溯期内发生的展示或点击)所对应的 DCM Floodlight 配置 ID(仅适用于 Premium 版)。
  • 指标 - ga:dcmFloodlightQuantity - DCM Floodlight 转化次数(仅适用于 Premium 版)。
  • 指标 - dcmFloodlightRevenue - DCM Floodlight 收入(仅适用于 Premium 版)。

在此版本中:

Google Analytics(分析)

  • 没有变化。

Google 跟踪代码管理器

  • Google Universal Analytics 代码中新增了增强型电子商务支持。
  • TAGManager 类中新增了 dispatchdispatchWithCompletionHandler 方法。

此版本新增了内容分组维度和指标。

维度和指标

如需查看完整的定义列表,请参阅维度和指标参考

内容分组

  • 维度 - ga:landingContentGroupXX - 用户会话中的第一个匹配内容组。
  • 维度 - ga:nextContentGroupXX - 是指在访问其他内容组之后访问的内容组。
  • 维度 - ga:contentGroupXX - 媒体资源上的内容组。内容组是指一类内容的集合,内容组可以体现由跟踪代码或网页标题/网址正则表达式匹配或者预定义规则所决定的逻辑结构。
  • 维度 - ga:previousContentGroupXX - 是指在访问其他内容组之前访问的内容组。
  • 指标 - ga:contentGroupUniqueViewsXX - 一次会话内指定内容组中不同(非重复)网页的数量。要确定网页是否重复,需要同时考虑 pagePath 和 pageTitle。

在此版本中:

Google Analytics(分析)

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

Google 跟踪代码管理器

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

在此版本中:

Google Analytics(分析)

  • 如果应用中随附了(作为 SDK 的一部分提供的)库 libAdIdAccess.a,且已在跟踪器上将 allowIDFACollection 属性设置为 true,那么,SDK 现在将收集 IDFA 和广告客户跟踪所启用的标记。
  • 新增了增强型电子商务支持。
  • 新增了 screenview 命中类型,用于替换 appview 命中类型。
  • 现在为每个命中新增了命中 ID 参数。每次生成 appview、screenview 或 pageview 命中时,该参数都会更改。
  • 现在每次更改 IDFA 值时,ClientId 都会重置。但只会在跟踪器中收集 IDFA 时才出现这种情况。
  • GAI 类中新增了 dispatchWithCompletionHandler 方法。
  • 修复了 SDK 可能在没有 clientId 或 clientId 为空的情况下发送信标的问题。

Google 跟踪代码管理器

  • 没有变化。
  • 现已弃用所有不包含有效跟踪 ID 的命中。

此版本新增了数据导入类型,并弃用了 dailyUpload 资源。

数据导入

如需详细了解如何使用 Management API 将数据导入 Google Analytics(分析)帐号,请参阅数据导入开发者指南

上传

  • upload 资源现在支持以下上传类型:
    • 广告系列数据
    • 内容数据
    • 费用数据
    • 产品数据
    • 退款数据
    • 用户数据
  • upload 资源新增了 migrateDataImport 方法,用于迁移现有的费用数据 customDataSources

弃用“每日上传”

  • dailyUpload 资源现已弃用!如需详细了解如何改用数据导入功能,请参阅迁移指南
  • dailyUpload 资源将于 6 个月后停用,届时将 uploadType 设置为 analytics#dailyUploads 的任何剩余 customDataSources 均将自动迁移且仅可使用 upload 资源。
  • dailyUpload 资源的现有用户应尽快更新其代码并改用“上传”资源。

此版本为细分功能新增了 dateOfSession 条件,并新增了增强型电子商务维度和指标。

细分

细分功能现在支持新增的 dateOfSession 条件,该条件可以将某个细分限制为在特定日期范围内发起了会话的一组用户。如需了解详情,请参阅细分开发者指南

维度和指标

如需查看增强型电子商务的完整定义列表,请参阅维度和指标参考

增强型电子商务

  • 维度 - ga:internalPromotionCreative - 专为推广活动设计的广告素材内容。
  • 维度 - ga:internalPromotionId - 用于推广活动的 ID。
  • 维度 - ga:internalPromotionName - 推广活动的名称。
  • 维度 - ga:internalPromotionPosition - 网页或应用屏幕上推广活动的展示位置。
  • 维度 - ga:orderCouponCode - 订单级优惠券代码。
  • 维度 - ga:productBrand - 产品销售时采用的品牌名称。
  • 维度 - ga:productCategoryHierarchy - 产品所属的层次结构类别(增强型电子商务)。
  • 维度 - ga:productCategoryLevelXX - 产品类别层次结构中的级别 (1-5),从最高级别开始。
  • 维度 - ga:productCouponCode - 产品级优惠券代码。
  • 维度 - ga:productListName - 产品所在产品列表的名称。
  • 维度 - ga:productListPosition - 产品在产品列表中的位置。
  • 维度 - ga:productVariant - 产品的特定款式,例如,尺码(XS、S、M、L 等)或颜色(红色、蓝色、绿色、黑色等)。
  • 维度 - ga:checkoutOptions - 在结账过程中指定的用户选项,例如,送货选项(FedEx、DHL、UPS 等)和支付选项(Visa、MasterCard、AmEx 等)。此维度应该在购物阶段使用。
  • 维度 - ga:shoppingStage - 用户在一次会话中完成的购物体验的各个阶段,例如,PRODUCT_VIEW、ADD_TO_CART、CHECKOUT 等。
  • 指标 - ga:internalPromotionCTR - 用户点击查看内部推广活动的比率(点击次数/推广活动展示次数)。
  • 指标 - ga:internalPromotionClicks - 内部推广活动获得的点击次数。
  • 指标 - ga:internalPromotionViews - 内部推广活动获得的浏览次数。
  • 指标 - ga:localProductRefundAmount - 指定产品的退款金额(本地货币)。
  • 指标 - ga:localRefundAmount - 交易的退款总金额(本地货币)。
  • 指标 - ga:productAddsToCart - 产品被添加到购物车的次数。
  • 指标 - ga:productCheckouts - 产品在结账过程中被添加的次数。
  • 指标 - ga:productDetailViews - 用户浏览产品详情页面的次数。
  • 指标 - ga:productListClicks - 产品出现在产品列表中时,用户点击相应产品的次数。
  • 指标 - ga:productListViews - 产品出现在产品列表中的次数。
  • 指标 - ga:productListCTR - 用户点击浏览产品列表中产品的比率。
  • 指标 - ga:productRefunds - 发起产品退款的次数。
  • 指标 - ga:productRefundAmount - 与产品相关的退款总金额。
  • 指标 - ga:productRemovesFromCart - 产品被移出购物车的次数。
  • 指标 - ga:productRevenuePerPurchase - 每次购买(通常搭配使用产品优惠券代码)带来的平均产品收入。
  • 指标 - ga:buyToDetailRate - 唯一身份购买次数/产品详情页面浏览次数。
  • 指标 - ga:cartToDetailRate - 产品被添加到购物车的次数/产品详情浏览次数。
  • 指标 - ga:quantityAddedToCart - 添加到购物车的产品数量。
  • 指标 - ga:quantityCheckedOut - 结账时添加的产品数量。
  • 指标 - ga:quantityRefunded - 退款产品数量。
  • 指标 - ga:quantityRemovedFromCart - 从购物车中移除的产品数量。
  • 指标 - ga:refundAmount - 针对某笔交易退还的货币金额。
  • 指标 - ga:totalRefunds - 已发起的退款次数。

此版本修复了列标题名称方面的错误,并新增了一些维度和指标。

维度和指标

如需查看完整的定义列表,请参阅维度和指标参考

系统

  • 维度 - ga:sourcePropertyDisplayName - 总览媒体资源的来源媒体资源显示名。此维度仅适用于总览媒体资源。
  • 维度 - ga:sourcePropertyTrackingId - 总览媒体资源的来源媒体资源跟踪 ID。此维度仅适用于总览媒体资源。

渠道分组

  • 维度 - ga:channelGrouping - 在数据视图(配置文件)内共享的默认渠道分组。
  • 维度 - ga:correlationModelId - 相关产品的相关模型 ID。
  • 维度 - ga:queryProductId - 要查询的产品的 ID。
  • 维度 - ga:queryProductName - 要查询的产品的名称。
  • 维度 - ga:queryProductVariation - 要查询的产品的款式。
  • 维度 - ga:relatedProductId - 相关产品的 ID。
  • 维度 - ga:relatedProductName - 相关产品的名称。
  • 指标 - ga:relatedProductVariation - 相关产品的款式。
  • 指标 - ga:correlationScore - 相关产品的相关性分数。
  • 指标 - ga:queryProductQuantity - 要查询的产品的数量。
  • 指标 - ga:relatedProductQuantity - 相关产品的数量。

更正列标题名称

  • 2014-04-16 版本中存在一个错误;如果您查询已弃用的维度或指标,API 会返回带有替换维度或指标的列标题。现在,该 API 会正确返回请求中所用的相同维度或指标名称。

此版本更改了 uiName 属性的命名惯例。

更改 uiName

  • 现在,模板化列的 uiName 属性使用 XX(而非 1)来表示数字索引。例如,Goal 1 Value 现为 Goal XX Value

这是 Embed API 的初始版本:

  • Google Analytics(分析)Embed API 是一个 JavaScript 库。利用它,您只需几分钟的时间即可轻松创建信息中心并将其嵌入第三方网站。如需了解详情,请参阅 Embed API 概览
  • 新增了以下组件:auth、view selector、data 和 data chart。

这是 Provisioning API 的初始版本:

  • Provisioning API 可用于以编程方式创建新的 Google Analytics(分析)帐号。此 API 专供符合条件的服务提供商和大型合作伙伴使用(仅限受邀者)。如需了解详情,请参阅 Provisioning API 概览

此版本新增了两个配置 API。

  • 利用 Management API 中的 AdWords 关联功能,您可以创建、列出、获取、更新、修补和删除 AdWords 帐号与 Google Analytics(分析)媒体资源间的关联,以及管理要将哪些数据视图(配置文件)与 AdWords 数据相关联。

过滤器

非抽样报告:Management API

Management API 中新增了一种名为非抽样报告的资源。非抽样报告是一种利用非抽样数据生成的 Google Analytics(分析)(GA) 报告。非抽样报告目前仅面向 Google Analytics Premium 用户提供。

  • 更新了受支持自然来源的列表。

    • 移除了:Netscape、About、Mamma、Voila、Live、Wirtulana Polska、Yam、Ozu。
    • 新增了/更新了:百度、DOCOMO、Onet、Centrum、Sogou、Tut.By、Globo、Ukr.net、So.com、au one。
  • 更新了受支持自然来源的列表。

    • 移除了:Netscape、About、Mamma、Voila、Live、Wirtulana Polska、Yam、Ozu。
    • 新增了/更新了:百度、DOCOMO、Onet、Centrum、Sogou、Tut.By、Globo、Ukr.net、So.com、au one。

在此版本中:

Google Analytics(分析)

  • 新增了用户 ID 字段。

Google 跟踪代码管理器

  • 修复了广告宏 ID 方面的问题,以便它可以正确返回广告客户标识符 (IDFA)(如有)。
  • 修复了一个问题,以便用户可以将 NSNumber 用于电子商务数据。

此版本弃用了 appUiName 属性。如需详细了解属性移除,请查看数据弃用政策

弃用 appUiName

  • appUiName 已弃用。网站数据视图和应用数据视图(配置文件)的界面名称已统一,因此 Metadata API 不再需要该属性。您应移除所有使用 appUiName 属性的代码,仅使用 uiName 属性。

此版本重命名了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考

重命名的维度和指标

重命名了以下维度和指标。如需详细了解数据重命名,请查看数据弃用政策

用户

  • 维度 - rt:visitorType - 请改用 rt:userType
  • 指标 - rt:activeVisitors - 请改用 rt:activeUsers

此版本新增并重命名了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考

新维度和指标

Core Reporting API 中新增了以下维度:

AdWords

  • 维度 - ga:isTrueViewVideoAd - YesNo - 指明广告是否为 AdWords TrueView 视频广告。

时间

  • 维度 - ga:nthHour - 指定日期范围内各小时所对应的索引。指定日期范围内第一天(即开始日期)第一个小时所对应的索引为 0,1 表示下一个小时,以此类推。

重命名的维度和指标

所有基于访问者访问的维度和指标已重命名,分别改用用户会话

重命名了以下维度和指标。如需详细了解数据重命名,请查看数据弃用政策

受众群体

  • 维度 - ga:visitorAgeBracket - 请改用 ga:userAgeBracket
  • 维度 - ga:visitorGender - 请改用 ga:userGender

电子商务

  • 指标 - ga:transactionRevenuePerVisit - 请改用 ga:transactionRevenuePerSession
  • 指标 - ga:transactionsPerVisit - 请改用 ga:transactionsPerSession

事件跟踪

  • 指标 - ga:eventsPerVisitWithEvent - 请改用 ga:eventsPerSessionWithEvent
  • 指标 - ga:visitsWithEvent - 请改用 ga:sessionsWithEvent

目标转化次数

  • 指标 - ga:goalValuePerVisit - 请改用 ga:goalValuePerSession
  • 指标 - ga:percentVisitsWithSearch - 请改用 ga:percentSessionsWithSearch
  • 指标 - ga:searchVisits - 请改用 ga:searchSessions

网页跟踪

  • 指标 - ga:pageviewsPerVisit - 请改用 ga:pageviewsPerSession

会话

  • 维度 - ga:visitLength - 请改用 ga:sessionDurationBucket
  • 指标 - ga:avgTimeOnSite - 请改用 ga:avgSessionDuration
  • 指标 - ga:timeOnSite - 请改用 ga:sessionDuration
  • 指标 - ga:visitBounceRate - 请改用 ga:bounceRate
  • 指标 - ga:visits - 请改用 ga:sessions

社交互动

  • 维度 - ga:socialInteractionNetworkActionVisit - 请改用 ga:socialInteractionNetworkActionSession
  • 指标 - ga:socialInteractionsPerVisit - 请改用 ga:socialInteractionsPerSession

用户

  • 维度 - ga:daysSinceLastVisit - 请改用 ga:daysSinceLastSession
  • 维度 - ga:visitCount - 请改用 ga:sessionCount
  • 维度 - ga:visitorType - 请改用 ga:userType
  • 维度 - ga:visitsToTransaction - 请改用 ga:sessionsToTransaction
  • 指标 - ga:newVisits - 请改用 ga:newUsers
  • 指标 - ga:percentNewVisits - 请改用 ga:percentNewSessions
  • 指标 - ga:visitors - 请改用 ga:users

此版本替换了 appview 命中类型,并新增和重命名了一些参数。如要了解完整的参数列表,请查看参数参考

替换 appview

  • appview 命中类型已替换为 screenview。请尽快更新您的应用跟踪代码,以使用 screenview 而不是 appview

新参数

重命名参数

  • 内容说明已更名为屏幕名称。查询参数名称 cd 将保持不变。

此版本替换了 appview 命中类型,并新增了一些字段。如要了解完整的字段列表,请查看字段参考

替换 appview

  • appview 命中类型已替换为 screenview。请尽快更新您的应用跟踪代码,以使用 screenview 而不是 appview

新字段

  • 屏幕名称 - 即页面/屏幕的名称。如果未设置,则默认为页面网址(如果是网站)或屏幕 ID(如果是应用)。
  • 应用 ID - 即应用标识符。
  • 应用安装程序 ID - 即应用安装程序的标识符。

其他更改

  • 改进了调试输出。
  • 修复了各种预呈现问题。
  • 新增了对于不带前缀的预呈现 API 的支持。除了 Chrome 之外,现在也可以在 IE11 中使用预呈现。
  • 修复了链接器支持中的其他小问题。
  • 现已正确地将 Yahoo 安全搜索归类为自然来源。
  • 新增了对于不带前缀的预呈现 API 的支持。除了 Chrome 之外,现在也可以在 IE11 中使用预呈现。

细分:Core Reporting API v2.4 和 Core Reporting API v3.0

Core Reporting API 中新增了细分支持。

  • segment 参数现在支持用户细分和顺序细分。在网页界面中创建的用户级会话级细分可通过 segment 参数查询。
  • 新增了一个动态细分语法,可与 segment 参数一起使用。如需了解详情,请参阅细分开发者指南
  • dynamic:: 前缀已弃用。建议您尽快改用新语法。

细分:Management API v2.4 和 Management API v3.0

细分集合进行了以下变更:

  • API 现在支持用户细分和顺序细分。
  • 现在,“细分集合”会返回所有内置和自定义的会话级用户级细分。
  • 细分的 definition 属性将开始使用新的细分语法,其中包括现有会话级细分的定义,这些定义将从 definition: "" 变更为 definition: "sessions::condition::"
  • 细分资源中新增了 type 属性,用于指明细分是 CUSTOM(即由用户在网页界面中创建)还是 BUILT_IN(即由 Google Analytics(分析)提供)。

实验

以下 AdSense 指标现在可以用作优化目标:

  • ga:adsenseAdsClicks - 用户在您的网站上点击 AdSense 广告的次数。
  • ga:adsenseAdsViewed - AdSense 广告浏览量。一个广告单元中可展示多个广告。
  • ga:adsenseRevenue - AdSense 广告带来的总收入。

新增了“帐号摘要”集合

  • Management API 中新增了 AccountSummaries 集合。该集合提供了授权用户在一个简单快速的请求中有权访问的每个帐号、媒体资源和数据视图(配置文件)的相关信息摘要。如需了解详情,请参阅帐号摘要开发者指南

弃用了 ga: 前缀

所有实时维度和指标现已弃用 ga: 前缀,并替换为新的 rt: 前缀。ga: 前缀将于 6 个月后停用,之后使用该前缀发出 API 请求将返回错误。

新维度和指标

此更新为 Real Time Reporting API 新增了一些维度和指标。如需查看完整的列表,请参阅维度和指标参考

事件跟踪

  • 维度 - rt:eventAction - 事件的操作。
  • 维度 - rt:eventCategory - 事件的类别。
  • 维度 - rt:eventLabel - 事件的标签。
  • 维度 - rt:totalEvents - 配置文件的事件总数(针对所有类别)。

目标跟踪

  • 维度 - rt:goalId - 与目标 ID 相对应的字符串。
  • 指标 - rt:goalXXValue - 所请求目标数的总数值,其中 XX 为介于 1 到 20 之间的数字。
  • 指标 - rt:goalValueAll - 为您的配置文件指定的所有目标的总数值。
  • 指标 - rt:goalXXCompletions - 所请求目标数的总达成次数,其中 XX 为介于 1 到 20 之间的数字。
  • 指标 - rt:goalCompletionsAll - 为您的配置文件指定的所有目标的总达成次数。

网页跟踪

  • 指标 - rt:pageViews - 网页浏览总量。

应用跟踪

  • 指标 - rt:screenViews - 屏幕浏览总量。

在此版本中:

Google Analytics(分析)

  • SDK 现在将默认填充应用 ID 参数 (&aid)。

Google 跟踪代码管理器

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

在此版本中:

Google Analytics(分析)

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

Google 跟踪代码管理器

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

在此版本中:

Google Analytics(分析)

  • 没有直接更改 Google Analytics(分析)。Google Analytics(分析)用户应该注意,Google 跟踪代码管理器默认情况下不再依赖于 AdSupport.framework。这可能会有助于解决问题 387

Google 跟踪代码管理器

  • 调用 AdSupport.framework API 的函数已细分为单独的库 libAdIdAccess.a。应用需要与该库相关联,才能访问广告标识符 (IDFA) 字符串和广告客户跟踪所启用的标记。

此版本为 API 新增了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考

转化路径

  • 维度 - mcf:adwordsCustomerIDPath - 转化路径中 AdWords 客户 ID 的顺序。

互动

  • 维度 - mcf:adwordsCustomerID - 对应于 AdWords API Customer.id
  • 在 Firefox 中以不同缩放级别进行跨网域导航时,将不再忽略链接器参数
  • 修复了无法在某些网址上加载网页内分析的问题。
  • 改进了调试模式输出。
  • 维护版本。

在此版本中:* 去掉了对 AdSupport.framework 的需求。* 移除了没有使用的代码。

在此版本中:* 新增了对 64 位 iOS 7.0 SDK 的支持。* 移除了 libGoogleAnalytics_debug.a,它是 libGoogleAnalyticsServices.a 库的一部分。* 清理了 Google Analytics(分析)的 CuteAnimals 构建文件。

此版本为 API 新增了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考

转化路径

  • 维度 - mcf:adwordsAdGroupIDPath - 转化路径中 AdWords 广告组 ID 的顺序。
  • 维度 - mcf:adwordsCampaignIDPath - 转化路径中 AdWords 广告系列 ID 的顺序。
  • 维度 - mcf:adwordsCreativeIDPath - 转化路径中 AdWords 广告素材 ID 的顺序。
  • 维度 - mcf:adwordsCriteriaIDPath - 转化路径中 AdWords 条件 ID 的顺序。

互动

  • 维度 - mcf:adwordsAdGroupID - 对应于 AdWords API AdGroup.id
  • 维度 - mcf:adwordsCampaignID - 对应于 AdWords API Campaign.id
  • 维度 - mcf:adwordsCreativeID - 对应于 AdWords API Ad.id
  • 维度 - mcf:adwordsCriteriaID - 对应于 AdWords API Criterion.id

此版本新增了一种数据表响应格式,并新增和弃用了一些维度和指标(如需查看完整的定义列表,请参阅维度和指标参考)。

数据表输出

为了让您更轻松地利用 Google 图表可视化功能呈现 Google Analytics(分析)数据,API 可以选择在响应中返回数据表对象。

  • API 中新增了一个可选的 output 查询参数。该参数可用于在响应中选择 Google Analytics(分析)数据的输出格式(默认为 JSON)。如果设置为 datatable,包含数据表对象的 dataTable 属性会包含在响应中。此对象可以直接用于 Google 图表。如需了解详情,请参阅 Core Reporting API 参考文档

新维度和指标

Core Reporting API 中新增了以下维度和指标:

时间

  • 维度 - ga:minute - 返回一小时内的具体分钟。可能的值介于 0059 之间。
  • 维度 - ga:nthMinute - 指定日期范围内各分钟所对应的索引。指定日期范围内第一天(即开始日期)第一分钟所对应的索引为 01 表示下一分钟,以此类推。

受众群体

  • 维度 - ga:visitorAgeBracket - 访问者所在的年龄段。
  • 维度 - ga:visitorGender - 访问者的性别。
  • 维度 - ga:interestAffinityCategory - 指明用户更有可能有兴趣了解特定类别。
  • 维度 - ga:interestInMarketCategory - 指明用户更有可能已经准备好购买特定类别的产品或服务。
  • 维度 - ga:interestOtherCategory - 指明用户更有可能有兴趣了解特定类别,且更有可能做好购买准备。

允许在细分中使用的维度和指标

这些维度和指标现可用于细分:

  • 维度 - ga:sourceMedium - ga:sourcega:medium 的组合值。
  • 指标 - ga:localItemRevenue - 产品收入(本地货币)。

已弃用的维度和指标

以下维度和指标已弃用。如需详细了解数据移除,请查看数据弃用政策

  • 维度 - ga:isMobile - 请改用 ga:deviceCategory(例如,ga:deviceCategory==mobile)。
  • 维度 - ga:isTablet - 请改用 ga:deviceCategory(例如,ga:deviceCategory==tablet)。
  • 指标 - ga:entranceBounceRate - 请改用 ga:visitBounceRate

由于 ga:isMobilega:isTablet 维度已弃用,因此对默认细分进行了以下变更:

  • 细分 gaid::-11 已从移动设备流量 (Mobile Traffic) 更名为手机和平板电脑流量 (Mobile and Tablet Traffic)。此细分的定义已从 ga:isMobile==Yes 更改为 ga:deviceCategory==mobile,ga:deviceCategory==tablet。请注意,ga:isMobile 之前便包含平板电脑流量,这一点在新定义中得到体现。如果您只想要手机流量而不需要平板电脑流量,可改用新的移动设备流量细分 (gaid::-14)。
  • 细分 gaid::-13 的定义已从 ga:isTablet==Yes 更改为 ga:deviceCategory==tablet。此细分仍表示平板电脑流量
  • 新增了细分 gaid::-14。该细分的名称为移动设备流量 (Mobile Traffic),定义为 ga:deviceCategory==mobile
  • 维护版本。

此版本为 API 新增了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考

AdSense

  • 新增了对 AdSense 数据的访问权限:

    • 指标 - ga:adsenseRevenue - AdSense 广告带来的总收入。
    • 指标 - ga:adsenseAdUnitsViewed - AdSense 广告单元浏览次数。广告单元是指在同一段 AdSense 广告代码的作用下显示出来的一组广告。详细信息:https://support.google.com/adsense/answer/32715
    • 指标 - ga:adsenseAdsViewed - AdSense 广告浏览量。一个广告单元中可展示多个广告。
    • 指标 - ga:adsenseAdsClicks - 用户在您的网站上点击 AdSense 广告的次数。
    • 指标 - ga:adsensePageImpressions - AdSense 广告展示期间获得的网页浏览量。一次网页展示可包含多个广告单元。
    • 指标 - ga:adsenseCTR - 带来 AdSense 广告点击的网页展示次数所占的百分比。(ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • 指标 - ga:adsenseECPM - 每千次网页展示的估算费用,是指每 1,000 次网页展示的 AdSense 收入。(ga:adsenseRevenue/(ga:adsensePageImpressions/1000)。
    • 指标 - ga:adsenseExits - 因用户点击 AdSense 广告而结束的会话的数量。

时间

  • 维度 - ga:isoYear - 访问发生的年份(ISO 年份格式)。详细信息:http://zh.wikipedia.org/wiki/ISO_week_datega:isoYear 应仅与 ga:isoWeek 搭配使用,因为 ga:week 表示公历。
  • 维度 - ga:isoYearIsoWeek - ga:isoYearga:isoWeek 的组合值。

AdWords

  • 此类数据显示在 AdWords 报告中:

    • 维度 - ga:adKeywordMatchType - 您的关键字所采用的匹配类型(词组匹配、完全匹配、广泛匹配)。详细信息:了解搜索字词报告

修复了以下问题:

  • 修复了数据视图(配置文件)的时区信息问题。详细信息:修复此问题之前,在某些情况下,如果在 Management API 中列出数据视图(配置文件),则系统会返回错误的数据视图(配置文件)时区信息。现在,数据视图(配置文件)的时区信息与 Google Analytics(分析)管理界面中设置的信息一致。

在此版本中:* 解决了与协议缓冲区 SDK 的冲突。* 修复了启用代码删除时出现的链接器错误。

新增了“样本规模控制”和“相对日期”功能

相对日期
  • MCF Reporting API 中新增了对相对日期的支持。todayyesterdayNdaysAgo 现在是 start-dateend-date 查询参数的有效值。
  • 采用这些值后,系统会根据查询时的当前日期,以及查询中指定的数据视图(配置文件)时区,自动确定日期范围。如需了解详情,请参阅 API 参考文档
抽样级别
  • 此版本引入了一个新参数 samplingLevel,利用该参数,您可以为报告查询设置抽样级别(即用于计算结果的访问次数)。允许的值包括:DEFAULTFASTERHIGHER_PRECISION
  • API 响应中新增了 2 个字段:sampleSizesampleSpace。您可以使用这些值来计算用于抽样响应的访问次数所占的百分比。
  • 如需了解详情,请参阅 API 参考文档抽样

新增了“样本规模控制”和“相对日期”功能

相对日期
  • Core Reporting API 中新增了对相对日期的支持。todayyesterdayNdaysAgo 现在是 start-dateend-date 查询参数的有效值。
  • 采用这些值后,系统会根据查询时的当前日期,以及查询中指定的数据视图(配置文件)时区,自动确定日期范围。如需了解详情,请参阅 API 参考文档
抽样级别
  • 此版本引入了一个新参数 samplingLevel,利用该参数,您可以为报告查询设置抽样级别(即用于计算结果的访问次数)。允许的值包括:DEFAULTFASTERHIGHER_PRECISION
  • API 响应中新增了 2 个字段:sampleSizesampleSpace。您可以使用这些值来计算用于抽样响应的访问次数所占的百分比。
  • 如需了解详情,请参阅 API 参考文档抽样

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

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

此版本针对网络媒体资源、数据视图(配置文件)和目标资源引入了写入操作,并新增了一组包含 3 个支持用户权限管理的资源。

帐号设置和配置 API

  • 现在可以创建、更新、修补和删除数据视图(配置文件)。如需详细了解新增的方法,请参阅数据视图(配置文件)参考
  • 现在可以创建、更新和修补网站媒体资源和目标。如需详细了解新增的方法,请参阅网络媒体资源参考目标参考
  • 现在可以使用 get 方法请求单个网站媒体资源、数据视图(配置文件)或目标。
  • 这些功能目前以开发者预览版的形式提供给用户进行小范围测试。如果您有意注册并使用这些功能,可以申请参与测试

Management API 中的用户权限

在此版本中:

  • 修复了定位 iOS 7.0 时出现的链接错误。

这是 Metadata API 的初始版本:

  • Metadata API 用于返回 Google Analytics(分析)报告 API 中提供的维度和指标的相关信息。返回的元数据包括界面名称、说明、高级细分支持等属性。借助 Metadata API,您的应用能够自动及时掌握用于报告查询的维度和指标的最新数据。如需了解详情,请参阅 Metadata API 概览

在此版本中:* 包含了版本 3.0 的第一个版本 * 更改了 SDK API,以与 analytics.js 保持一致。移除了 tracksend 方法。请改用 sendGAIDictionaryBuilder 构造方法。* 移除了 GAITracker 协议中的大部分属性。请在各个字段中改为使用 set。* 使用 set 方法设置的所有参数都将保持不变。以前,只能为下一个 send/track 调用设置几个参数。* GAILogger 协议适用于希望为 SDK 实现自己的自定义日志记录的用户。* 更改了最低系统要求。如需了解详情,请参阅 Readme.txt。* 现在,所有 SDK 活动(数据库和网络访问)都将在独立的线程上完成。* 现在可以读取 clientId。调用 [tracker get:kGAIClientId]。请注意,此调用将一直保持阻止状态,直到可从数据库中读取 clientId。* 除非命中大于 2,000 字节,否则 SDK 不再使用 POST,而是改为使用 GET。* SDK 将不再根据 HTTP 响应代码重新尝试发送命中。

在此版本中:* 包含了版本 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 响应代码重试命中。

这是 Real Time Reporting API 的初始版本(处于小范围测试阶段):

  • 借助 Real Time Reporting API,您可以针对媒体资源上当前发生的活动生成报告。您可以使用 Real Time reporting API 来查询维度和指标,从而创建面向客户的网页微件和信息中心。如需了解详情,请参阅 Real Time Reporting API 概览

问题修复

  • ga:adwordsCustomerID 现在可正确返回与 AdWords API AccountInfo.customerId 相对应的 10 位数 AdWords 客户 ID。经过此次修复,可将 Google Analytics(分析)数据与多个 AdWords 帐号相关联。

随着新细分的发布,我们将对 Core Reporting API 进行以下更改。

  • segment 参数现在支持自定义高级细分的新字母数字 ID,该 ID 会在 Management API 细分集合中返回。
  • 自定义细分的当前字母数字 ID 现在处于弃用期。这些旧版 ID 在今后 6 个月内仍受支持。我们建议保存用户细分 ID 的应用改用新的字母数字 ID。弃用期结束后,使用旧版数字 ID 的任何查询都将返回错误。
  • 目前,仅在网页界面中创建的访问级细分可通过 segment 参数查询。
  • 使用负数 ID 的现有默认细分将不受影响。但是,新默认细分目前不受支持。

随着新细分的发布,我们将对细分集合进行以下更改:

  • 所有细分 ID 均将从正整数更改为字母数字字符串。如果您已保存用户的细分 ID,我们建议您进行更新以使用新 ID。
  • 细分集合将仅返回现有的访问级细分。API 目前不支持新的访问者、同类群组和顺序细分。
  • 细分集合将继续返回具有相同负数 ID 的现有默认细分,但目前尚不支持新的默认细分。

此版本为 API 新增了一些维度和指标。如需查看完整的定义列表,请参阅维度和指标参考

应用跟踪

  • 此类数据显示在“应用配置文件”报告中:
    • 维度 - ga:appId - 应用的 ID。
    • 维度 - ga:appInstallerId - 从中下载应用的安装程序(例如,Google Play 商店)的 ID。默认情况下,系统会根据 PackageManager#getInstallerPackageName 方法设置 App Installer ID。
    • 维度 - ga:appName - 应用的名称。
    • 维度 - ga:appVersion - 应用的版本。
    • 维度 - ga:exitScreenName - 用户退出应用时所显示屏幕的名称。
    • 维度 - ga:landingScreenName - 用户看到的第一个屏幕的名称。
    • 维度 - ga:screenDepth - 以字符串形式报告的每次会话屏幕浏览量。适合用在直方图中。
    • 维度 - ga:screenName - 屏幕的名称。
    • 指标 - ga:avgScreenviewDuration - 用户在屏幕上停留的平均时长(以秒为单位)。
    • 指标 - ga:timeOnScreen - 用户浏览当前屏幕所花费的时长。
    • 指标 - ga:screenviews - 屏幕浏览总量。请使用此指标而非 ga:appviews
    • 指标 - ga:uniqueScreenviews - 一次会话内不同(唯一身份)ga:screenviews 的次数。请使用此指标而非 ga:uniqueAppviews
    • 指标 - ga:screenviewsPerSession - 每次会话的平均 ga:screenviews。请使用此指标而非 ga:appviewsPerVisit

已弃用

以下指标已弃用。请改用新的指标名称。

  • 指标 - ga:appviews - 请改用 ga:screenviews
  • 指标 - ga:uniqueAppviews - 请改用 ga:uniqueScreenviews
  • 指标 - ga:appviewsPerVisit - 请改用 ga:screenviewsPerSession

自定义变量或列

  • 访问自定义维度和指标:

    • 维度 - ga:dimensionXX - 所请求自定义维度的名称,其中 XX 是指自定义维度的编号/索引。
    • 指标 - ga:metricXX - 所请求自定义指标的名称,其中 XX 是指自定义指标的编号/索引。

文档变更

重命名了以下“自定义变量”维度和指标。只是文档变更,无需您更新查询。

  • ga:customVarName(n)ga:customVarNameXX
  • ga:customVarValue(n)ga:customVarValueXX

电子商务

  • 维度 - ga:currencyCode - 交易的本地货币代码(基于 ISO 4217 标准)。
  • 指标 - ga:localItemRevenue - 产品收入(本地货币)。
  • 指标 - ga:localTransactionRevenue - 交易收入(本地货币)。
  • 指标 - ga:localTransactionShipping - 交易运费(本地货币)。
  • 指标 - ga:localTransactionTax - 交易税费(本地货币)。

异常

  • 此类数据来自异常跟踪。
    • 维度 - ga:exceptionDescription - 对异常的说明。
    • 指标 - ga:exceptionsPerScreenview - 抛出的异常次数/屏幕浏览量。
    • 指标 - ga:fatalExceptionsPerScreenview - 抛出的严重异常次数/屏幕浏览量。

目标转化次数

  • 维度 - ga:goalCompletionLocation - 与任何目标类型的目标达成匹配的网页路径或屏幕名称。
  • 维度 - ga:goalPreviousStep1 - 与任何目标类型的目标匹配的网页路径或屏幕名称,在目标达成位置之前的第一个必经步骤。
  • 维度 - ga:goalPreviousStep2 - 与任何目标类型的目标匹配的网页路径或屏幕名称,在目标达成位置之前的第二个必经步骤。
  • 维度 - ga:goalPreviousStep3 - 与任何目标类型的目标匹配的网页路径或屏幕名称,在目标达成位置之前的第三个必经步骤。

文档变更

重命名了以下“目标转化次数”维度和指标。只是文档变更,无需您更新查询。

  • ga:goal(n)AbandonRatega:goalXXAbandonRate
  • ga:goal(n)Abandonsga:goalXXAbandons
  • ga:goal(n)Completionsga:goalXXCompletions
  • ga:goal(n)ConversionRatega:goalXXConversionRate
  • ga:goal(n)Startsga:goalXXStarts
  • ga:goal(n)Valuega:goalXXValue
  • ga:searchGoal(n)ConversionRatega:searchGoalXXConversionRate
  • 指标 - ga:percentSearchRefinements - 一次会话中内部搜索关键字之间发生的优化(转换)次数所占的百分比。

网页跟踪

  • 指标 - ga:pageValue - 此网页或此组网页的平均价值。网页价值的计算方法:(交易收入 + 总目标价值)/单个网页或一组网页的唯一身份网页浏览量。

平台或设备

  • 此类数据依据 HTTP 用户代理字符串得出。

    • 维度 - ga:deviceCategory - 设备类型:桌面设备、平板电脑或手机。
    • 维度 - ga:isTablet - 指明访问者来自平板电脑。可能的值为 YesNo
    • 维度 - ga:mobileDeviceMarketingName - 用于移动设备的宣传名称。

社交互动

  • 此类数据来自站内社交互动跟踪。

    • 维度 - ga:socialEngagementType - 互动类型。可能的值为 Socially EngagedNot Socially Engaged

时间

  • 维度 - ga:dateHour - ga:datega:hour 的组合值。
  • 维度 - ga:dayOfWeekName - 表示周几的名称(英文)。
  • 维度 - ga:isoWeek - ISO 周序号,每周从星期一开始。详细信息:http://zh.wikipedia.org/wiki/ISO_week_date
  • 维度 - ga:yearMonth - ga:yearga:month 的组合值。
  • 维度 - ga:yearWeek - ga:yearga:week 的组合值。

流量来源

  • 维度 - ga:fullReferrer - 包含主机名和路径的完整引荐来源网址。
  • 维度 - ga:sourceMedium - ga:sourcega:medium 的组合值。

此版本为 Webproperty 资源新增了 2 个属性:

  • profileCount - 返回媒体资源的配置文件计数。这样一来,您可以过滤未包含任何配置文件(即 profileCount = 0)的媒体资源。
  • industryVertical - 返回为媒体资源选择的行业/类别。

修复了以下问题:

  • 现在,“配置文件”资源eCommerceTracking 属性与网页界面“管理”部分中的电子商务设置一致。启用电子商务跟踪时返回 true,否则返回 false
  • Webproperty 资源现在包含一个 level 属性,用于指明网站媒体资源是 PREMIUM 还是 STANDARD

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

  • 此版本新增了 2 个实验指标:- ga:experimentId - ga:experimentVariant
  • Management API v3 中新增了一个端点,用于访问和修改实验资源。

以下更改已推送至最新版的跟踪代码:

  • 新增了对采用 _set 指定本地货币的支持,例如 gaq.push(['_set', 'currencyCode', 'EUR'])
  • 此版本新增了 5 个网站速度指标:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • 此版本为“平板电脑流量”新增了一个默认细分 gaid::-13
  • “配置文件”资源现在包含一个 type 属性,用于确定配置文件是为网站还是为应用配置的。两个可能的值为 WEBAPP

在此版本中:

  • 默认 appVersion 更改成了 CFBundleShortVersionString(而不是 CFBundleVersionKey)中的值。
  • 将 HTTPS(而不是 HTTP)用作默认协议。
  • Track 方法更改成了 Send(例如,trackView 现在称为 sendView)。
  • 修复了几个小问题。

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

在此版本中:

  • libGoogleAnalytics.a 中新增了 armv7s 架构。
  • 从 libGoogleAnalytics.a 中移除了 armv6 架构。

此版本为 API 新增了一些维度和指标。如需了解相关定义,请参阅维度和指标参考

应用跟踪

  • 此类数据显示在“移动应用跟踪 SDK”报告中:
    • 指标 - ga:uniqueAppviews - 每次会话的应用浏览量。
    • 指标 - ga:appviews - 应用浏览总量。
    • 指标 - ga:appviewsPerVisit - 每次会话的平均应用浏览量。

流量来源

  • 维度 - ga:socialNetwork - 表示社交网络名称的字符串。此维度可能与流量来源的引荐社交网络相关,也可能与社交数据中心活动的社交网络相关。例如,Google+、Blogger、Reddit 等。
  • 维度 - ga:hasSocialSourceReferral - 表示从社交来源(即 Google+、Facebook、Twitter 等社交网站)到达您网站的访问。可能的值为 Yes 或 No,其中首字母必须大写。

社交活动

  • 此类数据来自从社交数据中心合作伙伴导入的站外活动。
    • 维度 - ga:socialActivityDisplayName - 对于社交数据中心活动,此字符串表示社交网络用户发布的社交活动的名称。
    • 维度 - ga:socialActivityEndorsingUrl - 对于社交数据中心活动,此字符串表示社交活动的网址(例如,Google+ 帖子的网址、博客评论的网址等)。
    • 维度 - ga:socialActivityPost - 对于社交数据中心活动,此字符串表示社交网络用户发布的社交活动的内容(例如,Google+ 帖子的消息内容)。
    • 维度 - ga:socialActivityTimestamp - 对于社交数据中心活动,此字符串表示社交活动在社交网络上发生的时间。
    • 维度 - ga:socialActivityUserPhotoUrl - 对于社交数据中心活动,此字符串表示与用户的社交网络个人资料相关联的照片的网址。
    • 维度 - ga:socialActivityUserProfileUrl - 对于社交数据中心活动,此字符串表示相关联的用户社交网络个人资料的网址。
    • 维度 - ga:socialActivityContentUrl - 对于社交数据中心活动,此字符串表示相关社交网络用户分享的网址。
    • 维度 - ga:socialActivityTagsSummary - 对于社交数据中心活动,这是指与社交活动相关联的一组标签(以英文逗号分隔)。
    • 维度 - ga:socialActivityUserHandle - 对于社交数据中心活动,此字符串表示发起社交活动的用户的社交网络称呼(即名称)。
    • 维度 - ga:socialActivityAction - 对于社交数据中心活动,此字符串表示与社交活动相关的社交操作类型(例如,投票、评论、+1 等)。
    • 维度 - ga:socialActivityNetworkAction - 对于社交数据中心活动,此字符串表示社交操作和发起社交活动的社交网络的类型。
    • 指标 - ga:socialActivities - 在社交数据中心合作伙伴网络上分享/提及某个内容网址的活动的数量。

社交互动

  • 此类数据来自站内社交互动跟踪。
    • 维度 - ga:socialInteractionAction - 对于社交互动,这是一个字符串,表示要跟踪的社交操作(例如,+1、顶、添加书签)。
    • 维度 - ga:socialInteractionNetwork - 对于社交互动,这是一个字符串,表示要跟踪的社交网络(例如,Google、Facebook、Twitter、LinkedIn)。
    • 维度 - ga:socialInteractionNetworkAction - 对于社交互动,这是一个字符串,表示要跟踪的 ga:socialInteractionNetworkga:socialInteractionAction 的串联(例如,“Google:+1”“Facebook:赞”)。
    • 维度 - ga:socialInteractionTarget - 对于社交互动,这是一个字符串,表示收到社交网络操作的网址(或资源)。
    • 指标 - ga:socialInteractions - 您网站上发生的社交互动的总数。
    • 指标 - ga:uniqueSocialInteractions - 您网站上发生的唯一身份社交互动的总数。(基于值对 ga:socialInteractionNetworkga:socialInteractionAction)。
    • 指标 - ga:socialInteractionsPerVisit - ga:socialInteractions/ga:uniqueSocialInteractions。对您网站的每次访问带来的平均社交互动次数。

地理位置/网络

  • 维度 - ga:metro - 产生流量的特定媒体市场区域 (DMA)。

网页跟踪

  • 维度 - ga:pagePathLevel1 - 此维度汇总了 pagePath 中第一层级的所有 pagePath。
  • 维度 - ga:pagePathLevel2 - 此维度汇总了 pagePath 中第二层级的所有 pagePath。
  • 维度 - ga:pagePathLevel3 - 此维度汇总了 pagePath 中第三层级的所有 pagePath。
  • 维度 - ga:pagePathLevel4 - 此维度汇总了 pagePath 中第四层级的所有 pagePath。此维度还汇总了 pagePath 层次结构中的所有其他级别。

异常跟踪

  • 此类数据来自异常跟踪数据。

    • 指标 - ga:exceptions - 发送到 Google Analytics(分析)的异常次数。
    • 指标 - ga:fatalExceptions - 异常次数,其中 isFatal 设置为 true。

用户计时

  • 此类数据来自用户计时数据。

    • 维度 - ga:userTimingCategory - 一个字符串,用于将所有用户计时变量归类到相应逻辑组,以便更轻松地生成报告。
    • 维度 - ga:userTimingLabel - 一个字符串,表示要跟踪的资源的操作名称。
    • 维度 - ga:userTimingVariable - 一个字符串,可用于提高报告中显示用户计时数据的灵活性。
    • 维度 - ga:userTimingValue 发送到 Google Analytics(分析)的历时时间,以毫秒为单位。
    • 指标 - ga:userTimingSample - 发送的样本的数量。
    • 指标 - ga:avgUserTimingValue - 平均用户计时值。ga:userTimiingValue/ga:userTimiingSample

设备/平台

  • 此类数据来自已收集数据的用户代理。
    • 维度 - ga:mobileDeviceBranding - 移动设备制造商或品牌名称(例如:三星、HTC、Verizon、T-Mobile)。
    • 维度 - ga:mobileDeviceModel - 移动设备型号(例如:Nexus S)。
    • 维度 - ga:mobileInputSelector - 移动设备上使用的输入方式(例如:触摸屏、操纵杆、点拨轮、触控笔)。
    • Dim - ga:mobileDeviceInfo - 用来识别移动设备的品牌、型号和宣传名称。

在此版本中:

  • 修复了以下问题:

    • 移除库的 NoThumb 版本。
    • 放弃对 armv6 的支持。
  • 新增了几项功能:

    • 新增对 armv7s 的支持(适用于 iPhone5)。

在此版本中:

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

在此版本中:

  • 修复了以下问题:
    • GANTrackerDelegate 协议方法现在是可选项。
    • 事件现在包含最后跟踪的网页浏览量 (utmp)。
  • 新增了几项功能:
    • 最多支持 50 个自定义变量(注意:此功能仅面向 Google Analytics Premium 用户提供)。
    • 更新了 BasicExample 示例应用。

在此版本中:

  • 修复了以下问题:

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

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

在此版本中:

  • GAITracker 中新增了社交跟踪方法:
    • trackSocial:withAction:withTarget:
  • 计时方法签名更改成了:
    • trackTiming:withValue:withName:withLabel:
  • GAITracker 中新增了手动构造和调度方法:
    • set:value:
    • get:
    • send:params:
  • GAITracker 中新增了自定义维度 setter 方法:
    • setCustom:dimension:
    • setCustom:metric:
  • 重构了数据存储的架构,以防出现报告的 CoreData 问题。

在此版本中:

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

这是 Multi-Channel Funnels Reporting API 的初始版本:

  • 借助此新 API,您可以请求通过身份验证的用户的多渠道漏斗数据。这些数据来自于转化路径数据,后者显示了转化之前用户在多次访问中与各种流量来源的互动情况。借助此类数据,您可以分析多个营销渠道如何在一段时间内影响转化。如需详细了解所提供的数据以及如何使用该 API,请参阅 Multi-Channel Funnels Reporting API

在此版本中:

  • 更新为使用最新的线上传输格式。
  • sampleRate 改为使用双精度浮点数。
  • 限制了过度跟踪。
  • 启用选择退出后,系统会删除未调度的跟踪信息。
  • 系统将删除 30 天以上未调度的跟踪信息。
  • 增强了命中调度程序的功能。
  • 调度程序将在丢失连接时使用 Reachability API,而不是定期重试,以便在重新建立连接时获取通知。
  • 更新了示例应用。
  • 修复了其他问题并增强了几个功能。

在此版本中:

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

问题修复

  • API 现在可以正确处理过滤器或动态细分中的 UTF-8 字符。

在此版本中:

  • 新增了未捕获的异常处理工具。
  • GAI 中移除了 dispatchEnabled 属性。
  • GAI 中新增了 defaultTracker 属性。
  • GAITracker 中新增了 close 方法。
  • GAITracker 中新增了计时跟踪方法。
  • GAITracker 中新增了 trackView 方法,该方法不使用任何参数。
  • 更新了交易商品字段名称。
  • 更新为使用最新的线上传输格式。
  • 将事件值解读为 64 位整数。
  • ARMV6 代码生成从 THUMB 切换为 ARM。

在此版本中:

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

在此版本中,Google Analytics Premium 帐号最多可访问 50 个自定义变量。

以下更改已推送至最新版的跟踪代码:

  • 允许的网站速度采样率上限 (_setSiteSpeedSampleRate) 已从 10% 增加至 100%。
  • _setAccount 方法现在会去除开头和结尾的所有空格。

此版本修复了 2 个错误:

问题修复

  • 在正则表达式中包含特殊字符的查询过滤器不再返回服务器错误。

  • 将指标过滤器与高级细分组合使用不再返回错误。

此版本为 API 新增了一些网站速度指标。

新指标

  • 新增了以下网站速度指标:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

如需了解相关定义,请参阅维度和指标参考

API 版本 2.3 弃用提醒

  • Data Export API 版本 2.3 已弃用 2 个月。大约 4 个月后,我们将停用此服务,仅支持新的 Core Reporting API 版本 3.0版本 2.4

  • 我们强烈建议您将应用迁移到版本 3.0。

  • 今后 4 个月内,向旧版本 2.3 XML 数据 Feed 发出的请求将被转发到版本 2.4,并返回版本 2.4 XML 响应。在此期间,所有版本 2.4 的配额政策都将应用于版本 2.3 请求。

  • 针对版本 2.3 JSON 或使用版本 2.3 JSON 输出的 Google 数据 JavaScript 客户端库发出的所有请求都将返回 404 状态代码。

  • 要获取全部配额,版本 3.0 和版本 2.4 需要您在 Google API 控制台中注册应用,并在每次请求中使用 API 密钥(或 OAuth 2.0 令牌)。

以下更改已推送至最新版的跟踪代码:

  • 更新了默认检测到的自然搜索引擎列表。新增了“startsiden.no”“rakuten.co.jp”“biglobe.ne.jp”和“goo.ne.jp”。移除了“search”并新增了“conduit.com”“babylon.com”“search-results.com”“avg.com”“comcast.net”和“incredimail.com”,以上这些之前都被归结为“search”。

我们修复了 ga:visitLength 方面的一个小错误。此维度现在可返回正确的数据。

此版本为 Management API 新增了一些实用的错误响应。

  • API 错误响应正文中新增了一些错误代码、原因和相应说明。已针对 Management API 版本 2.4版本 3.0 这两个版本记录了所有代码。

以下更改已推送至最新版的跟踪代码:

  • 自定义变量长度的上限已从 64 个字符增加至 128 个字符。此外,现在需要先检查变量长度,然后再进行网址编码。
  • 放宽了事件命中的速率限制。您现在每秒可以发送 10 次命中,还有 1 次额外的命中(以前限制为每 5 秒 1 次命中)。请注意,每次会话 500 次命中这一限制仍然适用。
  • __utmv Cookie 现在采用其他变量分隔符(脱字符号,而非英文逗号)进行编写,以便与 RFC 兼容。这应该可以解决一些与客户遇到的 Cookie 编码问题相关的问题。

此版本会影响所有 Google Analytics(分析)API 开发者。此版本公布了 API 的两个新版本,要求应用进行注册,引入了新配额政策,并将 API 名称更改成了 Core Reporting API。最后,此版本弃用了现有的 Data Export API 版本 2.3。

版本 3.0

  • Core Reporting API 版本 3.0 是我们 API 的最新主要版本,并且不向后兼容。API 的所有后续开发工作都将基于此版本完成。

  • 新增了几项功能

    • 与之前的 XML 输出相比,新增的基于 JSON 的输出使得响应大小缩减了 10 倍左右。
    • 提供了新的 Google API 客户端库,支持 Java、JavaScript、Python、PHP、Ruby 和 .Net。
    • 新增了对 Google Discovery API 的支持。
    • 新增了对 OAuth 2.0 的支持,我们推荐采用这种新方法向用户授权。
  • 进行了几项更新

    • 新增了一个用于发出请求的网址:https://www.googleapis.com/analytics/v3/data/ga…
    • 需要注册和提供开发者令牌。
    • 所有配置数据请求均应通过 Management API 完成。

版本 2.4

  • Core Reporting API 版本 2.4 是次要版本升级,在大部分情况下与现有的 Data Export API 版本 2.3 向后兼容。

  • 进行了几项更新

    • 新增了一个用于发出请求的网址:https://www.googleapis.com/analytics/v2.4/data…
    • 需要注册和提供开发者令牌。
    • 此版本的 XML 输出与版本 2.3 一致,因此其他现有的 Google 数据客户端库将继续正常运行。
    • 配额错误的错误代码从 503 更改为了 403
    • 不再支持 JSON 响应。
    • 不再支持 Google 数据 JavaScript 客户端库。
    • 不再提供帐号 Feed。所有配置数据请求均应通过 Management API 完成。

注册

  • 所有使用 Google Analytics(分析)API 构建的应用都必须通过 Google API 控制台注册为项目。

  • 向 API 发出的每个请求必须包含 API 密钥,若是 OAuth 2.0 请求则必须包含 Client ID 和客户端密钥。

配额政策

  • 以下配额适用于 Google Anlaytics(分析)API(Management API 和 Data Export API)

    • 每个项目每日的请求数不得超过 50,000 次
    • 每个 IP 地址的每秒查询数 (QPS) 不得超过 10 次
  • 以下配额适用于 Data Export API

    • 每个配置文件每日的请求数不得超过 10,000 次
    • 每个配置文件的并发请求数不得超过 10 次
  • 对于未注册的应用,我们提供的免费配额非常少,只能满足少量测试要求。

弃用

  • 此版本还公布了弃用版本 2.3,以及即将在 Data Export API 中停用帐号 Feed。今后 6 个月内:

    • 向版本 2.3 XML 数据 Feed 发出的请求将被转发到版本 2.4,并返回版本 2.4 响应。在此期间,所有版本 2.4 的配额政策都将应用于版本 2.3 请求。

    • 向版本 2.3 JSON 输出发出的请求将不受版本 2.4 响应的支持,且将返回 404 Not Found 状态代码。如果您需要 JSON 响应,请升级至版本 3.0。

    • 向 Data Export API 中的帐号 Feed 发出的请求将返回 404 Not Found 状态代码。所有配置数据请求均应通过 Management API 完成。

此版本新增了一些数据、更改了现有功能并修复了一个问题。

新数据

  • “高级细分”集合现在包含一个 segmentId 字段,可用于 Data Export API 细分参数。

变更

  • max-results 的数据类型更改成了 integer

  • max-results 的默认值和上限均更改成了 1,000。

问题修复

  • Google 网站优化工具实验的帐号、网络媒体资源和配置文件已不再包含在相应集合中。

在此版本中:

  • 文档:

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

在此版本中:

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

网站速度数据收集方面的更改:

  • 现在,系统会以 1% 的采样率自动收集所有网络媒体资源的网站速度数据。现已弃用 _trackPageLoadTime 函数,此前需要选择该函数才可以收集网站速度数据。
  • 新增了可调整默认采样率的 _setSiteSpeedSampleRate 函数。
  • 如果 _trackPageview 调用中使用了虚拟路径,则现在还可以将该路径与从该页面中收集的任何网站速度数据关联起来。

在此版本中:

  • 修复了以下问题:
    • 数据库的位置已从“Documents”目录更改为“Library”目录。
    • SDK 不再为 SQLite 数据库错误抛出 NSAsserts
    • 修复了通过空字符串调用 trackPageview 时出现崩溃的问题。
    • 修复了在调用 stopTracker 后调用各种 GANTracker 方法时出现崩溃的问题。
    • 修复了几个内存泄露的问题,包括一个通过以“/”开头的 pageURL 调用 trackPageview 的泄露问题。
  • 新增了几项功能:
    • 新增了 dispatchSynchronously 方法。
    • 公开了几个实用的常量(请参阅 GANTracker.h)。

在此版本中:

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

此版本新增了以下功能:

  • 通过将 _trackEvent() 方法的新 opt_noninteraction 参数设置为 true,可以将事件标记为非互动。将事件标记为非互动意味着,来自该标记事件的点击将不会影响跳出率。如需了解详情,请参阅 ga.js 参考

此版本修复了以下问题:

  • 修复了通过内部网站链接传递 AdWords gclid 网址参数可能导致付费访问次数虚增的问题。

此版本新增了一些更新鲜的 AdWords 数据,以及更多 AdWords 维度和指标组合。

  • 现在,AdWords 数据的更新频率间隔不超过一小时。之前,此类数据每天更新一次。

  • 我们在 AdWords 数据方面放宽了对一些有效组合的限制。

几周前,我们进行了一项变更,以禁止通过 ga:impressions 询问 ga:adGroupga:adContent 的 API 查询,因为这种组合之前会返回 0。进行此项变更后,我们现在再次提供这种组合并修复了相关问题,使之可返回正确的数据。

在此版本中:

  • 修复了以下问题:
    • 修复了启动跟踪器前尝试设置 dryRun 标记时出现的总线错误。
    • 修复了尝试针对错误传递 NULL 时出现的总线错误。
    • 在 HTTP 标头中使用正确语言。
  • 新增了几项功能:
    • 新增了 anonymizeIp 标记。
    • 新增了 sampleRate 参数。
    • 新增了对广告系列引荐的支持。

在此版本中:

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

此版本新增了 API 的两个版本(其中包含许多新功能),并弃用了旧版本。这些变更会影响您通过 API 请求和处理数据的方式。

版本 3.0

  • 这是我们 API 的最新主要版本,并且不向后兼容。API 的所有后续开发工作都将基于此版本完成。

  • 新数据

    • 事件目标的完整表示形式
    • 内部网络媒体资源 ID,可用于与 Google Analytics(分析)界面建立深层链接
    • 默认网页和网站搜索查询参数的配置文件配置
  • 变更

    • 新增了一项配额政策
    • Google API 控制台集成,以管理 API 访问权限和申请更多配额
    • 新增了对 OAuth 2.0 的支持,我们推荐采用这种新方法向用户授权
    • 新增了一个用于发出请求的网址:https://www.googleapis.com/analytics/v3/management/…
    • 使用 JSON 实现更紧凑的 API 响应
    • 提供了新的 Google API 客户端库,支持更多语言
    • 新增了对 Google Discovery API 的支持

版本 2.4

  • 这是次要版本升级,在大部分情况下与现有的版本 2.3 向后兼容。

  • 变更

    • 新增了一项配额政策
    • Google API 控制台集成,以管理 API 访问权限和申请更多配额
    • 继续对现有授权机制和 OAuth 2.0 提供支持
    • 新增了一个用于发出请求的网址:https://www.googleapis.com/analytics/v2.4/management/…
    • 响应仅采用 XML 格式
    • 不再支持 Google 数据 JavaScript 客户端库
    • 此版本的 XML 输出与版本 2.3 一致,因此其他现有的 Google 数据客户端库将继续正常运行。

弃用

  • 我们宣布将弃用 Management API 的旧版本 2.3。该版本将于 2 个月后停用,之后所有 v2.3 请求都将返回 v2.4 响应。

此版本修复了可能导致一些网站的访问次数虚增和/或新访客数量减少的问题。访问次数虚增影响的主要是具有与特定用户行为相关的自然流量的网站,而新访客数量减少只会影响那些使用不受支持的、拥有多个跟踪器的跟踪配置的网站。

此版本修复了一些维度和指标组合无效的问题

修复了无效指标/维度组合

  • 上个月,我们宣布了即将对 API 进行的一些更改,以禁止数据 Feed 中某些不会返回任何数据的无效查询。现在,我们已经对 API 进行了相应更改,因此以下组合无效:

    • 产品维度不能与交易指标结合使用。
    • ga:adContentga:adGroup 不能与 ga:impressions 结合使用。

    现在,API 会针对询问上述组合的所有查询返回 400 错误代码,而不再返回不含任何搜索结果的响应。

会话计算方面的变化:

  • 每个会话一个广告系列:如果在现有会话期间启动了新广告系列,那么现在的跟踪脚本将自动启动新会话。更改以下任一字段都会触发新的广告系列:广告系列 ID、名称、来源、媒介、字词、内容或 gclid。
  • 如果用户关闭浏览器,则跟踪脚本不再启动新的会话。

跨网域跟踪方面的变化:

  • 配置跨网域跟踪时,不再需要调用 _setAllowHash(false)。已包含 _setAllowHash(false) 调用的页面将继续正常显示,但在设置新网站时不再需要进行调用。
  • 跟踪脚本现在会尝试修复被 HTTP 重定向器和浏览器损坏的链接器参数。在当前由于重定向器和浏览器引入的编码变化而被废弃的链接器值中,跟踪脚本应该可以修复成功并接受其中大约 85% 的值。

在此版本中:

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

此版本新增了一项功能:

  • 跟踪代码现在会推迟相关预呈现页面的命中,直到用户查看这些页面。如果用户一直没有查看预呈现页面,则不发送命中。此功能仅面向使用异步跟踪脚本的网站提供。您可以通过 Google 网站站长中心博客详细了解预呈现。

此版本修复了各种问题并进行了重构,还新增了一项功能:

此版本在指标中弃用了置信区间值。

弃用置信区间

  • 请停止在指标中使用置信区间值(如果您尚未这样做)。在此版本中,Data Export API 数据 Feed 会针对所有置信区间值返回 0.0。大约在一个月后,我们将从所有指标元素中彻底移除此属性。

    要确定是否已对某个响应进行抽样,请在响应中使用 containsSampledData 字段。

在此版本中:

  • 修复了以下问题:
    • 修复了使用自定义变量时出现的崩溃问题。
    • 修复了使用自定义变量时出现的内存泄露问题。
  • 新增了几项功能:
    • 新增了对电子商务命中的支持。
    • 新增了 Debug 标记。
    • 新增了 DryRun 标记。
    • 提供了更多有关 SQLite3 故障的描述性错误信息

在此版本中:

  • 修复了以下问题:

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

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

此版本新增了 3 个指标并更新了 2 个指标的返回值。

新的数据更新

  • 我们为此 API 新增了 3 个用于处理网站速度性能的指标:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

指标更新

  • 要在过滤器中指定货币值,您必须指定从跟踪代码中传入的实际值(例如,1 个单位现在将指定为 1)。

  • ga:CTR 现在返回实际百分比值(例如,值 2% 将作为 2 返回)。

此版本修复了以下问题:

  • 修复了跨网域跟踪中的一个问题,该问题在一些情况下会导致广告系列数据出现错误的编码。
  • 修复了跨网域跟踪中的一个问题,该问题会导致系统多次从网址中加载 Cookie,在一些情况下这会导致出现不正确的 Cookie。
  • 修复了自定义变量中的一个问题,该问题会导致对报告中的一些值进行编码。

在此版本中:

  • 修复了以下问题:

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

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

此版本改进了数据 Feed 的性能并新增了一些数据:

性能改进

  • 此版本将数据 Feed 延迟时间缩短了 30% 至 35%。

新的数据更新

  • 我们更新了高级细分中允许使用的维度和指标的列表。请参阅更新后的列表,确保您的请求有效。

即将进行的更改

  • 目前,您需要以微单位形式指定货币过滤器值(例如,将 1 个单位的货币指定为 1000000)。在不久的将来,您需要指定从跟踪代码中传入的实际值(例如,1 个单位现在将指定为 1)。

  • 目前,ga:CTR 采用 percent 形式并返回值 0.02。在不久的将来,这将会更改为返回实际百分比值(如 2)。

此版本进行了一些常规维护,包括修复了几个问题和进行重构。公开 API 或功能没有变化。

此版本进行了一些更新,并新增了一项功能。

  • POST 支持:

    • 跟踪代码现在可以发送更大的跟踪信标。信标一直以来都是通过 HTTP GET 请求发送的,一些浏览器和代理会将请求限制在 2048 个字符以内。超出此限制的请求将被丢弃,因此相关数据永远不会到达 Google Analytics(分析)。从此版本开始,超过 2048 个字符的请求将通过 HTTP POST 发送,因此没有这种限制了。跟踪代码现在支持最多 8192 个字符的信标。

此版本为数据 Feed 新增了更多数据:

新的数据更新

  • 新增了以下时间维度:ga:dayOfWeek

  • 新增了以下内部搜索指标:ga:percentVisitsWithSearch

  • 新增了以下事件跟踪指标:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

即将进行的更改

目前,API 会针对各种授权问题返回 401 状态代码。在未来几周内,401 状态将专用于无效令牌,让开发者能够对此特殊异常进行错误处理。

此版本修复了以下问题:

  • 修复了在第一次访问网站时阻止 _addIgnoredOrganic_addIgnoredRef 正常工作的问题。
  • 修复了一个与跨多个 iframe 运行的跟踪代码有关的问题。

在此版本中:

  • 新增了几项功能:
    • 新增了对自定义变量的支持。
    • 新增了库的 NoThumb 版本。

此版本为数据 Feed 增加了明显多于以往的数据:

新的数据更新

  • ga:visitors 的计算方式已更改为返回整个日期范围内唯一身份访问者的数量,而且现在支持更多维度和指标组合。

  • 新增了 10 个 AdWords 维度:ga:adDistributionNetworkga:adMatchTypega:adMatchedQueryga:adPlacementDomainga:adPlacementUrlga:adFormatga:adTargetingTypega:adTargetingOptionga:adDisplayUrlga:adDestinationUrl

  • 广告系列组中新增了指标 ga:organicSearches

  • 内部网站搜索组中新增了指标 ga:searchResultViews

  • 新增了 3 个基于时间的维度:ga:nthDayga:nthWeekga:nthMonth

  • 更改了维度和指标的分组方式,以更好地体现其所代表的功能。

新计算指标

以下计算指标依据使用基本指标的计算得出。注意:名称带有 (n) 的指标均支持 1 到 20 之间的值。

  • 基于目标:ga:costPerConversionga:costPerGoalConversionga:costPerTransactionga:goal(n)AbandonRatega:goal(n)Abandonsga:goal(n)ConversionRatega:goalAbandonRateAllga:goalAbandonsAllga:goalConversionRateAllga:goalValueAllPerSearchga:goalValuePerVisit

  • 基于内容:ga:entranceBounceRatega:visitBounceRatega:entranceRatega:exitRatega:pageviewsPerVisitga:avgTimeOnPagega:avgTimeOnSitega:avgEventValue

  • 基于内部网站搜索:ga:avgSearchDepthga:avgSearchDurationga:avgSearchResultViewsga:searchGoalConversionRateAllga:searchGoal(n)ConversionRatega:searchExitRate

  • 基于电子商务:ga:itemsPerPurchasega:marginga:percentNewVisitsga:revenuePerItemga:revenuePerTransactionga:ROIga:RPCga:totalValuega:transactionRevenuePerVisitga:transactionsPerVisit

此版本为数据 Feed 新增了一项功能:

新增了几项功能

  • 新增了一个 XML 元素,以便于用户确认是否对相关数据进行了抽样:true。此元素将始终通过返回 truefalse 的方式来表明是否对相关数据进行了抽样。此版本还更新了 Java 和 JavaScript 库,增加了用于访问此元素的辅助方法。

此版本进行了一些常规维护,包括修复了几个问题和进行重构。公开 API 或功能没有变化。

在此版本中:

  • 新增了几项功能:

    • 新增了 iOS4 支持

此版本修复了 2 个错误:

问题修复

  • 之前,如果向包含维度(即 ga:keyword==store,ga:keyword==bar)的过滤器表达式添加 OR 运算符,生成的值可能与将每个过滤器分别应用于多个查询得到的值不同。此问题已得到修复,现在使用 OR 运算符将返回一致的值。

  • 更新了一些有关无效过滤器的 API 错误消息,不再指明导致错误的是维度过滤器还是指标过滤器(而实际导致问题的过滤器表达式仍将继续返回)。

这是 Google Analytics(分析)Management API 的 Beta 版!

新增了一些 Feed

更新了客户端库

  • Management API 与 Google Analytics(分析)Data Export API 在同一库中发布。更新了 Google 数据 Java 和 JavaScript 库。每种 Feed 均可通过为相应库的 getManagementFeed() 方法指定适当的 Feed URI 来访问。

新文档

  • 在 Google Analytics(分析)开发者文档中新增了一部分,其中介绍了新 Management API 的运作方式。

此版本修复了 3 个错误:

问题修复

  • 修复了一个 JavaScript 客户端库的编码问题。Google Analytics(分析)问题跟踪器

  • 修复了以下问题:当目标名称、目标路径、目标比较值或目标比较类型设置不正确时,帐号 Feed 无法返回。

  • 在数据 Feed 查询过滤器参数中,无法以 OR 运算符添加维度和指标。例如 ga:source==google,ga:visits>5。此无效查询的错误消息已更新为:Cannot OR dimension filter(s) with metric filter

此版本新增了一些数据并修复了一个问题:

新增了几项功能

  • 新类别 D8. Adwords 中新增了以下 5 个维度:

问题修复

  • 我们修复了以下问题:如果某个配置文件包含配置不正确的目标或步骤,帐号 Feed 就无法返回数据。

此版本修复了几个问题,并进行了 API 清理。

  • 修复了以下问题:

    • 修复了事件跟踪问题。调用 _trackEvent 时不再需要首先调用 _initData_trackPageview
    • 更新了异步代码段,使其可以置入任何页面的标头,而不会在 IE 6 和 IE 7 中引发问题。如需了解这一新的代码段,请参阅异步跟踪指南。此项更新的实施日期是 2010 年 3 月 22 日。
    • 扩展了异步语法,使之支持调用 _gat 对象上的方法。
  • 更新了跟踪器初始化 API,使之与异步语法保持一致。还弃用了一些原有的函数。

    • 新增了 _gat._createTracker(opt_account, opt_name) 函数。您可使用此函数命名跟踪器,并在稍后通过这些名称进行检索。建议使用此函数,而不是 _gat._getTracker(account)
    • 新增了 _gat._getTrackerByName(name)。用于检索具有指定名称的跟踪器。
    • 新增了 tracker._getName()。用于返回创建跟踪器时指定的跟踪器名称。
    • 弃用了 _gaq._createAsyncTracker(account, opt_name)。请改用 _gat._createTracker
    • 弃用了 _gaq._getAsyncTracker(name)。请改用 _gat._getTrackerByName
  • 如需详细了解这些 API 的变化,请参阅跟踪器参考

此版本新增了一些功能并修复了一个问题:

新增了几项功能

  • 增强了 iPhone 默认细分 (gaid::-11) 功能,现在可为所有移动设备生成报告。该细分的 ID (-11) 仍与以前一样,但名称现在为 Mobile Traffic

  • 现在,API 与网页界面使用相同的采样率。这样一来,抽样报告的数据便可与网页界面保持同步,增强了二者之间的一致性。

  • 为了确保所有用户都能公平使用资源,我们对配额政策进行了更新。如需了解详情,请参阅我们的配额政策文档。新政策的规定如下:

    • 单个网络媒体资源每 24 小时最多可以发出 10,000 次请求。
    • 在任意指定的 1 秒内,一个应用发出的请求数不得超过 10 次。
    • 无论在哪个时间点,一个应用只能拥有 4 个待处理请求。
  • 放宽了对维度和指标组合的某些限制。ga:nextPagePathga:previousPagePath 现在属于 D3. Content 组。D8. Custom Variable 组现在称为 D6. Custom Variable 组。如需了解这些新组合,请参阅更新后的参考指南

问题修复

  • 我们修复了一个与 API 为指标报告 confidenceInterval 值的方式有关的问题。之前,置信区间的值要么是 INF,要么是 0 到 1 之间的数字。现在,所有置信区间的值要么是 INF,要么是不小于 0 的数字。

  • ga:itemQuantityga:uniquePurchases 以前互有交叉,会返回对方的值。现在此问题已得到修复,可以返回正确的数据。

维度和指标弃用提醒

  • 请停止使用之前已弃用的维度和指标(如果您尚未这样做)。

此版本新增了一些功能:

此版本将主要版本号增至 2

  • 一些功能要求使用最新的客户端库。我们正式支持的库包括:JavaJavaScript。第三方库可能尚未更新。

    • 在每个帐号或数据 Feed 请求中添加标头 GData-Version: 2 可以请求版本 2。如需了解详情,请参阅这份文档
    • 帐号 Feed 和数据 Feed 中新增了一个 XML 命名空间:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • API 现在支持 Google 数据协议版本 2

高级细分支持

  • 动态细分查询参数:

    • ...&segment=dynamic:: 表达式
    • 允许随时创建高级细分。
    • “表达式”可以是任何维度或指标,并应遵循与过滤器相同的语法。
  • 默认和自定义细分查询参数:

    • ...&segment=gaid:: 数字
    • 其中“数字”是一个 ID,用于引用 Google Analytics(分析)网页界面中定义的高级细分。
    • 该 ID 显示在帐号 Feed 中。
  • 帐号 Feed 通过以下 XML 元素和属性来描述细分数据:

    • <dxp:segment id="gaid::-3" name="Returning Visitors"></dxp:segment>
    • <dxp:definition>ga:visitorType==Returning Visitor</dxp:definition>
  • 数据 Feed 还提供一个 XML 元素,用于表明细分是否应用到了 API 请求中。

  • 如需详细了解高级细分,请参阅我们的这份文档

推出新的目标数据

  • 帐号 Feed 中提供了目标类型和互动类型这两种目标:

    • <ga:goal active="true" name="Completing Order" number="1" value="10.0"></ga:goal>
    • <ga:destination expression="/purchaseComplete.html" matchtype="regex" step1required="false" casesensitive="false"></ga:destination>
    • <ga:step number="1" name="Login" path="/login.html"></ga:step>
    • <ga:engagement comparison=">" thresholdvalue="300" type="timeOnSite"></ga:engagement>
  • 为目标 5-20 新增了 48 个目标指标,这些指标全部遵循 goal(n)Completions 命名约定,其中 (n) 为 1 至 20 之间的数字。

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value
  • 更新了 GoalCompletionAllGoalStartsAllGoalValueAll,用于对新目标数据进行解释。

新的自定义变量数据

  • 此前通过各个配置文件收集的所有自定义变量已作为新的 XML 元素添加到帐号 Feed:

    • <ga:customvariable index="1" name="category" scope="visitor"></ga:customvariable>
  • 为自定义变量新增了 10 个维度。这些维度遵循 customVar(n) 命名约定,其中 (n) 可以是 1 至 5 之间的数字。

    • ga:customVarName(n)
    • ga:customVarValue(n)

请移除已弃用的维度和指标!

  • 请停止使用之前已弃用的维度和指标(如果您尚未这样做)。它们很快就会被移除,如果继续请求,则会从我们的 API 返回错误。

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • 重命名了以下维度:

    • ga:countOfVisits 现为 ga:visitCount
    • ga:countOfVisitsToATransaction 现为 ga:visitsToTransaction

此版本更新了默认的搜索引擎列表,并新增了控制 Cookie 超时的函数。此外,还发布了异步 GA 代码段,可降低页面上的 ga.js 延时影响。

  • 更新了默认的搜索引擎列表。

    • 新增了 Naver、Eniro 和 Daum 搜索引擎。
    • 从列表中移除了 Looksmart、Gigablast、Club-internet、Netsprint、Intera、Nostrum 和 Ilse。
  • 新增了控制所有已存储 Cookie 的到期时间的函数。弃用了现有的 Cookie 超时函数。如需了解详情,请参阅 JS API 文档

    • _setVisitorCookieTimeout(cookieTimeoutMillis) 替换了 _setCookiePersistence 函数。
    • _setSessionCookieTimeout(cookieTimeoutMillis) 替换了 _setSessionTimeout 函数。
    • _setCampaignCookieTimeout(cookieTimeoutMillis) 替换了 _setCookieTimeout 函数。
  • 发布了异步 GA 代码段。如需了解如何试用,请参阅这份文档

  • _setVar 函数现已弃用。自定义变量功能替换了 _setVar。如需了解详情,请参阅这份文档

在此版本中:

  • 新增了一个函数,用于检索访问者一级的自定义变量。如需了解详情,请参阅这份函数文档

    • _getVisitorCustomVar(index)
  • 执行 ga.js 时将立即加载网站内点击量分布图内容,而不是等待 window.onload。

此版本新增了一项功能:

  • _addOrganic 函数中新增了可选的布尔值参数,以指定自然来源列表的开头和结尾是否添加了新的自然来源。如需了解详情,请参阅这份文档

    • _addOrganic(newOrganicEngine, newOrganicKeyword, opt_prepend)

此版本进行了一些性能改进和重构方面的常规维护。公开 API 或功能没有变化。

此版本新增了一些功能并弃用了一些旧功能:

  • 以下维度和指标现已弃用。我们将在一个月内将其从我们的 API 中永久移除。请务必更新您的代码,以便您的应用正常运行:

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • 重命名了以下维度:

    • ga:countOfVisits 现为 ga:visitCount
    • ga:countOfVisitsToATransaction 现为 ga:visitsToTransaction
  • 所有事件跟踪数据现在按 2 个新组显示:

    D7. 事件(维度)* ga:eventCategory * ga:eventAction * ga:eventLabel

    M7. 事件(指标)* ga:eventValue * ga:totalEvents * ga:uniqueEvents

  • 整体网站导航数据现在通过以下维度显示:

    D6. 导航 * ga:previousPagePath * ga:nextPagePath

  • 着陆页导航现在通过以下维度显示:

    D3. 内容 * ga:landingPagePath * ga:secondPagePath

  • 在数据 Feed 的过滤器查询参数中,正则表达式的长度上限从 32 个字符增加到了 128 个字符。

  • “访问时长”报告(位于界面的“访问者”->“访问者忠诚度”下)现在通过新的维度显示:

    • ga:visitLength

此版本修复了多个问题并改进了性能:

  • 在与链接器功能(即:_link_linkByPost 函数)一起使用时,会对自然搜索的搜索字词、(utmp) 的网页路径信息以及用户指定的值进行正确的编码。
  • 自然搜索列表中新增了搜索引擎 Rambler。
  • 更正了搜索引擎 http://kvasir.no 的自然搜索解析。
  • 现在会将用户定义的新自然搜索引擎添加到列表顶部。
  • 移除了已弃用的 _trackEvent(action, label, value) 函数,取而代之的是 _trackEvent(category, action, label, value)
  • 现在保存引荐来源网址时将区分大小写。例如:www.domain.com/PaGe.HtMl 在报告时将包含大小写信息。
  • 新增了 GASO 令牌大小不得超过 1200 个字符的限制。
  • 新增了允许替换 Cookie 的默认超时的函数:_setCookiePersistence(timeout)

此版本更新了 Google Analytics(分析)Data Export API,具体内容如下:

  • 放宽了对维度和指标组合的某些限制。现在,您可以同时查询大部分的内容和访问者一级的维度,例如,ga:pagePathga:source 现在是一个有效组合。如需了解这些新组合,请参阅更新后的参考指南:http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html

  • 一个请求中可以请求的总行数增加到了 10,000。默认返回行数仍为 1,000,但现可通过设置 max-results 查询参数来增加行数。

  • 帐号 Feed 现可为每个表格 ID 返回 2 种新数据元素(币种和时区)。
    <dxp:property name="ga:currency" value="USD"></dxp:property>
    <dxp:property name="ga:timezone" value="America/Los_Angeles"></dxp:property>

  • 我们现在要求数据查询必须包含至少一个有效的指标。

  • 此前的所有弃用更改均已生效。

此版本从非公开 Beta 版中移除了以下弃用的功能:

  • 帐号 Feed 请求不再支持在其中使用用户名,而是仅接受采用以下格式的请求:
    https://www.google.com/analytics/feeds/accounts/default

  • 以下指标将被移除并不再使用。不过,我们提供了有关如何计算这些值的说明,请点击此处了解详情:http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html

    • ga:avgPageDuration
    • ga:avgPageviews
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga:abandonedFunnels1
    • ga:abandonedFunnels2
    • ga:abandonedFunnels3
    • ga:abandonedFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit
  • 重命名了以下维度和指标。旧名称将不再使用。请点击以下网址,确认您使用的是我们在文档中提供的官方名称:http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    维度 * ga:subContinentRegion ⇒ ga:subContinent * ga:organization ⇒ ga:networkLocation * ga:domain ⇒ ga:networkDomain * ga:visitNumber ⇒ ga:countOfVisits * ga:platform ⇒ ga:operatingSystem * ga:platformVersion ⇒ ga:operatingSystemVersion * ga:content ⇒ ga:adContent * ga:requestUri ⇒ ga:pagePath * ga:requestUri1 ⇒ ga:landingPagePath * ga:requestUriLast ⇒ ga:exitPagePath * ga:internalSearchNext ⇒ ga:searchKeywordRefinement * ga:internalSearchKeyword ⇒ ga:searchKeyword * ga:internalSearchType ⇒ ga:searchCategory * ga:hasInternalSearch ⇒ ga:searchUsed * ga:requestUriFrom ⇒ ga:searchStartPage * ga:requestUriTo ⇒ ga:searchDestinationPage * ga:productCode ⇒ ga:productSku

    指标 * ga:newVisitors ⇒ ga:newVisits * ga:pageDuration ⇒ ga:timeOnPage * ga:visitDuration ⇒ ga:timeOnSite * ga:cost ⇒ ga:adCost * ga:clicks ⇒ ga:adClicks * ga:clickThroughRate ⇒ ga:CTR * ga:costPerClick ⇒ ga:CPC * ga:costPerMilleImpressions ⇒ ga:CPM * ga:searchTransitions ⇒ ga:searchRefinements * ga:uniqueInternalSearches ⇒ ga:searchUniques * ga:visitsWithSearches ⇒ ga:searchVisits * ga:productPurchases ⇒ ga:itemQuantity * ga:productRevenue ⇒ ga:itemRevenue * ga:products ⇒ ga:uniquePurchases * ga:revenue ⇒ ga:transactionRevenue * ga:shipping ⇒ ga:transactionShipping * ga:tax ⇒ ga:transactionTax * ga:goalCompletions1 ⇒ ga:goal1Completions * ga:goalCompletions2 ⇒ ga:goal2Completions * ga:goalCompletions3 ⇒ ga:goal3Completions * ga:goalCompletions4 ⇒ ga:goal4Completions * ga:goalStarts1 ⇒ ga:goal1Starts * ga:goalStarts2 ⇒ ga:goal2Starts * ga:goalStarts3 ⇒ ga:goal3Starts * ga:goalStarts4 ⇒ ga:goal4Starts * ga:goalValue1 ⇒ ga:goal1Value * ga:goalValue2 ⇒ ga:goal2Value * ga:goalValue3 ⇒ ga:goal3Value * ga:goalValue4 ⇒ ga:goal4Value