更新日志

如需获取官方 Google Analytics（分析）API 公告，请订阅 Google Analytics（分析）API 通知群组。

2024 年 3 月 25 日：添加了主要渠道组、手动流量来源和集成专用维度。

向 Data API 架构中添加了主要渠道组、人工流量来源以及 CM360、DV360、SA360 集成专用维度。

受众群体维度：

• audienceId受众群体 ID。受众群体的数字标识符。

主要渠道组维度：

• firstUserPrimaryChannelGroup带来用户首次互动的主渠道组

• primaryChannelGroup 个主渠道组

• sessionPrimaryChannelGroup 个带来会话的主渠道组

人工流量来源维度：

• manualCampaignId 人工广告系列 ID

• manualCampaignName 人工广告系列名称

• manualCreativeFormat 手动创建的广告素材格式

• manualMarketingTactic 人工营销策略

• manualMedium 人工介质

• manualSource 人工来源

• manualSourceMedium 人工来源 / 媒介

• manualSourcePlatform 人工来源平台

• firstUserManualCampaignId 带来用户首次互动的人工广告系列 ID

• firstUserManualCampaignName 带来用户首次互动的人工广告系列名称

• firstUserManualCreativeFormat带来用户首次互动的人工广告素材格式

• firstUserManualMarketingTactic 带来用户首次互动的人工营销策略

• firstUserManualMedium 带来用户首次互动的人工媒介

• firstUserManualSource带来用户首次互动的人工来源

• firstUserManualSourceMedium 带来用户首次互动的人工来源 / 媒介

• firstUserManualSourcePlatform带来用户首次互动的人工来源平台

• sessionManualCampaignId 个带来会话的人工广告系列 ID

• sessionManualCampaignName 带来会话的人工广告系列名称

• sessionManualCreativeFormat 带来会话的人工广告素材格式

• sessionManualMarketingTactic 带来会话的人工营销策略

• sessionManualMedium 个带来会话的手动创建媒介

• sessionManualSource 个带来会话的人工来源

• sessionManualSourceMedium 带来会话的人工来源 / 媒介

• sessionManualSourcePlatform 个带来会话的人工来源平台

Campaign Manager 360 (CM360) 集成维度：

• cm360AccountId CM360 账号 ID

• cm360AccountName CM360 账号名称

• cm360AdvertiserId CM360 广告客户 ID

• cm360AdvertiserName CM360 广告客户名称

• cm360CampaignId 个 CM360 广告系列 ID

• cm360CampaignName CM360 广告系列名称

• cm360CreativeFormat CM360 广告素材格式

• cm360CreativeId 个 CM360 广告素材 ID

• cm360CreativeName CM360 广告素材名称

• cm360CreativeType 种 CM360 广告素材类型

• cm360CreativeTypeId 个 CM360 广告素材类型 ID

• cm360CreativeVersion 个 CM360 广告素材版本

• cm360Medium CM360 媒介

• cm360PlacementCostStructure CM360 展示位置费用结构

• cm360PlacementId 个 CM360 展示位置 ID

• cm360PlacementName CM360 展示位置名称

• cm360RenderingId CM360 呈现 ID

• cm360SiteId CM360 网站 ID

• cm360SiteName CM360 网站名称

• cm360Source 个 CM360 来源

• cm360SourceMedium CM360 来源 / 媒介

• firstUserCm360AccountId 带来用户首次互动的 CM360 账号 ID

• firstUserCm360AccountName带来用户首次互动的 CM360 账号名称

• firstUserCm360AdvertiserId 带来用户首次互动的 CM360 广告客户 ID

• firstUserCm360AdvertiserName 带来用户首次互动的 CM360 广告客户名称

• firstUserCm360CampaignId 带来用户首次互动的 CM360 广告系列 ID

• firstUserCm360CampaignName 带来用户首次互动的 CM360 广告系列名称

• firstUserCm360CreativeFormat带来用户首次互动的 CM360 广告素材格式

• firstUserCm360CreativeId 带来用户首次互动的 CM360 广告素材 ID

• firstUserCm360CreativeName带来用户首次互动的 CM360 广告素材名称

• firstUserCm360CreativeType 带来用户首次互动的 CM360 广告素材类型

• firstUserCm360CreativeTypeId 带来用户首次互动的 CM360 广告素材类型 ID

• firstUserCm360CreativeVersion带来用户首次互动的 CM360 广告素材版本

• firstUserCm360Medium 带来用户首次互动的 CM360 媒介

• firstUserCm360PlacementCostStructure带来用户首次互动的 CM360 展示位置费用结构

• firstUserCm360PlacementId 带来用户首次互动的 CM360 展示位置 ID

• firstUserCm360PlacementName 带来用户首次互动的 CM360 展示位置名称

• firstUserCm360RenderingId 带来用户首次互动的 CM360 呈现 ID

• firstUserCm360SiteId 带来用户首次互动的 CM360 网站 ID

• firstUserCm360SiteName 带来用户首次互动的 CM360 网站名称

