如需了解有关 Google Analytics API 的官方公告,请订阅 Google Analytics API Notify 群组。
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 分钟的时间范围内允许的 API 服务器错误数上限为 10,000 个。这包括所有导致响应具有 500
或 200
以外的任何代码的请求。以下是一些会占用此配额的错误示例:使用不兼容的维度和指标组合、所有身份验证错误。
如果超出此限制,系统会暂时阻止对相应媒体资源的进一步 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 中新增了以下报告任务操作方法:
- properties.reportTasks.create
- properties.reportTasks.get
- properties.reportTasks.list
- properties.reportTasks.query
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
人工广告系列 IDmanualCampaignName
人工广告系列名称manualCreativeFormat
手动创建的广告素材格式manualMarketingTactic
人工营销策略manualMedium
人工媒介manualSource
人工来源manualSourceMedium
人工来源 / 媒介manualSourcePlatform
人工来源平台firstUserManualCampaignId
带来用户首次互动的人工广告系列 IDfirstUserManualCampaignName
带来用户首次互动的人工广告系列名称firstUserManualCreativeFormat
带来用户首次互动的手动创建的广告素材格式firstUserManualMarketingTactic
带来用户首次互动的人工营销策略firstUserManualMedium
带来用户首次互动的人工媒介firstUserManualSource
带来用户首次互动的人工来源firstUserManualSourceMedium
带来用户首次互动的人工来源 / 媒介firstUserManualSourcePlatform
带来用户首次互动的人工来源平台sessionManualCampaignId
带来会话的人工广告系列 IDsessionManualCampaignName
带来会话的人工广告系列名称sessionManualCreativeFormat
带来会话的手动创建的广告素材格式sessionManualMarketingTactic
带来会话的人工营销策略sessionManualMedium
带来会话的人工媒介sessionManualSource
带来会话的人工来源sessionManualSourceMedium
带来会话的人工来源 / 媒介sessionManualSourcePlatform
带来会话的人工来源平台
Campaign Manager 360 (CM360) 集成维度:
cm360AccountId
CM360 账号 IDcm360AccountName
CM360 账号名称cm360AdvertiserId
CM360 广告客户 IDcm360AdvertiserName
CM360 广告客户名称cm360CampaignId
CM360 广告系列 IDcm360CampaignName
CM360 广告系列名称cm360CreativeFormat
CM360 广告素材格式cm360CreativeId
CM360 广告素材 IDcm360CreativeName
CM360 广告素材名称cm360CreativeType
CM360 广告素材类型cm360CreativeTypeId
CM360 广告素材类型 IDcm360CreativeVersion
CM360 广告素材版本cm360Medium
CM360 媒介cm360PlacementCostStructure
CM360 展示位置费用结构cm360PlacementId
CM360 展示位置 IDcm360PlacementName
CM360 展示位置名称cm360RenderingId
CM360 呈现 IDcm360SiteId
CM360 网站 IDcm360SiteName
CM360 网站名称cm360Source
CM360 来源cm360SourceMedium
CM360 来源 / 媒介firstUserCm360AccountId
带来用户首次互动的 CM360 账号 IDfirstUserCm360AccountName
带来用户首次互动的 CM360 账号名称firstUserCm360AdvertiserId
带来用户首次互动的 CM360 广告客户 IDfirstUserCm360AdvertiserName
带来用户首次互动的 CM360 广告客户名称firstUserCm360CampaignId
带来用户首次互动的 CM360 广告系列 IDfirstUserCm360CampaignName
带来用户首次互动的 CM360 广告系列名称firstUserCm360CreativeFormat
带来用户首次互动的 CM360 广告素材格式firstUserCm360CreativeId
带来用户首次互动的 CM360 广告素材 IDfirstUserCm360CreativeName
带来用户首次互动的 CM360 广告素材名称firstUserCm360CreativeType
带来用户首次互动的 CM360 广告素材类型firstUserCm360CreativeTypeId
带来用户首次互动的 CM360 广告素材类型 IDfirstUserCm360CreativeVersion
带来用户首次互动的 CM360 广告素材版本firstUserCm360Medium
带来用户首次互动的 CM360 媒介firstUserCm360PlacementCostStructure
带来用户首次互动的 CM360 展示位置费用结构firstUserCm360PlacementId
带来用户首次互动的 CM360 展示位置 IDfirstUserCm360PlacementName
带来用户首次互动的 CM360 展示位置名称firstUserCm360RenderingId
带来用户首次互动的 CM360 呈现 IDfirstUserCm360SiteId
带来用户首次互动的 CM360 网站 IDfirstUserCm360SiteName
带来用户首次互动的 CM360 网站名称firstUserCm360Source
带来用户首次互动的 CM360 来源firstUserCm360SourceMedium
带来用户首次互动的 CM360 来源 / 媒介sessionCm360AccountId
带来会话的 CM360 账号 IDsessionCm360AccountName
带来会话的 CM360 账号名称sessionCm360AdvertiserId
带来会话的 CM360 广告客户 IDsessionCm360AdvertiserName
带来会话的 CM360 广告客户名称sessionCm360CampaignId
带来会话的 CM360 广告系列 IDsessionCm360CampaignName
带来会话的 CM360 广告系列名称sessionCm360CreativeFormat
带来会话的 CM360 广告素材格式sessionCm360CreativeId
带来会话的 CM360 广告素材 IDsessionCm360CreativeName
带来会话的 CM360 广告素材名称sessionCm360CreativeType
带来会话的 CM360 广告素材类型sessionCm360CreativeTypeId
带来会话的 CM360 广告素材类型 IDsessionCm360CreativeVersion
带来会话的 CM360 广告素材版本sessionCm360Medium
带来会话的 CM360 媒介sessionCm360PlacementCostStructure
带来会话的 CM360 展示位置费用结构sessionCm360PlacementId
带来会话的 CM360 展示位置 IDsessionCm360PlacementName
带来会话的 CM360 展示位置名称sessionCm360RenderingId
带来会话的 CM360 呈现 IDsessionCm360SiteId
带来会话的 CM360 网站 IDsessionCm360SiteName
带来会话的 CM360 网站名称sessionCm360Source
带来会话的 CM360 来源sessionCm360SourceMedium
带来会话的 CM360 来源 / 媒介
Google Display & Video 360 (DV360) 集成维度:
dv360AdvertiserId
DV360 广告客户 IDdv360AdvertiserName
DV360 广告客户名称dv360CampaignId
DV360 广告系列 IDdv360CampaignName
DV360 广告系列名称dv360CreativeFormat
DV360 广告素材格式dv360CreativeId
DV360 广告素材 IDdv360CreativeName
DV360 广告素材名称dv360ExchangeId
DV360 广告交易平台 IDdv360ExchangeName
DV360 广告交易平台名称dv360InsertionOrderId
DV360 广告订单 IDdv360InsertionOrderName
DV360 广告订单名称dv360LineItemId
DV360 订单项 IDdv360LineItemName
DV360 订单项名称dv360Medium
DV360 媒介dv360PartnerId
DV360 合作伙伴 IDdv360PartnerName
DV360 合作伙伴名称dv360Source
DV360 来源dv360SourceMedium
DV360 来源 / 媒介firstUserDv360AdvertiserId
带来用户首次互动的 DV360 广告客户 IDfirstUserDv360AdvertiserName
带来用户首次互动的 DV360 广告客户名称firstUserDv360CampaignId
带来用户首次互动的 DV360 广告系列 IDfirstUserDv360CampaignName
带来用户首次互动的 DV360 广告系列名称firstUserDv360CreativeFormat
带来用户首次互动的 DV360 广告素材格式firstUserDv360CreativeId
带来用户首次互动的 DV360 广告素材 IDfirstUserDv360CreativeName
带来用户首次互动的 DV360 广告素材名称firstUserDv360ExchangeId
带来用户首次互动的 DV360 广告交易平台 IDfirstUserDv360ExchangeName
带来用户首次互动的 DV360 广告交易平台名称firstUserDv360InsertionOrderId
带来用户首次互动的 DV360 广告订单 IDfirstUserDv360InsertionOrderName
带来用户首次互动的 DV360 广告订单名称firstUserDv360LineItemId
带来用户首次互动的 DV360 订单项 IDfirstUserDv360LinteItemName
带来用户首次互动的 DV360 订单项名称firstUserDv360Medium
带来用户首次互动的 DV360 媒介firstUserDv360PartnerId
带来用户首次互动的 DV360 合作伙伴 IDfirstUserDv360PartnerName
带来用户首次互动的 DV360 合作伙伴名称firstUserDv360Source
带来用户首次互动的 DV360 来源firstUserDv360SourceMedium
带来用户首次互动的 DV360 来源 / 媒介sessionDv360AdvertiserId
带来会话的 DV360 广告客户 IDsessionDv360AdvertiserName
带来会话的 DV360 广告客户名称sessionDv360CampaignId
带来会话的 DV360 广告系列 IDsessionDv360CampaignName
带来会话的 DV360 广告系列名称sessionDv360CreativeFormat
带来会话的 DV360 广告素材格式sessionDv360CreativeId
带来会话的 DV360 广告素材 IDsessionDv360CreativeName
带来会话的 DV360 广告素材名称sessionDv360ExchangeId
带来会话的 DV360 广告交易平台 IDsessionDv360ExchangeName
带来会话的 DV360 广告交易平台名称sessionDv360InsertionOrderId
带来会话的 DV360 广告订单 IDsessionDv360InsertionOrderName
带来会话的 DV360 广告订单名称sessionDv360LineItemId
带来会话的 DV360 订单项 IDsessionDv360LineItemName
带来会话的 DV360 订单项名称sessionDv360Medium
带来会话的 DV360 媒介sessionDv360PartnerId
带来会话的 DV360 合作伙伴 IDsessionDv360PartnerName
带来会话的 DV360 合作伙伴名称sessionDv360Source
带来会话的 DV360 来源sessionDv360SourceMedium
带来会话的 DV360 来源 / 媒介
Google Search Ads 360 (SA360) 集成维度:
firstUserSa360AdGroupId
带来用户首次互动的 SA360 广告组 IDfirstUserSa360AdGroupName
带来用户首次互动的 SA360 广告组名称firstUserSa360CampaignId
带来用户首次互动的 SA360 广告系列 IDfirstUserSa360CampaignName
带来用户首次互动的 SA360 广告系列firstUserSa360CreativeFormat
带来用户首次互动的 SA360 广告素材格式firstUserSa360EngineAccountId
带来用户首次互动的 SA360 引擎账号 IDfirstUserSa360EngineAccountName
带来用户首次互动的 SA360 引擎账号名称firstUserSa360EngineAccountType
带来用户首次互动的 SA360 引擎账号类型firstUserSa360KeywordText
带来用户首次互动的 SA360 关键字文字firstUserSa360ManagerAccountId
带来用户首次互动的 SA360 经理账号 IDfirstUserSa360ManagerAccountName
带来用户首次互动的 SA360 经理账号名称firstUserSa360Medium
带来用户首次互动的 SA360 媒介firstUserSa360Query
带来用户首次互动的 SA360 查询firstUserSa360Source
带来用户首次互动的 SA360 来源firstUserSa360SourceMedium
带来用户首次互动的 SA360 来源 / 媒介sa360AdGroupId
SA360 广告组 IDsa360CampaignId
SA360 广告系列 IDsa360AdGroupName
SA360 广告组名称sa360CampaignName
SA360 广告系列sa360CreativeFormat
SA360 广告素材格式sa360EngineAccountId
SA360 引擎账号 IDsa360EngineAccountName
SA360 引擎账号名称sa360EngineAccountType
SA360 引擎账号类型sa360KeywordText
SA360 关键字文字sa360ManagerAccountId
SA360 经理账号 IDsa360ManagerAccountName
SA360 经理账号名称sa360Medium
SA360 媒介sa360Query
SA360 查询sa360Source
SA360 来源sa360SourceMedium
SA360 来源 / 媒介sessionSa360AdGroupId
带来会话的 SA360 广告组 IDsessionSa360CampaignId
带来会话的 SA360 广告系列 IDsessionSa360ManagerAccountId
带来会话的 SA360 经理账号 IDsessionSa360ManagerAccountName
带来会话的 SA360 经理账号名称sessionSa360SourceMedium
带来会话的 SA360 来源 / 媒介
2024-03-06 在受众群体导出中支持非活跃用户受众群体。
“受众群体导出”功能可更好地支持导出非活跃用户受众群体。 用户无需触发资格条件事件即可加入这些受众群体;例如,用户如果 7 天未访问您的网站,即可加入相应受众群体。不活跃用户受众群体示例包括“7 天不活跃的购买者”“7 天不活跃的用户”和“7 天未收到通知的用户”。如需详细了解这些建议的受众群体,请参阅建议的受众群体。
2024-02-28 受众群体导出功能会返回标记中指定的用户 ID。
即使您的媒体资源已启用“用户提供的数据”功能,受众群体导出功能现在也会返回代码植入中指定的用户 ID。如果“收集用户提供的数据”功能处于开启状态,则可以在代码植入中将用户提供的数据与 User-ID 一起发送到 Google Analytics,以改进衡量效果。如需了解详情,请参阅“收集用户提供的数据”功能。
2024-01-30:在 Data API v1 alpha 版中,支持受众群体名单、周期性受众群体名单的网络钩子通知。
创建受众群体名单(使用 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”商品参数填充。
如需了解详情,请参阅数据 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:令牌配额变更。
数据 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
商品列表位置。商品(例如您销售的产品)在列表中的位置。此维度在标记中由 items 数组中的“index”参数填充。itemLocationID
商品位置 ID。与商品关联的实际位置(例如实体店)。建议使用与相关商品对应的 Google 地点 ID。也可使用自定义地理位置 ID。此字段在代码植入中由 items 数组中的“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。用户发起活动时所处的大洲的地理 ID,根据用户的 IP 地址得出。
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 日生效:
商品级范围的维度(例如
itemName
)将与事件级范围的指标(例如eventCount
)变得不兼容。商品级范围的维度仍将与商品级范围的指标(例如itemRevenue
)、基于用户的指标(例如activeUsers
)和基于会话的指标(例如sessions
)兼容。source
等归因维度与eventCount
等某些事件级范围的指标不再兼容。归因维度仍将与可归因的指标(例如conversions
)、基于用户的指标(例如activeUsers
)和基于会话的指标(例如sessions
)兼容。包含查询字符串的维度(例如
pagePathPlusQueryString
)仅与一小部分维度和指标兼容。
如需了解详情,请参阅兼容性变更的详细说明。
2022-09-01 配额变更。
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-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”或“百度”。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
进行过一次或多次购买交易的活跃用户所占的百分比。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 架构变更。
现有维度的变化:
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 架构变更。
minutesAgo
维度已添加到 Data API 实时架构,可用于对runRealtimeReport
方法的查询中。 此维度包含收集事件的时间距离现在的分钟数。00 表示当前分钟,01 表示上一分钟。向 Data API 架构添加了
googleAdsCreativeId
维度。此维度包含归因于转化事件的 Google Ads 广告素材的 ID。向 Data API 架构添加了
sessionGoogleAdsCreativeId
维度。此维度包含促成您网站或应用上会话的 Google Ads 广告素材的 ID。数据 API 架构中的
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 行。
用于指示尝试检索所有行的
"limit" : -1
值在 RunReportRequest 中不再受支持。limit
字段的最大值设置为100000
。使用分页功能可检索包含 10 万行以上的报告。
2021-02-08:新增了电子商务维度和指标。
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-02-08 添加了新的广告系列维度。
API 架构中新增了以下广告系列维度:
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 架构中新增了以下维度: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 可用的自定义维度和指标,以及 Universal 元数据。
2020-10-08 报告中提供自定义维度和指标。
如需查看有关自定义维度和指标的文档,请参阅 API 架构文档。此更新包括事件级范围的自定义维度和指标,以及用户级范围的自定义维度。