更新日志

如需接收 Google Analytics API 的官方公告，请订阅 Google Analytics API 通知群组。

2026-09-14 在 v1 alpha 中添加了对话式查询支持

添加了 properties.chat 方法，用于通过自然语言查询与 Google Analytics 数据进行交互。

2026-09-14：在报告响应中添加了数据截断原因

在 v1 beta 版和 v1 alpha 版中，向 ResponseMetaData 添加了 dataTruncationReasons 字段。当报告的数据被截断时，此字段将包含 DataTruncationReason 对象的列表，其中包括截断类型、描述性消息和受影响的日期。

2026-04-23：在 v1 alpha 中添加了对转化报告的支持

在 Data API v1 alpha 中，添加了对使用 runReport 方法从转化效果报告中检索数据的支持。这样，您就可以访问 Google Analytics 界面中广告 > 转化效果下的相同转化数据。

更新了 Data API v1 alpha 中的 getMetadata 方法，以提供转化报告信息：

  • 向响应中添加了 conversions 字段，该字段会返回一个 ConversionMetadata 对象列表，这些对象会将转化操作 ID 映射到显示名称。
  • 向 DimensionMetadata 和 MetricMetadata 添加了 sections 字段，用于标识特定字段是否与标准报告、转化报告或两者都兼容。

2024-10-20：添加了 EmptyFilter 维度过滤条件类型

使用 EmptyFilter 维度过滤条件，您可以创建过滤条件来与空白值进行比较。

2024-10-15：向 reportTasks 方法添加了抽样级别功能

使用 properties.runReportTask 方法的 samplingLevel 字段，您可以控制报告的抽样级别。

此功能可让 Google Analytics 360 版媒体资源获得更高的抽样上限（10 亿个事件）。此外，对于事件数量较多的未抽样结果，抽样限制可以设置为 UNSAMPLED。

2024-09-18：添加了媒体资源配额快照功能

使用 properties.getPropertyQuotasSnapshot 方法，您可以获取给定媒体资源的所有媒体资源配额的当前快照（按配额类别整理）。

2024-06-28：添加了“每个项目每项媒体资源的客户端错误数”配额

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

如果超出此限制，系统会暂时阻止关联的 Google Cloud 项目对该媒体资源进行进一步的 API 调用，直到 15 分钟的时间窗口结束。

2024-05-14：添加了“比较”功能

使用对比项，您可以并排评估数据的不同子集。

Data API v1beta 的核心报告方法已更新，以支持 comparisons 字段，该字段在包含时会指定所请求的比较的配置。

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

getMetadata 方法已更新，可在 comparisons 响应字段下列出媒体资源的所有已保存比较项。

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

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

2024-05-08：向 Data API v1alpha 添加了报告任务（一种异步报告功能）。

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

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

2024-05-06：新增了关键事件维度

关键事件的维度和指标现已推出。

修改使用 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-03-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-03-06：受众群体导出功能支持不活跃用户受众群体。

受众群体导出功能可以更好地支持导出非活跃用户受众群体。 用户无需触发符合条件的事件即可进入这些受众群体；例如，用户连续 7 天未访问您的网站，即可进入相应受众群体。不活跃用户受众群体的示例包括“7 天不活跃的购买者”“7 天不活跃的用户”和“7 天未收到通知的用户”。如需详细了解这些建议的受众群体，请参阅建议的受众群体。

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

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

2024-01-30：Data API v1 Alpha 版中的受众群体名单和周期性受众群体名单支持 Webhook 通知。

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

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

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

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

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

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

2023-12-13：自定义商品级范围的参数

现在，您可以使用以下语法在 Analytics Data API 查询中添加商品级范围的自定义维度：

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

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

2023-12-05：受众群体名单在 Data API v1 Beta 版中作为受众群体导出功能提供

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

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

2023-11-28：在报告响应中添加了 samplingMetadatas

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

2023-11-28：向 Data API v1 Alpha 版添加了周期性受众群体名单导出功能

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

借助此功能，您可以随着受众群体成员资格的变化，每天生成受众群体名单。定期更新的受众群体名单可确保您使用的是最新的受众群体成员资格结果。

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

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

2023-09-12 AudienceList 默认排序规则

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

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

deviceId isAdsPersonalizationAllowed
ABC true
DAC false
ABC false
AAA true

此次变更后，您将收到以下报告：

deviceId isAdsPersonalizationAllowed
AAA true
ABC false
ABC true
DAC false

2023-08-15：向受众群体名单导出架构添加了 isLimitedAdTracking 维度

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

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

2023-08-15：添加了 currencyCode 维度和 itemDiscountAmount 指标

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

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

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

2023-08-10：向受众群体名单导出架构添加了 isAdsPersonalizationAllowed 维度

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

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

2023-07-10：受众群体名单

Data API v1 Alpha 版中添加了对受众群体名单的支持。受众群体名单包含创建受众群体名单时受众群体中用户的快照。

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