• firstUserCm360Source 带来用户首次互动的 CM360 来源

• firstUserCm360SourceMedium带来用户首次互动的 CM360 来源 / 媒介

• sessionCm360AccountId 个带来会话的 CM360 账号 ID

• sessionCm360AccountName 个带来会话的 CM360 账号名称

• sessionCm360AdvertiserId 个带来会话的 CM360 广告客户 ID

• sessionCm360AdvertiserName 带来会话的 CM360 广告客户名称

• sessionCm360CampaignId 个带来会话的 CM360 广告系列 ID

• sessionCm360CampaignName 带来会话的 CM360 广告系列名称

• sessionCm360CreativeFormat 个带来会话的 CM360 广告素材格式

• sessionCm360CreativeId 个带来会话的 CM360 广告素材 ID

• sessionCm360CreativeName 个带来会话的 CM360 广告素材名称

• sessionCm360CreativeType 种带来会话的 CM360 广告素材类型

• sessionCm360CreativeTypeId 个带来会话的 CM360 广告素材类型 ID

• sessionCm360CreativeVersion 个带来会话的 CM360 广告素材版本

• sessionCm360Medium 个带来会话的 CM360 媒介

• sessionCm360PlacementCostStructure 带来会话的 CM360 展示位置费用结构

• sessionCm360PlacementId 个带来会话的 CM360 展示位置 ID

• sessionCm360PlacementName 个带来会话的 CM360 展示位置名称

• sessionCm360RenderingId 带来会话的 CM360 呈现 ID

• sessionCm360SiteId 个带来会话的 CM360 网站 ID

• sessionCm360SiteName 次带来会话的 CM360 网站名称

• sessionCm360Source 个带来会话的 CM360 来源

• sessionCm360SourceMedium 个带来会话的 CM360 来源 / 媒介

Google Display & Video 360 (DV360) 集成维度：

• dv360AdvertiserId 个 DV360 广告客户 ID

• dv360AdvertiserName DV360 广告客户名称

• dv360CampaignId 个 DV360 广告系列 ID

• dv360CampaignName 个 DV360 广告系列名称

• dv360CreativeFormat 个 DV360 广告素材格式

• dv360CreativeId 个 DV360 广告素材 ID

• dv360CreativeName DV360 广告素材名称

• dv360ExchangeId 个 DV360 广告交易平台 ID

• dv360ExchangeName DV360 广告交易平台名称

• dv360InsertionOrderId 个 DV360 广告订单 ID

• dv360InsertionOrderName 个 DV360 广告订单名称

• dv360LineItemId 个 DV360 订单项 ID

• dv360LineItemName 个 DV360 订单项名称

• dv360Medium DV360 媒介

• dv360PartnerId 个 DV360 合作伙伴 ID

• dv360PartnerName DV360 合作伙伴名称

• dv360Source 个 DV360 来源

• dv360SourceMedium 个 DV360 来源 / 媒介

• firstUserDv360AdvertiserId 带来用户首次互动的 DV360 广告客户 ID

• firstUserDv360AdvertiserName 带来用户首次互动的 DV360 广告客户名称

• firstUserDv360CampaignId 带来用户首次互动的 DV360 广告系列 ID

• firstUserDv360CampaignName 带来用户首次互动的 DV360 广告系列名称

• firstUserDv360CreativeFormat 带来用户首次互动的 DV360 广告素材格式

• firstUserDv360CreativeId 带来用户首次互动的 DV360 广告素材 ID

• firstUserDv360CreativeName 带来用户首次互动的 DV360 广告素材名称

• firstUserDv360ExchangeId 带来用户首次互动的 DV360 广告交易平台 ID

• firstUserDv360ExchangeName 带来用户首次互动的 DV360 广告交易平台名称

• firstUserDv360InsertionOrderId 带来用户首次互动的 DV360 广告订单 ID

• firstUserDv360InsertionOrderName 带来用户首次互动的 DV360 广告订单名称

• firstUserDv360LineItemId 带来用户首次互动的 DV360 订单项 ID

• firstUserDv360LinteItemName 带来用户首次互动的 DV360 订单项名称

• firstUserDv360Medium 带来用户首次互动的 DV360 媒介

• firstUserDv360PartnerId 带来用户首次互动的 DV360 合作伙伴 ID

• firstUserDv360PartnerName 带来用户首次互动的 DV360 合作伙伴名称

• firstUserDv360Source 带来用户首次互动的 DV360 来源

• firstUserDv360SourceMedium 带来用户首次互动的 DV360 来源 / 媒介

• sessionDv360AdvertiserId 个带来会话的 DV360 广告客户 ID

• sessionDv360AdvertiserName 带来会话的 DV360 广告客户名称

• sessionDv360CampaignId 个带来会话的 DV360 广告系列 ID

• sessionDv360CampaignName 个带来会话的 DV360 广告系列名称

• sessionDv360CreativeFormat 个带来会话的 DV360 广告素材格式

