如需官方的 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
个人工广告系列 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 年 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 版添加了以下方法:
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 版中添加了以下方法:
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 日推出以下重大变更:
商品级范围的维度(如
itemName
)将与事件级范围的指标(如eventCount
)不兼容。商品级范围的维度仍将与商品级范围的指标(如itemRevenue
)、基于用户的指标(如activeUsers
)和基于会话的指标(如sessions
)兼容。source
等归因维度与eventCount
等事件级范围的指标不兼容。归因维度仍与可归因指标(如conversions
)、基于用户的指标(如activeUsers
)和基于会话的指标(如sessions
)兼容。包含
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 天内活跃用户的滚动百分比。dauPerWau
DAU / 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 架构文档。此更新包含事件级范围的自定义维度和指标,以及用户级范围的自定义维度。