Google Analytics(分析)- 所有报告 API 变更日志

本页记录了对 Google Analytics(分析)报告 API 所做的任何变更。其中包括 Core Reporting API 和 Multi-Channel Funnels Reporting API 的变更日志。我们建议 API 开发者定期查看此列表,及时了解最新信息。您还可以通过下文订阅部分中列出的 Feed 订阅变更日志。

订阅相关变更日志

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

包括 Core Reporting API、Multi-Channel Funnels Reporting API 和 Real Time Reporting API。

这是 User Activity API 的初始版本

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

在此版本中,适用于 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) 客户可以使用更高的抽样阈值。

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

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

  • 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 账号的数据视图查询此类维度和指标,则会导致错误。

这是一个问题修复版本,此版本修复了 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 的新定义。您可以在变更发生之前使用此指标了解新定义。请注意,此指标为不公开指标,不会显示在维度和指标参考中。

此版本为 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 个维度
  • 数据透视维度属于对请求中所允许维度总数的限制。
  • 数据透视metrics属于对请求中所允许指标总数的限制。

此版本为 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。

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

包含空行

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

此版本为 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 天内的唯一身份用户总数(截至指定日期)。

此版本为 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 - 可见广告展示次数占总广告展示次数的百分比。当广告显示在用户的浏览器中并可能会被用户看到时,我们就将这次展示视为一次可见的展示。

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

已弃用的维度

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

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

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

AdWords

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

此版本为 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 开发者指南

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

ECommerce

  • 指标 - 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

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

AdWords

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

已弃用的维度和指标

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

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

时间

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

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

AdSense

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

此版本为 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 版)。

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

维度和指标

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

内容分组

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

此版本为细分功能新增了 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。

此版本弃用了 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

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

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

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

弃用了 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 - 屏幕浏览总量。

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

转化路径

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

互动次数

  • 维度 - mcf:adwordsCustomerID - 对应于 AdWords API Customer.id

此版本为 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

此版本为 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://en.wikipedia.org/wiki/ISO_week_datega:isoYear 应仅与 ga:isoWeek 搭配使用,因为 ga:week 表示公历。
  • 维度 - ga:isoYearIsoWeek - ga:isoYearga:isoWeek 的组合值。

AdWords

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

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

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

相对日期
  • 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 参考文档抽样

这是 Metadata API 的初始版本:

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

这是 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 的现有默认细分将不受影响。但是,新默认细分目前不受支持。

此版本为 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://en.wikipedia.org/wiki/ISO_week_date
  • 维度 - ga:yearMonth - ga:yearga:month 的组合值。
  • 维度 - ga:yearWeek - ga:yearga:week 的组合值。

流量来源

  • 维度 - ga:fullReferrer - 包含主机名和路径的完整引荐来源网址。
  • 维度 - ga:sourceMedium - ga:sourcega:medium 的组合值。
  • 此版本新增了 2 个实验指标:- ga:experimentId - ga:experimentVariant
  • 此版本新增了 5 个网站速度指标:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • 此版本为“平板电脑流量”新增了一个默认细分 gaid::-13

此版本为 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 - 用来识别移动设备的品牌、型号和宣传名称。

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

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

bug 修复

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

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

此版本修复了 2 个错误:

bug 修复

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

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

此版本为 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 令牌)。

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

此版本会影响所有 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 完成。

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

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

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

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

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

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

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

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

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

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

弃用置信区间

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

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

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

新的数据更新

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

指标更新

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

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

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

性能改进

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

新的数据更新

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

即将进行的更改

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

  • 目前,ga:CTRpercent 并返回值 0.02。在不久的将来,这将更改为返回实际百分比值(如 2)。

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

新的数据更新

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

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

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

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

即将进行的更改

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

此版本为数据 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 库,增加了用于访问此元素的辅助方法。

此版本修复了 2 个错误:

bug 修复

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

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

此版本修复了 3 个错误:

bug 修复

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

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

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

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

新功能

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

bug 修复

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

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

新增了几项功能

  • 增强了 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 元素和属性来描述细分数据:

    • ga:visitorType==Returning Visitor
  • 数据 Feed 还提供一个 XML 元素,用于表明细分是否应用到了 API 请求中。

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

推出新的目标数据

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

  • 为目标 5-20 新增了 48 个目标指标,这些指标全部遵循 goal(n)Completions 命名约定,其中 (n) 为 1 至 20 之间的数字。

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

新的自定义变量数据

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

  • 为自定义变量新增了 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

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

  • 以下维度和指标现已弃用。我们将在一个月内将其从我们的 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

此版本更新了 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 返回两种新数据元素(币种和时区)。

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

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

此版本从非公开 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