• sessionDv360CreativeId 个带来会话的 DV360 广告素材 ID

• sessionDv360CreativeName 个带来会话的 DV360 广告素材名称

• sessionDv360ExchangeId 个带来会话的 DV360 广告交易平台 ID

• sessionDv360ExchangeName 带来会话的 DV360 广告交易平台名称

• sessionDv360InsertionOrderId 个带来会话的 DV360 广告订单 ID

• sessionDv360InsertionOrderName 个带来会话的 DV360 广告订单名称

• sessionDv360LineItemId 个带来会话的 DV360 订单项 ID

• sessionDv360LineItemName 个带来会话的 DV360 订单项名称

• sessionDv360Medium 个带来会话的 DV360 媒介

• sessionDv360PartnerId 个带来会话的 DV360 合作伙伴 ID

• sessionDv360PartnerName 个带来会话的 DV360 合作伙伴名称

• sessionDv360Source 个带来会话的 DV360 来源

• sessionDv360SourceMedium 个带来会话的 DV360 来源 / 媒介

Google Search Ads 360 (SA360) 集成维度：

• firstUserSa360AdGroupId 带来用户首次互动的 SA360 广告组 ID

• firstUserSa360AdGroupName带来用户首次互动的 SA360 广告组名称

• firstUserSa360CampaignId 带来用户首次互动的 SA360 广告系列 ID

• firstUserSa360CampaignName带来用户首次互动的 SA360 广告系列

• firstUserSa360CreativeFormat带来用户首次互动的 SA360 广告素材格式

• firstUserSa360EngineAccountId 带来用户首次互动的 SA360 引擎账号 ID

• firstUserSa360EngineAccountName带来用户首次互动的 SA360 引擎账号名称

• firstUserSa360EngineAccountType 带来用户首次互动的 SA360 引擎账号类型

• firstUserSa360KeywordText 带来用户首次互动的 SA360 关键字文字

• firstUserSa360ManagerAccountId带来用户首次互动的 SA360 经理账号 ID

• firstUserSa360ManagerAccountName带来用户首次互动的 SA360 经理账号名称

• firstUserSa360Medium带来用户首次互动的 SA360 媒介

• firstUserSa360Query 带来用户首次互动的 SA360 查询

• firstUserSa360Source带来用户首次互动的 SA360 来源

• firstUserSa360SourceMedium带来用户首次互动的 SA360 来源 / 媒介

• sa360AdGroupId 个 SA360 广告组 ID

• sa360CampaignId 个 SA360 广告系列 ID

• sa360AdGroupName 个 SA360 广告组名称

• sa360CampaignName 个 SA360 广告系列

• sa360CreativeFormat 个 SA360 广告素材格式

• sa360EngineAccountId 个 SA360 引擎账号 ID

• sa360EngineAccountName SA360 引擎账号名称

• sa360EngineAccountType 个 SA360 引擎帐号类型

• sa360KeywordText SA360 关键字文字

• sa360ManagerAccountId 个 SA360 经理账号 ID

• sa360ManagerAccountName SA360 经理账号名称

• sa360Medium 个 SA360 媒介

• sa360Query 个 SA360 查询

• sa360Source 个 SA360 来源

• sa360SourceMedium 个 SA360 来源 / 媒介

• sessionSa360AdGroupId 个带来会话的 SA360 广告组 ID

• sessionSa360CampaignId 个带来会话的 SA360 广告系列 ID

• sessionSa360ManagerAccountId 带来会话的 SA360 经理账号 ID

• sessionSa360ManagerAccountName带来会话的 SA360 经理账号名称

• sessionSa360SourceMedium 带来会话的 SA360 来源 / 媒介

2024 年 3 月 6 日：受众群体导出功能支持非活跃用户受众群体。

受众群体导出功能更好地支持导出非活跃用户受众群体。 用户在没有符合条件的事件的情况下输入这些受众群体；例如，用户可以在七天内不访问您的网站就进入受众群体。非活跃用户受众群体的示例包括“7 天内不活跃的购买者”“7 天不活跃的用户”和“7 天内未收到通知的用户”。如需详细了解这些建议的受众群体，请参阅建议的受众群体。

2024 年 2 月 28 日：受众群体导出功能会返回代码植入中指定的用户 ID。

现在，即使您的媒体资源启用了用户提供的数据，受众群体导出功能也会返回代码中指定的用户 ID。如果开启了“收集用户提供的数据”功能，系统会将用户提供的数据及 User-ID 发送到 Google Analytics（分析）以植入代码，以改进衡量效果。如需了解详情，请参阅收集用户提供的数据。

2024 年 1 月 30 日：为受众群体名单提供网络钩子通知支持，Data API v1 Alpha 版中支持定期创建受众群体名单。

创建受众群体名单（使用 properties.audienceLists.create）或周期性受众群体名单（使用 properties.recurringAudienceLists.create）时，可以指定 AudienceList.webhookNotification 和 RecurringAudienceList.webhookNotification 字段。