2023-05-19：自定义渠道组

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

2023-05-11：令牌配额变更。

Data API 的配额系统已更新，以便更精确地收费。

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

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

标准媒体资源

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

Analytics 360 版媒体资源

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

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。

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

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

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

2023-02-27：添加了电子商务维度。

  • itemListPosition 作品列表位置。商品（例如您销售的产品）在列表中的位置。此维度通过商品数组中的“index”参数在标记中进行填充。

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

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

2023-02-21：添加了“着陆页 + 查询字符串”维度。

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

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

2023-01-28：添加了“每位用户的浏览量”和“滚动浏览的用户数”指标。

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

  • scrolledUsers 执行了滚动操作的用户。滚动浏览至少 90% 页面内容的唯一身份用户数。

2023-01-23：添加了“大洲”和“大洲 ID”维度。

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

  • continentId 大洲 ID。根据用户 IP 地址得出的用户活动来源大洲的地理位置 ID。

2023-01-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-09-13：架构兼容性变更公告。

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

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

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

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

2022-09-01 配额变更。

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

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

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

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

2022-08-03：添加了会话级 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-07-11：添加了转化率指标。

转化率

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

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

针对一次转化的转化率指标

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

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

2022-05-05：向 Alpha 渠道添加了漏斗报告功能。

  • runFunnelReport 方法已添加到 API 的 v1alpha 版本中，该方法会返回 Google Analytics 事件数据的自定义漏斗报告。

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

2022-02-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 DAU/MAU。既是过去 30 天活跃过的用户又是过去 1 天内活跃用户的用户滚动百分比。

  • dauPerWau DAU/WAU。既是过去 7 天活跃过的用户又是过去 1 天内活跃用户的用户滚动百分比。

  • wauPerMau WAU/MAU。既是过去 30 天活跃过的用户又是过去 7 天活跃过的用户的用户滚动百分比。

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

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

Google Ads 广告系列

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

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

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

2021-09-07：添加了新的日期/时间维度。

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

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

  • nthMinute 自日期范围开始以来经过的分钟数。

2021-09-07：添加了由事件参数填充的新维度。

  • achievementId 游戏中事件的成就 ID。

  • character 游戏中与事件相关的玩家角色。

  • fileExtension 下载文件的扩展名。

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

  • groupId 游戏中活动的玩家群组 ID。

  • linkClasses 出站链接的 HTML class 属性。

  • linkDomain 出站链接的目标域名。

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

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

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

  • method 事件的触发方法。

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

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

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

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

  • searchTerm 用户搜索的字词。

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

  • videoTitle 视频的标题。

  • videoUrl 视频的网址。

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

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

2021-09-07 API schema 变更。

现有维度的变更：

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

即将发生的变化公告：

  • firstUserTrafficOrigin 首次获取用户的流量来源。 请勿依赖此字段针对使用 UTM 的流量返回“手动”；此字段将从返回“手动”更新为返回“(not set)”，以支持即将推出的功能发布。

  • sessionTrafficOrigin 相应会话的广告系列的流量来源。 请勿依赖此字段针对使用 UTM 的流量返回“手动”；此字段将从返回“手动”更新为返回“(not set)”，以支持即将推出的功能发布。

  • trafficOrigin 转化事件的广告系列的流量来源。 请勿依赖此字段针对使用 UTM 的流量返回“手动”；此字段将从返回“手动”更新为返回“(not set)”，以支持即将推出的功能发布。

2021-09-07 向 API 添加了 checkCompatibility 方法。

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

2021-07-21：实时报告变更。

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

2021-07-21：新增了渠道分组维度。

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

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

  • defaultChannelGrouping 默认渠道分组。

2021-06-10 API schema变更。

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

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

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

  • 在 Data API schema 中，firstUserCreativeId 维度已重命名为 firstUserGoogleAdsCreativeId。此维度包含首次获取用户的 Google Ads 广告素材的 ID。

2021-04-09：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-02-19：分页更改。

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

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

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

2021-02-08：新增了电子商务维度和指标。

新的电子商务维度和指标已添加到 API schema中：

维度：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-02-08：添加了新的广告系列维度。

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

2021-02-08：dayOfWeek、week 维度变更。

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

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

2021-01-28：添加了自定义指标的汇总变体。

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

2021-01-28：添加了新的日期/时间维度。

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

2021-01-28：Data API 减少了每次查询收取的配额令牌。

Data API 减少了每次查询消耗的配额令牌。每小时和每天的媒体资源配额令牌配额限制未发生变化。

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

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

2020-11-02：添加了实时报告方法。

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

2020-10-19：更新了客户端库工件。

客户端库工件以及使用说明和代码示例已更新。

2020-10-13：“应用 + 网站”媒体资源已更名为“Google Analytics 4 (GA4)”。

2020-10-08：向 API 添加了 getMetadata 方法。

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

2020-10-08：报告中提供自定义维度和指标。

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