更新日志

如需官方的 Google Analytics（分析）API 公告，请订阅 Google Analytics API Notifications 小组。

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

现在，每个项目、每项媒体资源在 15 分钟内最多可以包含 10,000 个 API 服务器错误。这包括导致响应中包含 500 或 200 以外的任何代码的所有请求。属于此配额的错误示例：使用不兼容的维度和指标组合、所有身份验证错误。

如果超出此限制，系统将暂时禁止关联的 Google Cloud 项目对该属性进一步的 API 调用，直到 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 重复字段中有一个条目使用了已弃用的转化 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 天不活跃的用户”和“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-01-18 改进了包含查询字符串或分钟组成部分的维度的兼容性。

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

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

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

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

向 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 日：令牌配额变更。

Google Data API 的配额系统已更新，可支持更精确的收费。

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

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

标准媒体资源

配额名称	旧限额	新限额
每天每项媒体资源的核心令牌数量	25000	200000
每小时每项媒体资源的核心令牌数	5,000	4 万
每个项目每项媒体资源每小时的核心令牌数	1,750,000	14,000
每天每个媒体资源的实时令牌数	25000	200000
每小时每项媒体资源的实时令牌数	5,000	4 万
每个项目每项媒体资源每小时的实时令牌数	1,750,000	14,000
每天每个媒体资源的漏斗令牌数	25000	200000
每小时每项媒体资源的漏斗令牌数	5,000	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 商品列表位置。商品（例如您销售的产品）在列表中的位置。在标记中，系统会通过 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”或“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 渠道添加了漏斗报告功能。

• runFunnelReport 方法，可返回 Google Analytics（分析）事件数据的自定义漏斗报告。v1alpha

• 此方法是在 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 完成一次或多次购买交易的活跃用户所占的百分比。

• 每位购买者的交易次数为 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首次获取用户的流量来源。对于使用 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。使用分页功能可检索行数超过 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 日始终是第 01 周。

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 日 添加了实时报告方法。

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

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

更新了客户端库工件，并添加了使用说明和代码示例。

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

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

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

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

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