借助此功能，您可以在受众群体名单可用时异步接收网络钩子通知。

2024 年 1 月 18 日 改进了对包含查询字符串或分钟组成部分的维度的兼容性。

包含查询字符串的维度现在与大多数字段兼容。pagePathPlusQueryString、unifiedPageScreen、pageLocation 和 fullPageUrl 等维度现在与许多其他字段兼容，包括 sessionSource、browser、city 和 landingPage。

包含分钟组成部分的维度现在与大多数字段兼容。minute、nthMinute 和 dateHourMinute 等维度现在与一组类似的其他字段兼容。

如需了解全面的兼容性信息，请参阅 GA4 维度和指标浏览器。

2023 年 12 月 13 日：自定义商品级范围的参数

现在，可以使用以下语法将商品级范围的自定义维度添加到 Google Analytics（分析）Data API 查询中：

通用 API 名称	说明
customItem:parameter_name	参数_name 的商品级范围的自定义维度

如需了解详情，请参阅 API 维度和指标。

2023 年 12 月 5 日：受众群体名单在 Data API v1 Beta 版中以受众群体导出功能的形式提供

受众群体名单功能已重命名为受众群体导出，并已添加到 Data API v1 Beta 版中。

向 Data API v1 Beta 版添加了以下方法：

• properties.audienceExports.create

• properties.audienceExports.get

• properties.audienceExports.list

• properties.audienceExports.query

2023 年 11 月 28 日：添加了 samplingMetadatas 以报告响应

向 ResponseMetaData 添加了 samplingMetadatas。此集合将包含对结果进行抽样请求中的每个日期范围的 SampleMetadata。只有当 Google Analytics（分析）预计基数限制会降低数据质量时，才会应用抽样。

2023 年 11 月 28 日：在 Data API v1 Alpha 版中添加了周期性受众群体名单导出功能

向 Data API v1 Alpha 版添加了 properties.recurringAudienceLists.create、properties.recurringAudienceLists.create、properties.recurringAudienceLists.list 方法。

借助此功能，您可以每天随着受众群体成员资格发生变化而生成受众群体名单。周期性受众群体名单可确保您获取最新的受众群体成员资格结果。

2023 年 11 月 8 日：在 Data API v1 Alpha 版中增加了将受众群体名单导出至 Google 表格的功能

向 Data API v1 Alpha 版添加了 properties.audienceLists.exportSheet 方法，让您可以将受众群体名单导出到 Google 表格。

2023 年 10 月 13 日：新增了对成员资格有效期为 1 天的受众群体的支持

现在，受众群体名单导出功能支持成员资格有效期为 1 天的受众群体。

2023 年 9 月 12 日：受众群体名单默认排序规则

默认情况下，使用受众群体名单导出功能创建的报告遵循与 Data API 的其他报告方法相同的排序规则：按第一列降序排序，然后按第二列降序排序，依此类推。

在此次变更之前，您可能会收到以下报告：

deviceId	isAdsPersonalizationAllowed
ABC	true
DAC	false
ABC	false
AAA	true

完成此更改后，您会收到以下报告：

deviceId	isAdsPersonalizationAllowed
AAA	true
ABC	false
ABC	true
DAC	false

2023 年 8 月 15 日：向受众群体名单导出架构中添加了 isLimitedAdTracking 维度

• isLimitedAdTracking设备的“限制广告跟踪”设置。可能的值包括 true、false 和 (not set)。

  如需了解详情，请参阅受众群体名单维度。

2023 年 8 月 15 日：新增了 currencyCode 维度和 itemDiscountAmount 指标

• currencyCode：电子商务事件的本地货币代码（基于 ISO 4217 标准）。例如，“USD”或“GBP”。

• itemDiscountAmount：电子商务事件中商品折扣的货币价值。此指标通过“discount”商品参数在代码中填充。

如需了解详情，请参阅 Data API 报告架构。

2023 年 8 月 10 日：向受众群体名单导出架构中添加了 isAdsPersonalizationAllowed 维度

• isAdsPersonalizationAllowed：是否允许广告个性化。 如果用户符合广告个性化条件，isAdsPersonalizationAllowed 将返回 true。如果用户不符合广告个性化条件，isAdsPersonalizationAllowed 会返回 false。

  如需了解详情，请参阅受众群体名单维度。

2023 年 7 月 10 日：受众群体名单

Data API v1 Alpha 版中新增了受众群体名单支持。受众群体名单包含创建受众群体名单时受众群体中用户的概况。

添加到 Data API v1 Alpha 版中的以下方法：

• properties.audienceLists.create

• properties.audienceLists.get

• properties.audienceLists.list

• properties.audienceLists.query

2023 年 5 月 19 日 自定义渠道组

Data API 中新增了自定义渠道组支持。

2023 年 5 月 11 日 令牌配额发生变化。

Data API 的配额系统已更新，现在能够进行更精确的费用。

针对每个请求收费的令牌数量已根据配额变化进行更新，并重新进行平衡，以支持更多数量的简单报告查询，同时针对大型日期报告收取更多配额令牌。

