更新日志

有关 Google Analytics API 的官方公告，请订阅 Google Analytics API 通知群组。

2024 年 6 月 28 日 添加了“每项媒体资源每个项目的客户端错误数”配额

现在，每个项目中每个项目允许的 API 服务器错误数限制为 10,000 属性。这包括导致 使用 500 或 200 以外的任何代码进行响应。关于错误的示例 使用不兼容的维度和指标组合， 身份验证错误。

如果超出此限制，系统将进一步对该媒体资源进行 API 调用， 被关联的 Google Cloud 项目暂时禁用，直到 15 分钟 。

2024 年 5 月 14 日：添加了比较功能

借助比较功能，您可以 可以并排评估数据的不同子集。

更新了 Data API v1beta 的核心报告方法，以支持 comparisons 字段，如果包含此字段，则会指定比较项的配置 请求。

在请求中，您可以通过提供 dimensionFilter 来指定基本比较 表达式，或者通过提供 比较的资源名称 comparison 字段。

getMetadata 方法更新为 列出 comparisons 响应字段。

如果请求中指定了至少一个比较项，则响应将 包含用于标识各个比较项的 comparison 列。

目前，已保存的比较项只能使用 Google Analytics 界面。

2024 年 5 月 8 日 向 Data API v1alpha 添加了报告任务（一种异步报告功能）。

使用报告任务，您可以发起一个长时间运行的异步请求， 生成 Google Analytics 事件数据的自定义报告。

Data API 中新增了以下报告任务操作方法 v1alpha：

• properties.reportTasks.create
• properties.reportTasks.get
• properties.reportTasks.list
• properties.reportTasks.query

2024 年 5 月 6 日：关键事件的新维度

键的维度和指标 活动。

修改使用“isConversionEvent”维度的报告请求，以便： 请改用“isKeyEvent”维度。

修改使用已弃用指标 改用关键事件指标。

已弃用的指标	关键事件指标
advertiserAdCostPerConversion	advertiserAdCostPerKeyEvent
conversions	keyEvents
firstTimePurchaserConversionRate	firstTimePurchaserRate
purchaserConversionRate	purchaserRate
sessionConversionRate	sessionKeyEventRate
userConversionRate	userKeyEventRate

对任一关键的关键事件指标的使用进行类似的修改 事件 。

properties/getMetadata 方法的响应反映了简介 DimensionMetadata中的关键事件维度和指标以及 MetricMetadata 对象，如下所示：

• apiName、uiName 和 description 包含关键事件的 API 名称。 界面名称和说明。
• deprecatedApiNames 重复字段有一个条目包含已弃用的 Conversion API 名称。

2024 年 3 月 25 日：添加了主要渠道组、手动流量来源和与集成相关的维度

主渠道组、人工流量来源与 CM360、DV360、SA360 集成 添加到 Data API 架构的特定维度。

受众群体维度：

• 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 展示广告和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 天不活跃的购买者” 用户”和“7 天未收到通知的用户”。如需详细了解这些建议 受众群体，请参阅 建议的受众群体。

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

现在，即使导出受众群体对象时，系统也会返回代码中指定的用户 ID， 您的媒体资源已启用“用户提供的数据”功能。如果用户提供的数据 收集用户提供的数据以及 User-ID 可以发送到 在代码植入中使用 Google Analytics，以提高衡量的准确性。如需了解详情，请参阅 收集用户提供的数据。

2024 年 1 月 30 日：Data API v1 Alpha 版中的“受众群体名单”和“周期性受众群体名单”的网络钩子通知支持。

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

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

2024-01-18 改进了包含查询字符串或分钟组成部分的维度的兼容性。

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

包含分钟部分的维度现在与大多数 字段。minute、nthMinute和dateHourMinute等维度现已更新为 都与一组类似的附加字段兼容。

请参阅 GA4 维度和Metrics Explorer：提供全面的兼容性信息。

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

商品级范围的自定义维度现在可以包含在 Google Analytics Data API 查询中 使用以下语法：

通用 API 名称	说明
customItem:parameter_name	parameter_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

已将samplingMetadatas添加到 ResponseMetaData。此集合将 包含 SampleMetadata 针对请求中有结果的每个日期范围 抽样。Google Analytics 仅当预计基数上限会应用于系统时，才会应用抽样 降低数据质量。

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

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

借助此功能，您可以每天生成受众群体名单作为受众群体 成员资格变更定期生成的受众群体名单可确保您能正常发挥作用 包含最新的受众群体成员资格结果

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

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

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

现在， 受众群体名单导出功能。

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

默认情况下，使用受众群体名单导出功能创建的报告 遵循与 Google 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：电子商务事件中商品折扣的货币价值。 在代码植入时，系统会按“折扣”商品参数。