此变更生效后，虽然某些请求的费用将保持不变，但对于更复杂的查询，费用将会明显增加。例如，对于 6 个月以上数据的请求，系统可能会针对 1,000 个或更多配额令牌收取费用。

标准媒体资源

配额名称	旧限制	新限制
每项媒体资源每天的核心令牌数	25000	200000
每项媒体资源每小时的核心令牌数	5,000	40000
每个项目每项媒体资源每小时的核心令牌数	1750	14000
每项媒体资源每天的实时令牌数	25000	200000
每项媒体资源每小时的实时令牌数	5,000	40000
每个项目每项媒体资源每小时的实时令牌数	1750	14000
每项媒体资源每天的漏斗令牌数	25000	200000
每项媒体资源每小时的漏斗令牌数	5,000	40000
每个项目每项媒体资源每小时的漏斗令牌数	1750	14000

Analytics 360 媒体资源

配额名称	旧限制	新限制
每项媒体资源每天的核心令牌数	250000	200 万
每项媒体资源每小时的核心令牌数	5 万	400,000
每个项目每项媒体资源每小时的核心令牌数	17500	140000
每项媒体资源每天的实时令牌数	250000	200 万
每项媒体资源每小时的实时令牌数	5 万	400,000
每个项目每项媒体资源每小时的实时令牌数	17500	140000
每项媒体资源每天的漏斗令牌数	250000	200 万
每项媒体资源每小时的漏斗令牌数	5 万	400,000
每个项目每项媒体资源每小时的漏斗令牌数	17500	140000

2023 年 3 月 2 日：新增了日期维度。

• dayOfWeekName星期几名称。英文的“一周中的某一天”。此维度的值包括“Sunday”“Monday”等。

• ISO 周序号为 isoWeek。ISO 周数，每周从星期一开始。如需了解详情，请参阅 https://en.wikipedia.org/wiki/ISO_week_date。示例值包括 01、02 和 53。

• isoYear ISO 年份。事件的 ISO 年份。如需了解详情，请参阅 https://en.wikipedia.org/wiki/ISO_week_date。示例值包括 2022 和 2023。

• ISO 年份中的 isoYearIsoWeek 周。isoWeek 和 isoYear 的组合值。示例值包括 201652 和 201701。

• yearMonth 年/月。year 和 month 的组合值。示例值包括 202212 或 202301。

• yearWeek 年当周。year 和 week 的组合值。示例值包括 202253 或 202301。

2023 年 2 月 27 日：新增了电子商务维度。

• itemListPosition 项列表位置。商品（例如您销售的产品）在列表中的位置。在代码中通过 items 数组中的“index”参数填充此维度。

• itemLocationID 商品位置 ID。与商品相关的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID。也可使用自定义地理位置 ID。在代码中，此字段由 items 数组中的“location_id”参数填充。

• itemPromotionCreativeSlot 商品推广活动广告素材投放到的广告位。与商品相关的促销广告素材投放到的广告位的名称。您可以在代码中添加事件级或商品级的 creative_slot 参数来指定此维度。如果同时在事件层级和商品层级指定该参数，则系统会使用商品级参数。

2023 年 2 月 21 日：添加了“着陆页 + 查询字符串”维度。

• landingPagePlusQueryString着陆页 + 查询字符串。与会话的首次网页浏览相关联的网页路径 + 查询字符串。

此字段取代了已废弃的 landingPage 维度，并将于 2023 年 5 月 14 日更新为不返回查询字符串。

2023 年 1 月 28 日：添加了“每位用户的浏览次数”和“滚动浏览的用户数”指标。

• 每位用户 screenPageViewsPerUser 次观看。用户每位活跃用户浏览的应用屏幕或网页的数量。对同一网页或屏幕的重复浏览也会计入。(screen_view + page_view events) / active users.

• scrolledUsers 位执行过滚动操作的用户。向下滚动至少 90% 的唯一身份用户的数量。

2023 年 1 月 23 日：添加了“大洲”“大洲 ID”维度。

• continent 个大洲。用户发起活动时所处的大洲。例如 Americas 或 Asia。

• continentId 个大洲 ID。用户发起活动时所处的大洲的地理位置 ID，依据用户的 IP 地址得出。

2023 年 1 月 23 日：新增了“测试数据过滤器 ID”维度。

• testDataFilterId 测试数据过滤器 ID。处于测试状态的数据过滤器的数字标识符。您可以使用数据过滤器根据事件参数值在报告中包含或排除事件数据。有关详情，请参阅 https://support.google.com/analytics/answer/10108813。

2022 年 10 月 18 日：新增了广告指标。

• advertiserAdClicks 次广告点击。用户点击广告访问媒体资源的总次数。
• 广告费用：advertiserAdCost。您为广告支付的总金额。
• advertiserAdCostPerClick 广告每次点击费用。“每次点击费用”是指广告费用除以广告点击次数所得的值，通常缩写为“CPC”。
• advertiserAdCostPerConversion每次转化费用。每次转化费用是指广告费用除以转化次数所得的值。
• advertiserAdImpressions 次广告展示。总展示次数。
• returnOnAdSpend广告支出回报率。广告支出回报率 (ROAS) 是指总收入除以广告客户的广告费用。

2022 年 10 月 17 日：新增了商品级范围的指标。

• itemsAddedToCart 件商品已加入购物车。单件商品添加到购物车中的商品数量。
• itemsCheckedOut 件商品已结账。为单件商品结账的件数。
• 已在列表中点击 itemsClickedInList 项内容。在列表中点击的单件商品的数量。
• 推广活动中获得点击的 itemsClickedInPromotion 件商品。用户在促销活动中点击的单件商品的数量。
• itemsViewed 件商品已查看。用户查看的单件商品的数量。
• 在列表中查看过 itemsViewedInList 项内容。在列表中查看的单个商品的数量。
• itemsViewedInPromotion 个在推广活动中获得浏览的商品。推广活动中获得浏览的单件商品的数量。

2022 年 9 月 13 日：架构兼容性变更公告。

2022 年 12 月 1 日，将发生以下破坏性更改：

1. 商品级范围的维度（如 itemName）与事件级范围的指标（如 eventCount）不再兼容。商品级范围的维度仍与商品级范围的指标（如 itemRevenue）、基于用户的指标（如 activeUsers）和基于会话的指标（如 sessions）兼容。

2. source 等归因维度与某些事件级范围的指标（如 eventCount）不兼容。归因维度仍将与可归因的指标（如 conversions）、基于用户的指标（如 activeUsers）和基于会话的指标（如 sessions）兼容。

3. 包含查询字符串（如 pagePathPlusQueryString）的维度将仅与一组有限的维度和指标兼容。

如需了解详情，请参阅兼容性变更的详细说明。

2022 年 9 月 1 日 配额变更。

• Requests per day、Requests Per Minute、Requests Per Minute Per User 配额已从 Data API 中移除。

• 已向 API 添加 Tokens Per Project Per Property Per Hour 配额。

• 每个请求都会消耗 Tokens Per Property Per Hour 和 Tokens Per Project Per Property Per Hour 的配额。

  如需详细了解新配额，请参阅配额文档。

2022 年 8 月 3 日：添加了会话级范围的 SA360 维度。

• sessionSa360AdGroupName带来会话的 SA360 广告组名称。Search Ads 360 中促成此会话的广告组名称。

• sessionSa360CampaignName带来会话的 SA360 广告系列。Search Ads 360 中促成此会话的广告系列名称。

• sessionSa360CreativeFormat带来会话的 SA360 广告素材格式。Search Ads 360 中促成此会话的广告素材类型。例如，“自适应搜索广告”或“加大型文字广告”。

• sessionSa360EngineAccountId带来会话的 SA360 引擎帐号 ID。SA360 中促成此会话的引擎账号的 ID。

• sessionSa360EngineAccountName带来会话的 SA360 引擎账号名称。SA360 中促成此会话的引擎账号的名称。

• sessionSa360EngineAccountType带来会话的 SA360 引擎帐号类型。Search Ads 360 中促成此会话的引擎帐号的类型。例如，“Google Ads”“Bing”或“百度”。

• sessionSa360Keyword带来会话的 SA360 关键字文字。促成此会话的 Search Ads 360 中的搜索引擎关键字。

• sessionSa360Medium带来会话的 SA360 媒介。促成此会话的 Search Ads 360 中的搜索引擎关键字。例如，“cpc”。

• sessionSa360Query带来会话的 SA360 查询。Search Ads 360 中促成此会话的搜索查询。

• sessionSa360Source带来会话的 SA360 来源。促成此会话的 Search Ads 360 流量来源。例如，“example.com”或“google”。

• sessionCampaignId、sessionCampaignName 维度现在支持 Search Ads 360 广告系列。

2022 年 7 月 11 日 新增了转化率指标。

转化率

• sessionConversionRate：触发了任意转化事件的会话所占的百分比。

• userConversionRate：触发了任意转化事件的用户所占的百分比。

一种转化的转化率指标

• sessionConversionRate:event_name：触发了特定转化事件的会话所占的百分比。

• userConversionRate:event_name：触发特定转化事件的用户所占的百分比。

2022 年 5 月 5 日：在 Alpha 渠道中新增了漏斗报告功能。

• 该 API 的 v1alpha 版中添加了 runFunnelReport 方法，该方法会返回 Google Analytics（分析）事件数据的自定义漏斗报告。

• 此方法是在 Alpha 版稳定性阶段推出的，目的是在进入 Beta 版之前收集有关语法和功能的反馈。请填写 Google Analytics（分析）Data API 漏斗报告反馈，提供您对此 API 的反馈。

2022 年 2 月 16 日：新增了维度。

人工字词和内容