如需了解详情，请参阅 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 日 自定义渠道分组

自定义渠道组 支持。

2023 年 5 月 11 日：令牌配额变更。

我们更新了 Google Data API 的配额系统， 费用。

针对每个请求收费的令牌数已更新 以适应配额变化，并进行重新平衡， 简单报告查询的数量，同时收费明显增加 用于大日期报告的配额令牌。

在此变更生效后，虽然部分请求的费用会保持不变 更复杂的查询的费用将明显增加。 例如，请求超过 6 个月的数据可能会收取 1,000 或更多费用 配额令牌。

标准媒体资源

配额名称	旧限额	新限额
每天每项媒体资源的核心令牌数量	25000	200000
每小时每项媒体资源的核心令牌数	5000	4 万
每个项目每项媒体资源每小时的核心令牌数	1,750,000	14,000
每天每个媒体资源的实时令牌数	25000	200000
每小时每项媒体资源的实时令牌数	5000	4 万
每个项目每项媒体资源每小时的实时令牌数	1,750,000	14,000
每天每个媒体资源的漏斗令牌数	25000	200000
每小时每项媒体资源的漏斗令牌数	5000	4 万
每个项目每项媒体资源每小时的漏斗令牌数	1,750,000	14,000

Analytics 360 媒体资源

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

2023-03-02 添加了日期维度。

• dayOfWeekName 周几名称。英文表示星期几。此维度的值为 Sunday、Monday 等。

• isoWeek ISO 周序号。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 ISO 周。isoWeek 和 isoYear 的组合值。示例值包括 201652 和201701。

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

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

2023 年 2 月 27 日：添加了电子商务维度。

• itemListPosition 商品列表位置。商品（例如您销售的产品）在列表中的位置。在标记中，此维度由“索引”填充参数的值。

• itemLocationID 内容地理位置 ID。与商品相关联的实际营业地点（例如实体店）。建议使用与相关商品对应的 Google 地点 ID。也可使用自定义地理位置 ID。在标记中，此字段由“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”或“baidu”。

• 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 渠道添加了漏斗报告功能。

• v1alpha 版 API 中添加了 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 / MAU。过去 30 天活跃过的用户中，处于非活动状态的 以及过去 1 天的活跃用户数

• dauPerWauDAU / WAU。过去 7 天活跃过的用户中，处于非活动状态的 以及过去 1 天的活跃用户数

• wauPerMau 周活 / 月活。过去 30 天活跃过的用户中，处于非活动状态的 以及过去 7 天的活跃用户数

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

• 每位购买者的交易次数为 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。

• 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：首次获取到用户的流量来源。 请勿依赖返回“Manual”的此字段使用 UTM；此字段将从返回“Manual”更新到返回 “(not set)”为即将推出的功能发布做好准备。

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

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

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

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

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

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

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

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

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

• defaultChannelGrouping：默认渠道分组。

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

• minutesAgo 维度已添加到 Data API 实时架构中，可以是 传递给 runRealtimeReport 方法。 此维度包含事件发生前经过的分钟数 。00 表示当前分钟，01 表示前一分钟。

• 向 Data API 架构添加了“googleAdsCreativeId”维度。这个 维度包含归因于 转化事件。

• 向 Data API 架构添加了“sessionGoogleAdsCreativeId”维度。这个 维度包含促成会话的 Google Ads 广告素材的 ID 看到这类广告

• “firstUserCreativeId”维度已重命名为“firstUserGoogleAdsCreativeId” Google Data API 架构。此维度包含 Google Ads 广告素材。

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 行事件 数据。

• "limit" : -1 值，用于指示尝试检索全部 RunReportRequest 不再支持行。

• limit 字段的最大值设置为 100000。使用分页 检索行数超过 100,000 的报告。

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 减少了按查询收取的配额令牌数量。

Google Data API 减少了对每次查询收取的配额令牌。配额限制 每小时和每天的媒体资源配额令牌数量没有更改。

2020-11-09 方法 getUniversalMetadata 已被删除。

方法 getUniversalMetadata 已被删除。请使用 getMetadata.最长一年 已移除每个 API 请求的日期范围。

2020 年 11 月 2 日 添加了实时报告方法。

请参阅创建实时报告，查看相关示例和 runRealtimeReport 的 REST 参考文档。

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

客户端库工件随使用情况一同更新 说明和代码示例。

2020 年 10 月 13 日：“应用 + 网站”媒体资源已重命名为 Google Analytics 4 (GA4)。

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

getMetadata 方法返回 Custom 适用于指定 GA4 媒体资源 ID 的维度和指标，以及 通用元数据。

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

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