• firstUserManualAdContent带来用户首次互动的人工广告内容。最先获取到用户的广告内容。由 utm_content 参数填充。

• firstUserManualTerm带来用户首次互动的人工字词。最先获取到用户的字词。由 utm_term 参数填充。

• manualAdContent 人工广告内容。归因于转化事件的广告内容。由 utm_content 参数填充。

• manualTerm人工字词。归因于转化事件的字词。 由 utm_term 参数填充。

• sessionManualAdContent 带来会话的人工广告内容。促成会话的广告内容。由 utm_content 参数填充。

• sessionManualTerm带来会话的人工字词。促成会话的字词。 由 utm_term 参数填充。

崩溃分析

• crashAffectedUsers 位受崩溃影响的用户。在报告的这一行中 记录了崩溃的用户数量

• crashFreeUsersRate未遇到崩溃问题的用户率。

应用/网站

• averageSessionDuration：用户会话的平均时长（以秒为单位）。

• newVsReturning新用户 / 回访用户。

• 每次会话的观看次数为 screenPageViewsPerSession 次。

• landingPage着陆页。与会话的首次网页浏览相关联的网页路径 + 查询字符串。

• platformDeviceCategory：您的网站或移动应用运行所在的平台和设备类型。

移动应用

• averagePurchaseRevenuePerUser用户平均购买收入。

• firstTimePurchaserConversionRate 首次购买的活跃用户所占的百分比。

• firstTimePurchasersPerNewUser：每位新用户的平均首次购买者人数。

• 日活 / 月活为 dauPerMau。既是过去 30 天活跃过的用户又是过去 1 天活跃用户的滚动百分比。

• 日活 / 周活：dauPerWau。既是 7 天活跃用户又是 1 天活跃用户的滚动百分比。

• wauPerMau 周活 / 月活。既是 30 天活跃用户又是 7 天活跃用户的滚动百分比。

• purchaserConversionRate 完成一次或多次购买交易的活跃用户所占的百分比。

• 每位购买者的交易次数为 transactionsPerPurchaser 次。

Google Ads 广告系列

• firstUserGoogleAdsCampaignType：首次获取了用户的 Google Ads 广告系列的广告系列类型。

• googleAdsCampaignType归因于转化事件的 Google Ads 广告系列的广告系列类型。

• sessionGoogleAdsCampaignType促成此会话的 Google Ads 广告系列的广告系列类型。

2021 年 9 月 7 日：新增了“日期/时间”维度。

• dateHourMinute：日期、小时和分钟的组合值，格式为 YYYYMMDDHHMM。

• minute：记录事件的小时中的两位数分钟。

• nthMinute：自日期范围的起始日期起经过的分钟数。

2021 年 9 月 7 日：新增了由事件参数填充的维度。

• achievementId：游戏中某项活动的成就 ID。

• character：游戏中针对某个事件的玩家角色。

• fileExtension：所下载文件的扩展名。

• fileName：已下载文件的网页路径。

• groupId：游戏中与事件的玩家组 ID 对应的 ID。

• linkClasses：出站链接的 HTML 类属性。

• linkDomain：出站链接的目标网域。

• linkId：出站链接或文件下载的 HTML ID 属性。

• linkText：文件下载的链接文字。

• linkUrl：出站链接或文件下载的完整网址。

• method：触发事件的方法。

• outbound 如果指向某个网站的链接不属于相应媒体资源的网域，会返回“true”。

• pageLocation：所访问网页的协议、主机名、网页路径和查询字符串。

• pageReferrer：包含主机名和路径的完整引荐来源网址。

• percentScrolled：用户向下滚动页面的百分比（例如“90”）。

• searchTerm：用户搜索过的字词。

• videoProvider：视频的来源（例如“youtube”）。

• videoTitle：视频的标题。

• videoUrl：视频的网址。

• visible如果内容可见，则返回“true”。

• unifiedPagePathScreen：记录事件的网页路径（网站）或屏幕类（应用）。

2021 年 9 月 7 日：API 架构变更。

现有维度的变化：

• unifiedPageScreen 对于网站生成的事件，此维度现在会返回记录事件的网页路径和查询字符串。

即将发布的变更公告：

• firstUserTrafficOrigin：最先获取到用户的流量来源。对于使用 UTM 的流量，请勿依赖此字段返回“Manual”；对于即将推出的功能，此字段将从返回“Manual”更新为返回“(not set)”。

• sessionTrafficOrigin：会话的广告系列的流量来源。 对于使用 UTM 的流量，请勿依赖此字段返回“Manual”；对于即将推出的功能，此字段将从返回“Manual”更新为返回“(not set)”。

• trafficOrigin：转化事件所属的广告系列的流量来源。对于使用 UTM 的流量，请勿依赖此字段返回“Manual”；对于即将推出的功能，此字段将从返回“Manual”更新为返回“(not set)”。

2021 年 9 月 7 日：向 API 中添加了 checkCompatibility 方法。

checkCompatibility 方法会列出可添加到报告请求并保持兼容性的维度和指标。

2021 年 7 月 21 日 - 实时报告变更。

现在可以使用 runRealtimeReport 方法的 minuteRanges 参数指定要读取的事件数据的分钟范围。

2021 年 7 月 21 日：新增渠道分组维度。

Data API 报告架构中新增了渠道分组维度：

• firstUserDefaultChannelGrouping带来用户首次互动的默认渠道分组。

• defaultChannelGrouping默认渠道分组。

2021 年 6 月 10 日 API 架构变更。

• minutesAgo 维度已添加至 Data API 实时架构，可用于对 runRealtimeReport 方法的查询。此维度包含事件收集的分钟数。00 表示当前分钟，01 表示前一分钟。

• 向 Data API 架构中添加了 googleAdsCreativeId 个维度。此维度包含归因于转化事件的 Google Ads 广告素材的 ID。

• 向 Data API 架构中添加了 sessionGoogleAdsCreativeId 个维度。此维度包含促成您网站或应用上会话的 Google Ads 广告素材的 ID。

• Data API 架构中的 firstUserCreativeId 维度已重命名为 firstUserGoogleAdsCreativeId。此维度包含最先获取用户的 Google Ads 广告素材的 ID。

2021 年 4 月 9 日：Google Analytics（分析）Data API v1 Beta 版已发布。

• API 端点已更新为 https://analyticsdata.googleapis.com/v1beta。

• runReport、runPivotReport、batchRunReports、batchRunPivotReports 方法现在在网址路径的 property 参数中接受 Google Analytics（分析）4 媒体资源的 ID，而不是请求正文的 entity 字段：

  POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports
  

• API 客户端库已更新，以使用新的 API 端点。

2021 年 2 月 19 日 分页变更。

• 默认的报告响应大小从 10 行增加到 10,000 行事件数据。

• RunReportRequest 不再支持之前用于指示尝试检索所有行的 "limit" : -1 值。

• limit 字段的最大值设置为 100000。使用分页功能检索包含超过 10 万行的报告。

2021 年 2 月 8 日：新增电子商务维度和指标。

API 架构中新增了电子商务维度和指标：

维度：adFormat、adSourceName、adUnitName、itemBrand、itemCategory、itemCategory2、itemCategory3、itemCategory4、itemCategory5 itemId、itemListId、itemListName、itemName、itemPromotionCreativeName、itemPromotionId、itemPromotionName、orderCoupon、transactionId。

指标：adUnitExposure、addToCarts、cartToViewRate、checkouts、ecommercePurchases、firstTimePurchasers、itemListClickThroughRate、itemListClicks、itemListViews、itemPromotionClickThroughRate、itemPromotionClicks、itemPromotionViews、itemPurchaseQuantity、itemRevenue、itemViews、publisherAdClicks、publisherAdImpressions、totalPurchasers。

2021 年 2 月 8 日：新增了广告系列维度。

API 架构中新增了以下广告系列维度：campaignId、campaignName、googleAdsAccountName、googleAdsAdGroupId、googleAdsAdGroupName、googleAdsAdNetworkType、source、trafficOrigin

2021 年 2 月 8 日 dayOfWeek、week 项维度更改。

• dayOfWeek 维度的值现在从 0 开始，而不是 1。

• week 维度的值现在以 01 开头，并返回一个介于 01 到 53 之间的两位数。每周从星期日开始。1 月 1 日始终是第 1 周。

2021 年 1 月 28 日：为自定义指标添加了汇总变体。

属性注册的每个自定义指标都会创建三个 API 指标变体：总和、平均值和计数。

2021 年 1 月 28 日：新增了“日期/时间”维度。

API 架构中新增了以下维度：hour、nthHour、nthYear、dateHour。

2021 年 1 月 28 日：Data API 减少了针对每次查询收取的配额令牌数。

Data API 减少了每次查询收费的配额令牌。媒体资源配额令牌每小时和每天的配额限制没有变化。

2020 年 11 月 9 日：getUniversalMetadata 方法已被删除。

方法“getUniversalMetadata”已删除。请使用 getMetadata。我们已移除每个 API 请求最长 1 年的日期范围。

2020 年 11 月 2 日 新增了实时报告方法。

如需查看示例，请参阅创建实时报告；如需查看 REST 参考文档，请参阅 runRealtimeReport。

2020 年 10 月 19 日：更新了客户端库工件。

客户端库工件随使用说明和代码示例一起进行了更新。

2020 年 10 月 13 日 “应用 + 网站”媒体资源已更名为 Google Analytics（分析）4 (GA4)。

2020 年 10 月 8 日：向 API 中添加了 getMetadata 方法。

getMetadata 方法会返回指定的 GA4 媒体资源 ID 可用的自定义维度和指标，以及通用元数据。

2020 年 10 月 8 日：报告中提供自定义维度和指标。

如需了解有关自定义维度和指标的文档，请参阅 API 架构文档。本次更新包含事件级范围的自定义维度和指标，以及用户级范围的自定义维度。