API 维度和指标

您可以在 Data API Core Reporting 查询中使用的维度和指标。

维度

您可以在任何媒体资源的报告中请求以下维度。在报告响应中的维度列的 Dimension 资源的 name 字段中,指定“API 名称”。

API 名称 界面名称 说明
achievementId 成就 ID 游戏中针对某个事件的成就 ID。由事件参数 achievement_id 填充。
adFormat 广告格式 说明广告的外观和展示位置。典型格式包括 InterstitialBannerRewardedNative advanced
adSourceName 广告来源 投放广告的来源网络。典型来源包括 AdMob NetworkLiftoffFacebook Audience NetworkMediated house ads
adUnitName 广告单元 您选择用来描述该广告单元的名称。广告单元是您在应用中设置的容器,用来向用户展示广告。
appVersion 应用版本 应用的 versionName (Android) 或简短的软件包版本 (iOS)。
audienceId 受众群体 ID 受众群体的数字标识符。在报告的日期范围内,用户按其所属的受众群体进行报告。当前的用户行为不会影响报告中的既往受众群体成员资格。
audienceName 受众群体名称 受众群体的指定名称。在报告的日期范围内,用户按其所属的受众群体进行报告。当前的用户行为不会影响报告中的既往受众群体成员资格。
audienceResourceName 受众群体资源名称 此受众群体的资源名称。资源名称同时包含集合标识符和资源标识符,用于唯一标识资源;如需了解详情,请参阅资源名称
brandingInterest 兴趣 购物漏斗中靠近顶部的用户表现出的兴趣。同一用户可以计入到多个兴趣类别中。例如 ShoppersLifestyles & Hobbies/Pet LoversTravel/Travel Buffs/Beachbound Travelers
browser 浏览器 用于查看您网站的浏览器。
campaignId 广告系列 ID 营销广告系列的标识符。仅针对关键事件显示。包括 Google Ads 广告系列、人工出价广告系列和其他广告系列。
campaignName 广告系列 营销广告系列的名称。仅针对关键事件显示。包括 Google Ads 广告系列、人工出价广告系列和其他广告系列。
character 字符 游戏中针对某个事件的玩家角色。由事件参数 character 填充。
city 城市 发起用户活动的城市。
cityId 城市 ID 用户发起活动时所处的城市的地理 ID,基于其 IP 地址得出。
cm360AccountId CM360 账号 ID 促成关键事件的 CM360 账号 ID。用于标识 CM360 账号。
cm360AccountName CM360 账号名称 促成关键事件的 CM360 账号名称。CM360 账号包含广告客户、网站、广告系列和用户个人资料。
cm360AdvertiserId CM360 广告客户 ID 促成关键事件的 CM360 广告客户 ID。CM360 广告客户包含一组广告系列、广告素材资源和其他设置。
cm360AdvertiserName CM360 广告客户名称 促成关键事件的 CM360 广告客户名称。CM360 广告客户包含一组广告系列、广告素材资源和其他设置。
cm360CampaignId CM360 广告系列 ID 促成关键事件的 CM360 广告系列 ID。您可以配置 CM360 广告系列,指定广告投放时间、使用的着陆页以及其他属性。
cm360CampaignName CM360 广告系列名称 促成关键事件的 CM360 广告系列名称。您可以配置 CM360 广告系列,指定广告投放时间、使用的着陆页以及其他属性。
cm360CreativeFormat CM360 广告素材格式 促成关键事件的 CM360 广告素材格式。CM360 广告素材格式也称为广告素材类型。
cm360CreativeId CM360 广告素材 ID 促成关键事件的 CM360 广告素材 ID。用于标识 CM360 广告素材。
cm360CreativeName CM360 广告素材名称 促成关键事件的 CM360 广告素材名称。为 CM360 广告素材指定的名称。
cm360CreativeType CM360 广告素材类型 促成关键事件的 CM360 广告素材类型。CM360 广告素材的类别,例如“展示广告”或“跟踪广告”。如需了解详情,请参阅管理广告素材
cm360CreativeTypeId CM360 广告素材类型 ID 促成关键事件的 CM360 广告素材类型 ID。用于标识 CM360 广告素材类型。
cm360CreativeVersion CM360 广告素材版本 促成关键事件的 CM360 广告素材版本。版本号有助于您在报告中跟踪广告素材的多个版本。如果您为现有广告素材上传一个新的素材资源,版本号就会加 1。
cm360Medium CM360 媒介 促成关键事件的 CM360 媒介。CM360 媒介也称为展示位置费用结构。
cm360PlacementCostStructure CM360 展示位置费用结构 促成关键事件的 CM360 展示位置费用结构。展示位置费用结构用于规范媒体费用的计算方式。例如“CPM”。
cm360PlacementId CM360 展示位置 ID 促成关键事件的 CM360 展示位置 ID。用于标识 CM360 展示位置。展示位置是用来展示您广告的网站的一部分。
cm360PlacementName CM360 展示位置名称 促成关键事件的 CM360 展示位置名称。CM360 展示位置的指定名称。展示位置是用来展示您广告的网站的一部分。
cm360RenderingId CM360 呈现 ID 促成关键事件的 CM360 呈现 ID。用于标识 CM360 广告素材。
cm360SiteId CM360 网站 ID 促成关键事件的 CM360 网站 ID。用于标识 CM360 网站。
cm360SiteName CM360 网站名称 促成关键事件的 CM360 网站名称。购买广告空间的 CM360 网站名称。
cm360Source CM360 来源 促成关键事件的 CM360 来源。CM360 来源也称为网站名称。
cm360SourceMedium CM360 来源/媒介 促成关键事件的 CM360 来源媒介。来源和媒介的组合。
cohort 同类群组 请求中的同类群组名称。同类群组是指在任意连续几天内开始使用您的网站或应用的一组用户。如果请求中未指定同类群组名称,系统会按从零开始的编号为同类群组命名,例如 cohort_0 和 cohort_1。
cohortNthDay 每日同类群组 同类群组中用户相对于 firstSessionDate 的天数偏移。例如,如果选择的同类群组的开始日期和结束日期为 2020-03-01,那么对于 2020-03-02,cohortNthDay 将为 0001。
cohortNthMonth 每月同类群组 同类群组中用户的 firstSessionDate 相对于月份偏移量。月边界与日历月边界一致。例如,如果选择的同类群组的开始日期和结束日期均为 2020 年 3 月,那么对于 2020 年 4 月的任何日期,cohortNthMonth 均为 0001。
cohortNthWeek 每周同类群组 同类群组中用户相对于 firstSessionDate 的周偏移量。一周从星期日开始,到星期六结束。例如,如果选择的同类群组的开始日期和结束日期在 2020-11-08 到 2020-11-14 之间,那么对于 2020-11-15 到 2020-11-21 之间的日期,cohortNthWeek 将为 0001。
contentGroup 内容分组 适用于已发布内容项的类别。由事件参数 content_group 填充。
contentId 内容 ID 所选内容的标识符。由事件参数 content_id 填充。
contentType 内容类型 所选内容的类别。由事件参数 content_type 填充。
continent 大洲 用户发起活动时所处的大洲。例如,AmericasAsia
continentId 大洲 ID 用户发起活动时所处的大洲的地理 ID,基于其 IP 地址派生而来。
country 国家/地区 发起用户活动的国家/地区。
countryId 国家/地区 ID 发起用户活动时所处国家/地区的地理 ID,基于 IP 地址得出。格式应符合 ISO 3166-1 alpha-2 标准。
currencyCode 币种 电子商务事件的本地货币代码(基于 ISO 4217 标准)。例如 USDGBP。 在代码植入中,币种由 currency 参数指定。使用多种货币进行交易的商家可以在向 Google Analytics 发送电子商务事件时指定一种本地货币代码,此维度会显示这些货币。如需了解详情,请参阅货币参考文档
date 日期 事件的日期,格式为 YYYYMMDD。
dateHour 日期 + 时点 (YYYYMMDDhh) 日期和小时的组合值,格式为 YYYYMMDDHH。
dateHourMinute 日期、小时和分钟 日期、小时和分钟的组合值,格式为 YYYYMMDDHHMM。
day 一个月中的某天(以 01 到 31 之间的两位数字表示)。
dayOfWeek 周几 星期几的整数值。它会返回 0 到 6 范围内的值,其中星期日是一周的第一天。
dayOfWeekName 周几名称 星期几(英文)。此维度具有星期日或星期一等值。
defaultChannelGroup 默认渠道组 关键事件的默认渠道组主要基于来源和媒介,一个枚举,其中包括 DirectOrganic SearchPaid SocialOrganic SocialEmailAffiliatesReferralPaid SearchVideoDisplay
deviceCategory 设备类别 设备类型:桌面设备、平板电脑或移动设备。
deviceModel 设备型号 移动设备型号(例如:iPhone 10,6)。
dv360AdvertiserId DV360 广告客户 ID 促成关键事件的 DV360 广告客户 ID。用于标识 DV360 广告客户。
dv360AdvertiserName DV360 广告客户名称 促成关键事件的 DV360 广告客户名称。DV360 广告客户是指投放广告系列的真实商家。
dv360CampaignId DV360 广告系列 ID 促成关键事件的 DV360 广告系列 ID。用于标识 DV360 广告系列。
dv360CampaignName DV360 广告系列名称 促成关键事件的 DV360 广告系列名称。DV360 广告系列可将有着共同业务目标的相关广告订单分成一组。
dv360CreativeFormat DV360 广告素材格式 促成关键事件的 DV360 广告素材格式。也称为广告素材类型。例如,可展开式广告、视频广告或原生广告。
dv360CreativeId DV360 广告素材 ID 促成关键事件的 DV360 广告素材 ID。用于标识 DV360 广告素材。
dv360CreativeName DV360 广告素材名称 促成关键事件的 DV360 广告素材名称。为 DV360 广告素材指定的名称。
dv360ExchangeId DV360 广告交易平台 ID 促成关键事件的 DV360 广告交易平台 ID。用于标识 DV360 广告交易平台。
dv360ExchangeName DV360 广告交易平台名称 促成关键事件的 DV360 广告交易平台名称。发生广告点击的 DV360 广告交易平台。如需了解详情,请参阅管理广告交易平台
dv360InsertionOrderId DV360 广告订单 ID 促成关键事件的 DV360 广告订单 ID。用于标识 DV360 广告订单。
dv360InsertionOrderName DV360 广告订单名称 促成关键事件的 DV360 广告订单名称。DV360 广告订单包含一组与同一广告系列相关的订单项。
dv360LineItemId DV360 订单项 ID 促成关键事件的 DV360 订单项 ID。用于标识 DV360 订单项。
dv360LineItemName DV360 订单项名称 促成关键事件的 DV360 订单项名称。DV360 订单项会对展示机会出价并向广告资源来源投放广告素材。
dv360Medium DV360 媒介 促成关键事件的 DV360 媒介。广告订单的可结算结果。例如 cpm
dv360PartnerId DV360 合作伙伴 ID 促成关键事件的 DV360 合作伙伴 ID。用于标识 DV360 合作伙伴。
dv360PartnerName DV360 合作伙伴名称 促成关键事件的 DV360 合作伙伴名称。DV360 合作伙伴是指代理机构、交易公司或大型的单个广告客户。
dv360Source DV360 来源 促成关键事件的 DV360 来源。展示了相应广告的 DV360 网站的名称。
dv360SourceMedium DV360 来源/媒介 促成关键事件的 DV360 来源媒介。来源和媒介的组合。
eventName 事件名称 事件名称。
fileExtension 文件扩展名 已下载文件的扩展名(例如 pdftxt)。如果启用了增强型衡量功能,则系统会自动填充此维度。由事件参数 file_extension 填充。
fileName 文件名 已下载文件的网页路径(例如 /menus/dinner-menu.pdf)。如果启用了增强型衡量功能,则系统会自动填充此维度。由事件参数 file_name 填充。
firstSessionDate 首次会话日期 用户首次会话的日期,格式为 YYYYMMDD。
firstUserCampaignId 带来用户首次互动的广告系列 ID 首次获取用户的营销广告系列的标识符。包括 Google Ads 广告系列、人工出价广告系列和其他广告系列。
firstUserCampaignName 带来用户首次互动的广告系列 首次获取用户的营销广告系列的名称。包括 Google Ads 广告系列、人工出价广告系列和其他广告系列。
firstUserCm360AccountId 带来用户首次互动的 CM360 账号 ID 最初获取用户的 CM360 账号 ID。用于标识 CM360 账号。
firstUserCm360AccountName 带来用户首次互动的 CM360 账号名称 最初获取用户的 CM360 账号名称。CM360 账号包含广告客户、网站、广告系列和用户个人资料。
firstUserCm360AdvertiserId 带来用户首次互动的 CM360 广告客户 ID 最初获取用户的 CM360 广告客户 ID。用于标识 CM360 广告客户。
firstUserCm360AdvertiserName 带来用户首次互动的 CM360 广告客户名称 最初获取用户的 CM360 广告客户名称。CM360 广告客户包含一组广告系列、广告素材资源和其他设置。
firstUserCm360CampaignId 带来用户首次互动的 CM360 广告系列 ID 最初获取用户的 CM360 广告系列 ID。用于标识 CM360 广告系列。
firstUserCm360CampaignName 带来用户首次互动的 CM360 广告系列名称 最初获取用户的 CM360 广告系列名称。您可以配置 CM360 广告系列,指定广告投放时间、使用的着陆页以及其他属性。
firstUserCm360CreativeFormat 带来用户首次互动的 CM360 广告素材格式 最初获取用户的 CM360 广告素材格式。CM360 广告素材格式也称为广告素材类型。
firstUserCm360CreativeId 带来用户首次互动的 CM360 广告素材 ID 最初获取用户的 CM360 广告素材 ID。用于标识 CM360 广告素材。
firstUserCm360CreativeName 带来用户首次互动的 CM360 广告素材名称 最初获取用户的 CM360 广告素材名称。为 CM360 广告素材指定的名称。
firstUserCm360CreativeType 带来用户首次互动的 CM360 广告素材类型 最初获取用户的 CM360 广告素材类型。CM360 广告素材的类别,例如“展示广告”或“跟踪广告”。如需了解详情,请参阅管理广告素材
firstUserCm360CreativeTypeId 带来用户首次互动的 CM360 广告素材类型 ID 最初获取用户的 CM360 广告素材类型 ID。用于标识 CM360 广告素材类型。
firstUserCm360CreativeVersion 带来用户首次互动的 CM360 广告素材版本 最初获取用户的 CM360 广告素材版本。版本号有助于您在报表中跟踪广告素材的多个版本。如果您为现有广告素材上传一个新的素材资源,版本号就会加 1。
firstUserCm360Medium 带来用户首次互动的 CM360 媒介 最初获取用户的 CM360 媒介。CM360 媒介也称为展示位置费用结构。
firstUserCm360PlacementCostStructure 带来用户首次互动的 CM360 展示位置费用结构 最初获取用户的 CM360 展示位置费用结构。展示位置费用结构用于规范媒体费用的计算方式。例如“CPM”。
firstUserCm360PlacementId 带来用户首次互动的 CM360 展示位置 ID 最初获取用户的 CM360 展示位置 ID。用于标识 CM360 展示位置。展示位置是用来展示您广告的网站的一部分。
firstUserCm360PlacementName 带来用户首次互动的 CM360 展示位置名称 最初获取用户的 CM360 展示位置名称。CM360 展示位置的指定名称。展示位置是用来展示您广告的网站的一部分。
firstUserCm360RenderingId 带来用户首次互动的 CM360 呈现 ID 最初获取用户的 CM360 呈现 ID。用于标识 CM360 广告素材。
firstUserCm360SiteId 带来用户首次互动的 CM360 网站 ID 最初获取用户的 CM360 网站 ID。用于标识 CM360 网站。
firstUserCm360SiteName 带来用户首次互动的 CM360 网站名称 最初获取用户的 CM360 网站名称。购买广告空间的 CM360 网站名称。
firstUserCm360Source 带来用户首次互动的 CM360 来源 最初获取用户的 CM360 来源。CM360 来源也称为网站名称。
firstUserCm360SourceMedium 带来用户首次互动的 CM360 来源/媒介 最初获取用户的 CM360 来源媒介。来源和媒介的组合。
firstUserDefaultChannelGroup 带来用户首次互动的默认渠道组 首次获取用户时所用的默认渠道组。默认渠道组主要基于来源和媒介。一个枚举,其中包括 DirectOrganic SearchPaid SocialOrganic SocialEmailAffiliatesReferralPaid SearchVideoDisplay
firstUserDv360AdvertiserId 带来用户首次互动的 DV360 广告客户 ID 最初获取用户的 DV360 广告客户 ID。用于标识 DV360 广告客户。
firstUserDv360AdvertiserName 带来用户首次互动的 DV360 广告客户名称 最初获取用户的 DV360 广告客户名称。DV360 广告客户是指投放广告系列的真实商家。
firstUserDv360CampaignId 带来用户首次互动的 DV360 广告系列 ID 最初获取用户的 DV360 广告系列 ID。用于标识 DV360 广告系列。
firstUserDv360CampaignName 带来用户首次互动的 DV360 广告系列名称 最初获取用户的 DV360 广告系列名称。DV360 广告系列可将有着共同业务目标的相关广告订单分成一组。
firstUserDv360CreativeFormat 带来用户首次互动的 DV360 广告素材格式 最初获取用户的 DV360 广告素材格式。也称为广告素材类型。例如,可展开式广告、视频广告或原生广告。
firstUserDv360CreativeId 带来用户首次互动的 DV360 广告素材 ID 最初获取用户的 DV360 广告素材 ID。用于标识 DV360 广告素材。
firstUserDv360CreativeName 带来用户首次互动的 DV360 广告素材名称 最初获取用户的 DV360 广告素材名称。为 DV360 广告素材指定的名称。
firstUserDv360ExchangeId 带来用户首次互动的 DV360 广告交易平台 ID 最初获取用户的 DV360 广告交易平台 ID。用于标识 DV360 广告交易平台。
firstUserDv360ExchangeName 带来用户首次互动的 DV360 广告交易平台名称 最初获取用户的 DV360 广告交易平台名称。发生广告点击的 DV360 广告交易平台。如需了解详情,请参阅管理广告交易平台
firstUserDv360InsertionOrderId 带来用户首次互动的 DV360 广告订单 ID 最初获取用户的 DV360 广告订单 ID。用于标识 DV360 广告订单。
firstUserDv360InsertionOrderName 带来用户首次互动的 DV360 广告订单名称 最初获取用户的 DV360 广告订单名称。DV360 广告订单包含一组与同一广告系列相关的订单项。
firstUserDv360LineItemId 带来用户首次互动的 DV360 订单项 ID 最初获取用户的 DV360 订单项 ID。用于标识 DV360 订单项。
firstUserDv360LineItemName 带来用户首次互动的 DV360 订单项名称 最初获取用户的 DV360 订单项名称。DV360 订单项会对展示机会出价并向广告资源来源投放广告素材。
firstUserDv360Medium 带来用户首次互动的 DV360 媒介 最初获取用户的 DV360 媒介。广告订单的可结算结果。例如 cpm
firstUserDv360PartnerId 带来用户首次互动的 DV360 合作伙伴 ID 最初获取用户的 DV360 合作伙伴 ID。用于标识 DV360 合作伙伴。
firstUserDv360PartnerName 带来用户首次互动的 DV360 合作伙伴名称 最初获取用户的 DV360 合作伙伴名称。DV360 合作伙伴代表代理机构、交易公司或大型的单个广告客户。
firstUserDv360Source 带来用户首次互动的 DV360 来源 最初获取用户的 DV360 来源。展示了相应广告的 DV360 网站的名称。
firstUserDv360SourceMedium 带来用户首次互动的 DV360 来源/媒介 最初获取用户的 DV360 来源媒介。来源和媒介的组合。
firstUserGoogleAdsAccountName 带来用户首次互动的 Google Ads 账号名称 首次获取用户时所用的 Google Ads 账号名称。
firstUserGoogleAdsAdGroupId 带来用户首次互动的 Google Ads 广告组 ID 首次获取用户时所用的 Google Ads 广告组 ID。
firstUserGoogleAdsAdGroupName 带来用户首次互动的 Google Ads 广告组名称 首次获取用户时所用的 Google Ads 广告组名称。
firstUserGoogleAdsAdNetworkType 带来用户首次互动的 Google Ads 广告网络类型 首次获取用户的广告网络。一个枚举,其中包含 Google searchSearch partnersGoogle Display NetworkYoutube SearchYoutube VideosCross-networkSocial(universal campaign)
firstUserGoogleAdsCampaignId 带来用户首次互动的 Google Ads 广告系列 ID 首次获取用户的 Google Ads 营销广告系列的标识符。
firstUserGoogleAdsCampaignName 带来用户首次互动的 Google Ads 广告系列 首次获取用户的 Google Ads 营销广告系列的名称。
firstUserGoogleAdsCampaignType 首个带来用户交互的 Google Ads 广告系列类型 首次获取用户的 Google Ads 广告系列的广告系列类型。广告系列类型决定了客户会在何处看到您的广告,以及您可以在 Google Ads 中使用哪些设置和选项。广告系列类型是一个枚举,包括搜索广告系列、展示广告系列、购物广告系列、视频广告系列、需求开发广告系列、应用广告系列、智能广告系列、酒店广告系列、本地广告系列和效果最大化广告系列。如需了解详情,请参阅选择合适的广告系列类型
firstUserGoogleAdsCreativeId 带来用户首次互动的 Google Ads 广告素材 ID 首次获取用户的 Google Ads 广告素材的 ID。广告素材 ID 用于标识各个广告。
firstUserGoogleAdsCustomerId 带来用户首次互动的 Google Ads 客户 ID 首次获取用户时所用的 Google Ads 客户 ID。Google Ads 中的客户 ID 用于唯一标识 Google Ads 账号。
firstUserGoogleAdsKeyword 带来用户首次互动的 Google Ads 关键字文字 带来用户首次互动的 Google Ads 关键字文字
firstUserGoogleAdsQuery 带来用户首次互动的 Google Ads 查询 首次获取用户时所用的搜索查询。
firstUserManualAdContent 带来用户首次互动的人工广告内容 首次获取用户时使用的广告内容。由 utm_content 参数填充。
firstUserManualCampaignId 带来用户首次互动的人工广告系列 ID 最初获取用户的手动广告系列 ID。用于标识人工广告系列。由 utm_id 网址参数填充。
firstUserManualCampaignName 带来用户首次互动的人工广告系列名称 最初获取用户的手动广告系列名称。人工广告系列的名称。由 utm_campaign 网址参数填充。如需了解详情,请参阅使用自定义网址收集广告系列数据
firstUserManualCreativeFormat 带来用户首次互动的手动创建的广告素材格式 最初获取用户的手动创建的广告素材格式。用于标识广告中使用的广告素材格式。由 utm_creative_format 网址参数填充。
firstUserManualMarketingTactic 带来用户首次互动的人工营销策略 最初获取用户的手动营销策略。应用于广告系列的定位条件。例如,再营销或潜在客户发掘。由 utm_marketing_tactic 网址参数填充。
firstUserManualMedium 带来用户首次互动的人工媒介 最初获取用户的手动创建的媒介。引荐来源网址中使用的营销媒介。例如,cpc。由 utm_medium 网址参数填充。
firstUserManualSource 带来用户首次互动的人工来源 最初获取用户的手动来源。引荐来源网址。由 utm_source 网址参数填充。
firstUserManualSourceMedium 带来用户首次互动的人工来源/媒介 最初获取用户的手动来源媒介。来源和媒介的组合。
firstUserManualSourcePlatform 带来用户首次互动的人工来源平台 最初获取用户的手动来源平台。该平台负责将流量引导至指定 Analytics 媒体资源。由 utm_source_platform 网址参数填充。
firstUserManualTerm 带来用户首次互动的人工字词 首次获取用户时使用的字词。由 utm_term 参数填充。
firstUserMedium 带来用户首次互动的媒介 首次将用户引至您的网站或应用的媒介。
firstUserPrimaryChannelGroup 带来用户首次互动的主渠道组 最初获取用户的主渠道组。主要渠道组是 Google Analytics 标准报告中使用的渠道组,可实时记录媒体资源数据随渠道分组调整的变化情况。如需了解详情,请参阅自定义渠道组
firstUserSa360AdGroupId 带来用户首次互动的 SA360 广告组 ID 最初获取用户的 SA360 广告组 ID。用于标识 SA360 广告组。
firstUserSa360AdGroupName 带来用户首次互动的 SA360 广告组名称 最初获取用户的 SA360 广告组名称。SA360 广告组包含相互关联的广告和关键字。
firstUserSa360CampaignId 带来用户首次互动的 SA360 广告系列 ID 最初获取用户的 SA360 广告系列 ID。用于标识 SA360 广告系列。
firstUserSa360CampaignName 带来用户首次互动的 SA360 广告系列 最初获取用户的 SA360 广告系列名称。您可以使用 SA360 广告系列来整理广告和设定广告目标。
firstUserSa360CreativeFormat 带来用户首次互动的 SA360 广告素材格式 最初获取用户的 SA360 广告素材格式。广告素材格式是指广告系列中所用广告的具体版式或设计。
firstUserSa360EngineAccountId 带来用户首次互动的 SA360 引擎账号 ID 最初获取用户的 SA360 引擎账号 ID。用于标识 SA360 引擎账号。
firstUserSa360EngineAccountName 带来用户首次互动的 SA360 引擎账号名称 最初获取用户的 SA360 引擎账号名称。SA360 引擎账号包含广告账号中的广告系列、广告组和其他内容。
firstUserSa360EngineAccountType 带来用户首次互动的 SA360 引擎账号类型 最初获取用户的 SA360 引擎账号类型。搜索引擎账号使用的引擎类型。
firstUserSa360KeywordText 带来用户首次互动的 SA360 关键字文字 最初获取用户的 SA360 关键字文字。与搜索查询匹配的关键字。
firstUserSa360ManagerAccountId 带来用户首次互动的 SA360 经理账号 ID 最初获取用户的 SA360 经理账号 ID。用于标识 SA360 经理账号。
firstUserSa360ManagerAccountName 带来用户首次互动的 SA360 经理账号名称 最初获取用户的 SA360 经理账号名称。Search Ads 360 账号层次结构的顶层,用于跨较低级别的子级经理账号和客户账号进行管理和报告。
firstUserSa360Medium 带来用户首次互动的 SA360 媒介 最初获取用户的 SA360 媒介。广告购买交易中使用的付款模式。例如 cpc
firstUserSa360Query 带来用户首次互动的 SA360 查询 最初获取用户的 SA360 查询。用户输入的搜索查询。
firstUserSa360Source 带来用户首次互动的 SA360 来源 最初获取用户的 SA360 来源。搜索查询发生在此网站上。
firstUserSa360SourceMedium 带来用户首次互动的 SA360 来源/媒介 最初获取用户的 SA360 来源媒介。来源和媒介的组合。
firstUserSource 带来用户首次互动的来源 首次将用户引到您的网站或应用的来源。
firstUserSourceMedium 带来用户首次互动的来源/媒介 维度 firstUserSourcefirstUserMedium 的组合值。
firstUserSourcePlatform 带来用户首次互动的来源平台 首次获取用户时所用的来源平台。对于使用 UTM 的流量,请勿依赖此字段返回 Manual;在即将推出的功能中,此字段将从返回 Manual 更新为返回 (not set)
fullPageUrl 完整网址 所访问网页的主机名、网页路径和查询字符串;例如,https://www.example.com/store/contact-us?query_string=truefullPageUrl 部分为 www.example.com/store/contact-us?query_string=true
googleAdsAccountName Google Ads 账号名称 促成关键事件的广告系列在 Google Ads 中的账号名称。对应于 Google Ads API 中的 customer.descriptive_name
googleAdsAdGroupId Google Ads 广告组 ID 归因于关键事件的 Google Ads 广告组 ID。
googleAdsAdGroupName Google Ads 广告组名称 归因于关键事件的广告组名称。
googleAdsAdNetworkType Google Ads 广告网络类型 关键事件的广告网络类型。一个枚举,其中包含 Google searchSearch partnersGoogle Display NetworkYoutube SearchYoutube VideosCross-networkSocial(universal campaign)
googleAdsCampaignId Google Ads 广告系列 ID 归因于关键事件的 Google Ads 广告系列的广告系列 ID。
googleAdsCampaignName Google Ads 广告系列 归因于关键事件的 Google Ads 广告系列的广告系列名称。
googleAdsCampaignType Google Ads 广告系列类型 归因于关键事件的 Google Ads 广告系列的广告系列类型。广告系列类型决定了客户会在何处看到您的广告,以及您可以在 Google Ads 中使用哪些设置和选项。广告系列类型是一个枚举,包括搜索广告系列、展示广告系列、购物广告系列、视频广告系列、需求开发广告系列、应用广告系列、智能广告系列、酒店广告系列、本地广告系列和效果最大化广告系列。如需了解详情,请参阅选择合适的广告系列类型
googleAdsCreativeId Google Ads 广告素材 ID 归因于关键事件的 Google Ads 广告素材的 ID。广告素材 ID 用于标识各个广告。
googleAdsCustomerId Google Ads 客户 ID 促成关键事件的广告系列在 Google Ads 中的客户 ID。Google Ads 中的客户 ID 用于唯一标识 Google Ads 账号。
googleAdsKeyword Google Ads 关键字文字 促成关键事件的匹配关键字。关键字是对您的产品或服务起到描述作用的字词或词组,通过选择关键字,您可以向合适的客户展示您的广告。如需详细了解关键字,请参阅关键字:定义
googleAdsQuery Google Ads 查询 促成关键事件的搜索查询。
groupId 群组 ID 游戏中针对某个事件的玩家群组 ID。由事件参数 group_id 填充。
hostName 主机名 包括网址的子网域和域名;例如,www.example.com/contact.html 的主机名为 www.example.com。
hour 小时 事件记录当天的两位数小时。此维度的范围为 0-23,并以媒体资源所在的时区报告。
isKeyEvent 是关键事件 如果事件是按键事件,则为字符串 true。将事件标记为关键事件会从创建之时起影响报告,但不会更改历史数据。您可以在 Google Analytics 中将任何事件标记为关键事件,有些事件(例如 first_openpurchase)默认情况下会被标记为关键事件。
isoWeek ISO 周序号 ISO 周序号,每周从星期一开始。如需了解详情,请参阅 http://zh.wikipedia.org/wiki/ISO_week_date。示例值包括 01、02 和 53。
isoYear ISO 年份 事件的 ISO 年份。如需了解详情,请参阅 http://zh.wikipedia.org/wiki/ISO_week_date。示例值包括 2022 和 2023。
isoYearIsoWeek ISO 年份 + ISO 周序号 isoWeek 和 isoYear 的组合值。示例值包括 201652 和 201701。
itemAffiliation 商品关联商户 与单件商品关联的联属营销企业(合作伙伴/供应商;如果有)的名称或代码。由 affiliation 项参数填充。
itemBrand 商品品牌 商品的品牌名称。
itemCategory 商品类别 商品所属的层次结构类别。例如,在“服饰/男装/夏装/衬衫/T 恤”中,“服饰”为商品类别。
itemCategory2 商品类别 2 商品所属的层次结构类别。例如,在“服饰/男装/夏装/衬衫/T 恤”中,“男装”为商品类别 2。
itemCategory3 商品类别 3 商品所属的层次结构类别。例如,在“服饰/男装/夏装/衬衫/T 恤”中,“夏装”为商品类别 3。
itemCategory4 商品类别 4 商品所属的层次结构类别。例如,在“服饰/男装/夏装/衬衫/T 恤”中,“衬衫”为商品类别 4。
itemCategory5 商品类别 5 商品所属的层次结构类别。例如,在“服饰/男装/夏装/衬衫/T 恤”中,“T 恤”为商品类别 5。
itemId 商品 ID 商品的 ID。
itemListId 商品列表 ID 商品列表的 ID。
itemListName 商品列表名称 商品列表的名称。
itemListPosition 商品列表位置 商品在列表中的位置。例如,列表中您销售的商品。此维度会在代码植入过程中通过 items 数组中的 index 参数进行填充。
itemLocationID 商品位置 ID 与商品关联的实际位置。例如,实体店位置。建议使用与相关商品对应的 Google 地点 ID,也可使用自定义地理位置 ID。此字段在添加代码时由 items 数组中的 location_id 参数填充。
itemName 商品名称 商品的名称。
itemPromotionCreativeName 商品推广活动的广告素材名称 商品促销活动所用广告素材的名称。
itemPromotionCreativeSlot 商品促销活动广告素材投放到的广告位 与商品相关的促销广告素材投放到的广告位的名称。您可以在事件级或商品级通过 creative_slot 参数在代码植入中指定此维度。如果同时在事件级和商品级指定了该参数,系统会使用商品级参数。
itemPromotionId 商品促销活动的 ID 商品促销活动的 ID。
itemPromotionName 商品促销活动名称 商品促销活动的名称。
itemVariant 商品款式 产品的特定款式/规格。例如,尺码(XS、S、M 或 L)或颜色(红色、蓝色、绿色或黑色)。由 item_variant 参数填充。
landingPage 着陆页 与会话的首次网页浏览相关联的网页路径。
landingPagePlusQueryString 着陆页 + 查询字符串 与会话的首次网页浏览相关联的网页路径 + 查询字符串。
language 语言 用户浏览器或设备的语言设置。例如 English
languageCode 语言代码 用户浏览器或设备的语言设置 (ISO 639)。例如 en-us
level 级别 玩家在游戏中的等级。由事件参数 level 填充。
linkClasses 链接类 出站链接的 HTML class 属性。例如,如果用户点击链接 <a class="center" href="www.youtube.com">,此维度将返回 center。如果启用了增强型衡量功能,则自动填充数据。由事件参数 link_classes 填充。
linkDomain 链接域名 出站链接的目标网域。例如,如果用户点击链接 <a href="www.youtube.com">,此维度将返回 youtube.com。如果启用了增强型衡量功能,则自动填充数据。由事件参数 link_domain 填充。
linkId 关联 ID 出站链接或文件下载的 HTML ID 属性。例如,如果用户点击链接 <a id="socialLinks" href="www.youtube.com">,此维度将返回 socialLinks。如果启用了增强型衡量功能,则自动填充数据。由事件参数 link_id 填充。
linkText 链接文字 文件下载的链接文字。如果启用了增强型衡量功能,则自动填充数据。由事件参数 link_text 填充。
linkUrl 链接网址 出站链接或文件下载的完整网址。例如,如果用户点击链接 <a href="https://www.youtube.com/results?search_query=analytics">,此维度将返回 https://www.youtube.com/results?search_query=analytics。如果启用了增强型衡量功能,则自动填充数据。由事件参数 link_url 填充。
manualAdContent 人工广告内容 归因于关键事件的广告内容。由 utm_content 参数填充。
manualCampaignId 人工广告系列 ID 促成关键事件的人工广告系列 ID。用于标识人工广告系列。由 utm_id 网址参数填充。
manualCampaignName 人工广告系列名称 促成关键事件的人工广告系列名称。人工广告系列的名称。由 utm_campaign 网址参数填充。如需了解详情,请参阅使用自定义网址收集广告系列数据
manualCreativeFormat 人工广告素材格式 促成关键事件的手动创建的广告素材格式。用于标识广告中使用的广告素材格式。由 utm_creative_format 网址参数填充。
manualMarketingTactic 人工营销策略 促成关键事件的人工营销策略。应用于广告系列的定位条件。例如,再营销或潜在客户发掘。由 utm_marketing_tactic 网址参数填充。
manualMedium 人工媒介 促成关键事件的人工媒介。引荐来源网址中使用的营销媒介。例如,cpc。由 utm_medium 网址参数填充。
manualSource 人工来源 促成关键事件的人工来源。引荐来源网址。由 utm_source 网址参数填充。
manualSourceMedium 人工来源/媒介 促成关键事件的人工来源媒介。来源和媒介的组合。
manualSourcePlatform 人工来源平台 促成关键事件的人工来源平台。该平台负责将流量引导至指定 Analytics 媒体资源。由 utm_source_platform 网址参数填充。
manualTerm 人工字词 归因于关键事件的字词。由 utm_term 参数填充。
medium 归因于关键事件的媒介。
method 方法 触发事件的方式。由事件参数 method 填充。
minute 分钟 事件记录的小时的两位数分钟。此维度介于 0 到 59 之间,并以媒体资源所在的时区报告。
mobileDeviceBranding 设备品牌 制造商或品牌名称(例如 Samsung、HTC、Verizon、T-Mobile)。
mobileDeviceMarketingName 设备 品牌设备名称(例如 Galaxy S10 或 P30 Pro)。
mobileDeviceModel 移动设备型号 移动设备型号名称(例如:iPhone X 或 SM-G950F)。
month 事件的月份(以 01 到 12 之间的两位数字表示)。
newVsReturning 新用户/回访用户 新用户之前没有发起过会话,而回访用户之前发起过 1 次或更多会话。此维度会返回两个值:newreturning
nthDay 第 N 天 自日期范围的起始日期起经过的天数。
nthHour 第 N 个小时 自日期范围的起始日期起经过的小时数。起始小时为 0000。
nthMinute 第 N 分钟 自日期范围的起始日期起经过的分钟数。起始分钟为 0000。
nthMonth 第 N 个月 自日期范围的起始日期起所经过的月数。起始月份为 0000。
nthWeek 第 N 周 一个数字,表示自日期范围的起始日期起所经过的周数。
nthYear 第 N 年 自日期范围的起始日期起经过的年数。起始年份为 0000。
operatingSystem 操作系统 应用或网站的访问者使用的操作系统,包括 Windows 和 Android 等桌面操作系统和移动操作系统。
operatingSystemVersion 操作系统版本 您的网站或应用的访问者使用的操作系统版本。例如,Android 10 的版本为 10,iOS 13.5.1 的版本为 13.5.1。
operatingSystemWithVersion 操作系统及版本 操作系统和版本。例如 Android 10 或 Windows 7。
orderCoupon 订单优惠券 订单级优惠券的代码。
outbound 出站 如果链接指向的网站不属于相应媒体资源的网域,则返回 true。如果启用了增强型衡量功能,则自动填充数据。由事件参数 outbound 填充。
pageLocation 网页位置 所访问网页的协议、主机名、网页路径和查询字符串;例如,https://www.example.com/store/contact-us?query_string=truepageLocation 部分为 https://www.example.com/store/contact-us?query_string=true。由事件参数 page_location 填充。
pagePath 网页路径 访问过的网页的主机名和查询字符串之间的网址部分;例如,https://www.example.com/store/contact-us?query_string=true 的 pagePath 部分为 /store/contact-us
pagePathPlusQueryString 网页路径 + 查询字符串 访问过的网页的主机名后面的网址部分;例如,https://www.example.com/store/contact-us?query_string=truepagePathPlusQueryString 部分为 /store/contact-us?query_string=true
pageReferrer 网页引荐来源网址 包含主机名和路径的完整引荐来源网址。此引荐来源网址是用户之前所在的网址,可以是此网站的网域,也可以是其他网域。由事件参数 page_referrer 填充。
pageTitle 网页标题 您网站上使用的网页标题。
percentScrolled 已滚动百分比 用户向下滚动页面的百分比(例如 90)。如果启用了增强型衡量功能,则系统会自动填充此维度。由事件参数 percent_scrolled 填充。
platform 平台 指您的应用或网站在哪个平台上运行;例如 Web、iOS 或 Android。如需在报告中确定数据流的类型,请同时使用 platform 和 streamId。
platformDeviceCategory 平台类别/设备类别 您的网站或移动应用在哪个平台和设备上运行。(例如:Android / 移动设备)
primaryChannelGroup 主渠道组 关键事件归因到的主渠道组。主要渠道组是 Google Analytics 标准报告中使用的渠道组,可实时记录媒体资源数据随渠道分组调整的变化情况。如需了解详情,请参阅自定义渠道组
region 区域 发起用户活动的地理区域,依据 IP 地址得出。
sa360AdGroupId SA360 广告组 ID 促成关键事件的 SA360 广告组 ID。用于标识 SA360 广告组。
sa360AdGroupName SA360 广告组名称 促成关键事件的 SA360 广告组名称。SA360 广告组包含相互关联的广告和关键字。
sa360CampaignId SA360 广告系列 ID 促成关键事件的 SA360 广告系列 ID。用于标识 SA360 广告系列。
sa360CampaignName SA360 广告系列 促成关键事件的 SA360 广告系列名称。您可以使用 SA360 广告系列来整理广告和设定广告目标。
sa360CreativeFormat SA360 广告素材格式 促成关键事件的 SA360 广告素材格式。广告素材格式是指广告系列中所用广告的具体版式或设计。
sa360EngineAccountId SA360 引擎账号 ID 促成关键事件的 SA360 引擎账号 ID。用于标识 SA360 引擎账号。
sa360EngineAccountName SA360 引擎账号名称 促成关键事件的 SA360 引擎账号名称。SA360 引擎账号包含广告账号中的广告系列、广告组和其他内容。
sa360EngineAccountType SA360 引擎账号类型 促成关键事件的 SA360 引擎账号类型。搜索引擎账号使用的引擎类型。
sa360KeywordText SA360 关键字文字 促成关键事件的 SA360 关键字文字。与搜索查询匹配的关键字。
sa360ManagerAccountId SA360 经理账号 ID 促成关键事件的 SA360 经理账号 ID。用于标识 SA360 经理账号。
sa360ManagerAccountName SA360 经理账号名称 促成关键事件的 SA360 经理账号名称。Search Ads 360 账号层次结构的顶层,用于跨较低级别的子级经理账号和客户账号进行管理和报告。
sa360Medium SA360 媒介 促成关键事件的 SA360 媒介。广告购买交易中使用的付款模式。例如 cpc
sa360Query SA360 查询 促成关键事件的 SA360 查询。用户输入的搜索查询。
sa360Source SA360 来源 促成关键事件的 SA360 来源。搜索查询发生在此网站上。
sa360SourceMedium SA360 来源/媒介 促成关键事件的 SA360 来源媒介。来源和媒介的组合。
screenResolution 屏幕分辨率 用户显示器的屏幕分辨率。例如,1920x1080。
searchTerm 搜索字词 用户搜索的字词。例如,如果用户访问了 /some-page.html?q=some-term,此维度会返回 some-term。如果启用了增强型衡量功能,则自动填充数据。由事件参数 search_term 填充。
sessionCampaignId 带来会话的广告系列 ID 会话的营销广告系列 ID。包括 Google Ads 广告系列、人工出价广告系列和其他广告系列。
sessionCampaignName 带来会话的广告系列 会话的营销广告系列名称。包括 Google Ads 广告系列、人工出价广告系列和其他广告系列。
sessionCm360AccountId 带来会话的 CM360 账号 ID 促成会话的 CM360 账号 ID。用于标识 CM360 账号。
sessionCm360AccountName 带来会话的 CM360 账号名称 促成会话的 CM360 账号名称。CM360 账号包含广告客户、网站、广告系列和用户个人资料。
sessionCm360AdvertiserId 带来会话的 CM360 广告客户 ID 促成会话的 CM360 广告客户 ID。用于标识 CM360 广告客户。
sessionCm360AdvertiserName 带来会话的 CM360 广告客户名称 促成会话的 CM360 广告客户名称。CM360 广告客户包含一组广告系列、广告素材资源和其他设置。
sessionCm360CampaignId 带来会话的 CM360 广告系列 ID 促成会话的 CM360 广告系列 ID。用于标识 CM360 广告系列。
sessionCm360CampaignName 带来会话的 CM360 广告系列名称 促成会话的 CM360 广告系列名称。您可以配置 CM360 广告系列,指定广告投放时间、使用的着陆页以及其他属性。
sessionCm360CreativeFormat 带来会话的 CM360 广告素材格式 促成会话的 CM360 广告素材格式。CM360 广告素材格式也称为广告素材类型。
sessionCm360CreativeId 带来会话的 CM360 广告素材 ID 促成会话的 CM360 广告素材 ID。用于标识 CM360 广告素材。
sessionCm360CreativeName 带来会话的 CM360 广告素材名称 促成会话的 CM360 广告素材名称。为 CM360 广告素材指定的名称。
sessionCm360CreativeType 带来会话的 CM360 广告素材类型 促成会话的 CM360 广告素材类型。CM360 广告素材的类别,例如“展示广告”或“跟踪广告”。如需了解详情,请参阅管理广告素材
sessionCm360CreativeTypeId 带来会话的 CM360 广告素材类型 ID 促成会话的 CM360 广告素材类型 ID。用于标识 CM360 广告素材类型。
sessionCm360CreativeVersion 带来会话的 CM360 广告素材版本 促成会话的 CM360 广告素材版本。版本号有助于您在报表中跟踪广告素材的多个版本。如果您为现有广告素材上传一个新的素材资源,版本号就会加 1。
sessionCm360Medium 带来会话的 CM360 媒介 促成会话的 CM360 媒介。CM360 媒介也称为展示位置费用结构。
sessionCm360PlacementCostStructure 带来会话的 CM360 展示位置费用结构 促成会话的 CM360 展示位置费用结构。展示位置费用结构用于规范媒体费用的计算方式。例如“CPM”。
sessionCm360PlacementId 带来会话的 CM360 展示位置 ID 促成会话的 CM360 展示位置 ID。用于标识 CM360 展示位置。展示位置是用来展示您广告的网站的一部分。
sessionCm360PlacementName 带来会话的 CM360 展示位置名称 促成会话的 CM360 展示位置名称。CM360 展示位置的指定名称。展示位置是用来展示您广告的网站的一部分。
sessionCm360RenderingId 带来会话的 CM360 呈现 ID 促成会话的 CM360 呈现 ID。用于标识 CM360 广告素材。
sessionCm360SiteId 带来会话的 CM360 网站 ID 促成会话的 CM360 网站 ID。用于标识 CM360 网站。
sessionCm360SiteName 带来会话的 CM360 网站名称 促成会话的 CM360 网站名称。购买广告空间的 CM360 网站名称。
sessionCm360Source 带来会话的 CM360 来源 促成会话的 CM360 来源。CM360 来源也称为网站名称。
sessionCm360SourceMedium 带来会话的 CM360 来源/媒介 促成会话的 CM360 来源媒介。来源和媒介的组合。
sessionDefaultChannelGroup 带来会话的默认渠道组 会话的默认渠道组主要基于来源和媒介,一个枚举,其中包括 DirectOrganic SearchPaid SocialOrganic SocialEmailAffiliatesReferralPaid SearchVideoDisplay
sessionDv360AdvertiserId 带来会话的 DV360 广告客户 ID 促成会话的 DV360 广告客户 ID。用于标识 DV360 广告客户。
sessionDv360AdvertiserName 带来会话的 DV360 广告客户名称 促成会话的 DV360 广告客户名称。DV360 广告客户是指投放广告系列的真实商家。
sessionDv360CampaignId 带来会话的 DV360 广告系列 ID 促成会话的 DV360 广告系列 ID。用于标识 DV360 广告系列。
sessionDv360CampaignName 带来会话的 DV360 广告系列名称 促成会话的 DV360 广告系列名称。DV360 广告系列可将有着共同业务目标的相关广告订单分成一组。
sessionDv360CreativeFormat 带来会话的 DV360 广告素材格式 促成会话的 DV360 广告素材格式。也称为广告素材类型。例如,可展开式广告、视频广告或原生广告。
sessionDv360CreativeId 带来会话的 DV360 广告素材 ID 促成会话的 DV360 广告素材 ID。用于标识 DV360 广告素材。
sessionDv360CreativeName 带来会话的 DV360 广告素材名称 促成会话的 DV360 广告素材名称。为 DV360 广告素材指定的名称。
sessionDv360ExchangeId 带来会话的 DV360 广告交易平台 ID 促成会话的 DV360 广告交易平台 ID。用于标识 DV360 广告交易平台。
sessionDv360ExchangeName 带来会话的 DV360 广告交易平台名称 促成会话的 DV360 广告交易平台名称。发生广告点击的 DV360 广告交易平台。如需了解详情,请参阅管理广告交易平台
sessionDv360InsertionOrderId 带来会话的 DV360 广告订单 ID 促成会话的 DV360 广告订单 ID。用于标识 DV360 广告订单。
sessionDv360InsertionOrderName 带来会话的 DV360 广告订单名称 促成会话的 DV360 广告订单名称。DV360 广告订单包含一组与同一广告系列相关的订单项。
sessionDv360LineItemId 带来会话的 DV360 订单项 ID 促成会话的 DV360 订单项 ID。用于标识 DV360 订单项。
sessionDv360LineItemName 带来会话的 DV360 订单项名称 促成会话的 DV360 订单项名称。DV360 订单项会对展示机会出价并向广告资源来源投放广告素材。
sessionDv360Medium 带来会话的 DV360 媒介 促成会话的 DV360 媒介。广告订单的可结算结果。例如 cpm
sessionDv360PartnerId 带来会话的 DV360 合作伙伴 ID 促成会话的 DV360 合作伙伴 ID。用于标识 DV360 合作伙伴。
sessionDv360PartnerName 带来会话的 DV360 合作伙伴名称 促成会话的 DV360 合作伙伴名称。DV360 合作伙伴代表代理机构、交易公司或大型的单个广告客户。
sessionDv360Source 带来会话的 DV360 来源 促成会话的 DV360 来源。展示了相应广告的 DV360 网站的名称。
sessionDv360SourceMedium 带来会话的 DV360 来源/媒介 促成会话的 DV360 来源媒介。来源和媒介的组合。
sessionGoogleAdsAccountName 带来会话的 Google Ads 账号名称 促成会话的 Google Ads 账号名称。对应于 Google Ads API 中的 customer.descriptive_name。
sessionGoogleAdsAdGroupId 会话的 Google Ads 广告组 ID 会话在 Google Ads 中的广告组 ID。
sessionGoogleAdsAdGroupName 带来会话的 Google Ads 广告组名称 会话在 Google Ads 中的广告组名称。
sessionGoogleAdsAdNetworkType 带来会话的 Google Ads 广告网络类型 促成会话的广告网络。一个枚举,其中包含 Google searchSearch partnersGoogle Display NetworkYoutube SearchYoutube VideosCross-networkSocial(universal campaign)
sessionGoogleAdsCampaignId 带来会话的 Google Ads 广告系列 ID 促成此会话的 Google Ads 广告系列的广告系列 ID。
sessionGoogleAdsCampaignName 带来会话的 Google Ads 广告系列 促成此会话的 Google Ads 广告系列的广告系列名称。
sessionGoogleAdsCampaignType 带来会话的 Google Ads 广告系列类型 促成此会话的 Google Ads 广告系列的广告系列类型。广告系列类型决定了客户会在何处看到您的广告,以及您可以在 Google Ads 中使用哪些设置和选项。广告系列类型是一个枚举,包括搜索广告系列、展示广告系列、购物广告系列、视频广告系列、需求开发广告系列、应用广告系列、智能广告系列、酒店广告系列、本地广告系列和效果最大化广告系列。如需了解详情,请参阅选择合适的广告系列类型
sessionGoogleAdsCreativeId 会话 Google Ads 广告素材 ID 促成您网站或应用中会话的 Google Ads 广告素材的 ID。广告素材 ID 用于标识各个广告。
sessionGoogleAdsCustomerId 带来会话的 Google Ads 客户 ID 促成会话的 Google Ads 客户 ID。Google Ads 中的客户 ID 用于唯一标识 Google Ads 账号。
sessionGoogleAdsKeyword 会话的 Google Ads 关键字文字 促成会话的匹配关键字。关键字是对您的产品或服务起到描述作用的字词或词组,通过选择关键字,您可以向合适的客户展示您的广告。如需详细了解关键字,请参阅关键字:定义
sessionGoogleAdsQuery 会话的 Google Ads 查询 促成会话的搜索查询。
sessionManualAdContent 带来会话的人工广告内容 促成会话的广告内容。由 utm_content 参数填充。
sessionManualCampaignId 带来会话的人工广告系列 ID 促成会话的人工广告系列 ID。用于标识人工广告系列。由 utm_id 网址参数填充。
sessionManualCampaignName 带来会话的人工广告系列名称 促成会话的人工广告系列名称。人工广告系列的名称。由 utm_campaign 网址参数填充。如需了解详情,请参阅使用自定义网址收集广告系列数据
sessionManualCreativeFormat 带来会话的手动创建的广告素材格式 促成会话的手动创建的广告素材格式。用于标识广告中使用的广告素材格式。由 utm_creative_format 网址参数填充。
sessionManualMarketingTactic 带来会话的人工营销策略 促成会话的人工营销策略。应用于广告系列的定位条件。例如,再营销或潜在客户发掘。由 utm_marketing_tactic 网址参数填充。
sessionManualMedium 带来会话的人工媒介 促成会话的人工媒介。引荐来源网址中使用的营销媒介。例如,cpc。由 utm_medium 网址参数填充。
sessionManualSource 带来会话的人工来源 促成会话的人工来源。引荐来源网址。由 utm_source 网址参数填充。
sessionManualSourceMedium 带来会话的人工来源/媒介 促成会话的人工来源媒介。来源和媒介的组合。
sessionManualSourcePlatform 带来会话的人工来源平台 促成会话的人工来源平台。该平台负责将流量引导至指定 Analytics 媒体资源。由 utm_source_platform 网址参数填充。
sessionManualTerm 带来会话的人工字词 促成会话的字词。由 utm_term 参数填充。
sessionMedium 带来会话的媒介 在您的网站或应用中发起会话的媒介。
sessionPrimaryChannelGroup 带来会话的主渠道组 促成会话的主渠道组。主要渠道组是 Google Analytics 标准报告中使用的渠道组,可实时记录媒体资源数据随渠道分组调整的变化情况。如需了解详情,请参阅自定义渠道组
sessionSa360AdGroupId 带来会话的 SA360 广告组 ID 促成会话的 SA360 广告组 ID。用于标识 SA360 广告组。
sessionSa360AdGroupName 带来会话的 SA360 广告组名称 促成会话的 SA360 广告组名称。SA360 广告组包含相互关联的广告和关键字。
sessionSa360CampaignId 带来会话的 SA360 广告系列 ID 促成会话的 SA360 广告系列 ID。用于标识 SA360 广告系列。
sessionSa360CampaignName 带来会话的 SA360 广告系列 促成会话的 SA360 广告系列名称。您可以使用 SA360 广告系列来整理广告和设定广告目标。
sessionSa360CreativeFormat 带来会话的 SA360 广告素材格式 促成会话的 SA360 广告素材格式。广告素材格式是指广告系列中所用广告的具体版式或设计。
sessionSa360EngineAccountId 带来会话的 SA360 引擎账号 ID 促成会话的 SA360 引擎账号 ID。用于标识 SA360 引擎账号。
sessionSa360EngineAccountName 带来会话的 SA360 引擎账号名称 促成会话的 SA360 引擎账号名称。SA360 引擎账号包含广告账号中的广告系列、广告组和其他内容。
sessionSa360EngineAccountType 带来会话的 SA360 引擎账号类型 促成会话的 SA360 引擎账号类型。搜索引擎账号使用的引擎类型。例如 google adsbingbaidu
sessionSa360Keyword 带来会话的 SA360 关键字文字 促成会话的 SA360 关键字文字。与搜索查询匹配的关键字。
sessionSa360ManagerAccountId 带来会话的 SA360 经理账号 ID 促成会话的 SA360 经理账号 ID。用于标识 SA360 经理账号。
sessionSa360ManagerAccountName 带来会话的 SA360 经理账号名称 促成会话的 SA360 经理账号名称。Search Ads 360 账号层次结构的顶层,用于跨较低级别的子级经理账号和客户账号进行管理和报告。
sessionSa360Medium 带来会话的 SA360 媒介 促成会话的 SA360 媒介。广告购买交易中使用的付款模式。例如 cpc
sessionSa360Query 带来会话的 SA360 查询 促成会话的 SA360 查询。用户输入的搜索查询。
sessionSa360Source 带来会话的 SA360 来源 促成会话的 SA360 来源。搜索查询发生在此网站上。
sessionSa360SourceMedium 带来会话的 SA360 来源/媒介 促成会话的 SA360 来源媒介。来源和媒介的组合。
sessionSource 会话来源 在您的网站或应用中发起会话的来源。
sessionSourceMedium 带来会话的来源/媒介 维度 sessionSourcesessionMedium 的组合值。
sessionSourcePlatform 带来会话的来源平台 会话所属广告系列的来源平台。对于使用 UTM 的流量,请勿依赖此字段返回 Manual;在即将推出的一项功能中,此字段将从返回 Manual 更新为返回 (not set)
shippingTier 配送级别 用户为所购商品选择的配送级别。例如 GroundAirNext-day。由 shipping_tier 事件参数填充。
signedInWithUserId 是否已使用用户 ID 登录 如果用户使用 User-ID 功能登录,则为字符串 yes。如需详细了解 User-ID,请参阅使用 User-ID 跨平台衡量活动
source 来源 归因于关键事件的来源。
sourceMedium 来源/媒介 维度 sourcemedium 的组合值。
sourcePlatform 来源平台 关键事件所属广告系列的来源平台。对于使用 UTM 的流量,请勿依赖此字段返回 Manual;在即将推出的一项功能中,此字段将从返回 Manual 更新为返回 (not set)
streamId 数据流 ID 应用或网站的数字数据流标识符。
streamName 数据流名称 应用或网站的数据流名称。
testDataFilterId 测试数据的过滤器 ID 处于测试状态的数据过滤器的数字标识符。您可以使用数据过滤器根据事件参数值在报告中包含或排除事件数据。如需了解详情,请参阅数据过滤器
testDataFilterName 测试数据过滤器名称 处于测试状态的数据过滤器的名称。您可以使用数据过滤器根据事件参数值在报告中包含或排除事件数据。如需了解详情,请参阅数据过滤器
transactionId 交易 ID 电子商务交易的 ID。
unifiedPagePathScreen 网页路径和屏幕类 记录事件的网页路径(网站)或屏幕类(应用)。
unifiedPageScreen 网页路径 + 查询字符串和屏幕类 记录事件的网页路径和查询字符串(网站)或屏幕类(应用)。
unifiedScreenClass 网页标题和屏幕类 记录事件的网页标题(网站)或屏幕类(应用)。
unifiedScreenName 网页标题和屏幕名称 记录事件的网页标题(网站)或屏幕名称(应用)。
userAgeBracket 年龄 用户年龄段。
userGender 性别 用户性别。
videoProvider 视频提供方 视频的来源(例如 youtube)。如果启用了增强型衡量功能,则针对嵌入式视频自动填充数据。由事件参数 video_provider 填充。
videoTitle 视频标题 视频标题。如果启用了增强型衡量功能,则针对嵌入式视频自动填充数据。由事件参数 video_title 填充。
videoUrl 视频网址 视频的网址。如果启用了增强型衡量功能,则针对嵌入式视频自动填充数据。由事件参数 video_url 填充。
virtualCurrencyName 虚拟货币名称 用户正在与之互动的虚拟货币的名称。例如,在游戏中消耗或购买宝石。由 virtual_currency_name 事件参数填充。
visible 可见 如果内容可见,则返回 true。如果启用了增强型衡量功能,则针对嵌入式视频自动填充数据。由事件参数 visible 填充。
week 事件发生的星期(以 01 到 53 之间的两位数表示)。每周从星期日开始。1 月 1 日始终在第 1 个星期。在大多数年份中,一年中的第一个星期和最后一个星期少于 7 天。除年初和年末的星期外,其他星期始终为 7 天。对于 1 月 1 日为星期日的年份,该年的第一周和上一年的最后一周均为 7 天。
year 发生事件的四位数年份。例如 2020 或 2024。
yearMonth 年份月份 年份和月份的组合值。示例值包括 202212 或 202301。
yearWeek 年份周序号 年份和周数的组合值。示例值包括 202253 或 202301。

自定义维度

Data API 可以根据事件级范围的自定义维度和用户级范围的自定义维度创建报告。 如需详细了解自定义维度,请参阅限定于事件的自定义维度和指标报告以及自定义用户属性。在 API 报告请求中,自定义维度是通过维度的参数名称和范围指定的。例如,在 Data API 请求中添加 "customEvent:achievement_id",以便为参数名称为 "achievement_id" 的事件级范围自定义维度创建报告。如果媒体资源尚未注册此事件级范围的自定义维度,此 API 请求将失败。

如果事件级范围的自定义维度是在 2020 年 10 月之前注册的,则必须在 API 请求中指定该维度及其事件名称。例如,对于参数名称为 "achievement_id" 且事件名称为 "level_up" 的事件级范围自定义维度,请添加 "customEvent:achievement_id\[level_up\]"。2020 年 10 月,Google Analytics 已将自定义参数报告替换为限定于事件的自定义维度和指标报告

以下是自定义维度的一般语法。 您可以查询 Metadata API 方法来列出媒体资源的所有自定义维度;下面是一个使用 Metadata API 方法的示例

通用 API 名称 说明
customEvent:parameter_name 适用于 parameter_name 的事件级范围自定义维度
customEvent:parameter_name[event_name] 针对 parameter_name 的事件级范围自定义维度(如果在 2020 年 10 月之前注册)
customUser:parameter_name 适用于 parameter_name 的用户级范围的自定义维度
customItem:parameter_name 适用于 parameter_name 的商品级范围自定义维度

自定义渠道组

Data API 可以创建自定义渠道组报告。 如需详细了解自定义渠道组,请参阅 Google Analytics 中的自定义渠道组。在 API 报告请求中,自定义渠道组是通过维度的范围和渠道组 ID 指定的。例如,在 Data API 请求中添加 "sessionCustomChannelGroup:9432931",以便为 ID 为 9432931 的会话级范围的自定义渠道创建报告。如果房源没有具有此 ID 的自定义渠道,此 API 请求将失败。

以下是自定义渠道组的一般语法。 您可以查询 Metadata API 方法,以列出媒体资源的所有自定义渠道组。

通用 API 名称 说明
sessionCustomChannelGroup:custom_channel_id 促成此会话的自定义渠道。
firstUserCustomChannelGroup:custom_channel_id 首次获取此用户的自定义渠道。
customChannelGroup:custom_channel_id 促成关键事件的自定义渠道。

指标

您可以在任何媒体资源的报告中请求以下指标。 在报告响应中,为指标的列在 Metric 资源的 name 字段中指定“API 名称”。

API 名称 界面名称 说明
active1DayUsers 过去 1 天内用过的用户数 网站或应用在 1 天里的去重活跃用户数。此 1 天时段包括报告日期范围的最后一天。注意:这个数量与活跃用户数相同。
active28DayUsers 28 天活跃用户 网站或应用在 28 天内的去重活跃用户数。此 28 天时段包括报告日期范围的最后一天。
active7DayUsers 过去 7 天内用过的用户数 网站或应用在 7 天内的去重活跃用户数。此 7 天时段包括报告日期范围的最后一天。
activeUsers 活跃用户数 访问过您的网站或应用的去重用户数。
adUnitExposure 广告单元曝光时间 广告单元向用户展示的时间(以毫秒为单位)。
addToCarts 添加到购物车的次数 用户将商品添加到购物车的次数。
advertiserAdClicks 广告点击次数 用户点击广告访问媒体资源的总次数。包括来自关联的集成(例如关联的 Search Ads 360 广告客户)的点击。还包括通过数据导入上传的点击次数。
advertiserAdCost 广告费用 您为广告支付的总金额。包括来自关联的集成(例如关联的 Google Ads 账号)的费用。还包括通过数据导入上传的费用;如需了解详情,请参阅导入费用数据
advertiserAdCostPerClick 广告的每次点击费用 广告的每次点击费用是指广告费用除以广告点击次数,通常缩写为 CPC。
advertiserAdCostPerKeyEvent 每个关键事件的费用 每次关键事件的费用是广告费用除以关键事件次数。
advertiserAdImpressions Ads 展示次数 总展示次数。包括来自关联的集成(例如关联的 Display & Video 360 广告客户)的展示。还包括通过数据导入上传的展示次数。
averagePurchaseRevenue 平均购买收入 事件交易组的平均购买收入。
averagePurchaseRevenuePerPayingUser ARPPU 每位付费用户平均收入 (ARPPU) 是指有购买事件记录的每位活跃用户带来的购买总收入。摘要指标适用于所选时间段。
averagePurchaseRevenuePerUser 用户平均购买收入 每位活跃用户的平均购买收入是指记录了任何事件的每位活跃用户带来的购买总收入。摘要指标适用于所选时间段。
averageRevenuePerUser ARPU 每位活跃用户平均收入 (ARPU)。摘要指标适用于所选时间段。ARPU 使用总收入,并包含 AdMob 的估算收入。
averageSessionDuration 平均会话时长 用户会话的平均时长(以秒为单位)。
bounceRate 跳出率 非感兴趣的会话所占的百分比((总会话数减去感兴趣的会话数)除以总会话数)。此指标以小数形式返回;例如,0.2761 表示 27.61% 的会话是跳出会话。
cartToViewRate 浏览后添加到购物车的比例 将商品添加到购物车的用户数除以浏览过相同商品的用户数。此指标以小数形式返回;例如,0.1132 表示在浏览过产品的用户中,有 11.32% 的用户向购物车添加了该产品。
checkouts 结账次数 用户开始结账流程的次数。此指标用于统计 begin_checkout 事件的发生次数。
cohortActiveUsers 同类群组活跃用户数 同类群组中在同类群组的第 N 天/周/月对应的时间范围内活跃的用户数。例如,在 cohortNthWeek 为 0001 的行中,此指标表示第 1 周(同类群组中)活跃的用户数。
cohortTotalUsers 同类群组用户总数 同类群组中的用户总数。此指标在报告中每个同类群组的每一行中的值都相同。由于同类群组是根据共享的流量获取日期定义的,因此对于同类群组的选择日期范围,cohortTotalUsers 与 cohortActiveUsers 相同。对于晚于同类群组的选择范围的报告行,cohortActiveUsers 通常小于 cohortTotalUsers。此差值表示同类群组中在较晚日期未活跃的用户。cohortTotalUsers 通常用于指标表达式 cohortActiveUsers/cohortTotalUsers 中,以计算同类群组的用户留存率。activeUsers 与 totalUsers 之间的关系与 cohortActiveUsers 与 cohortTotalUsers 之间的关系并不等同。
crashAffectedUsers 受崩溃影响的用户数 在报告的此行中记录了崩溃问题的用户数。例如,如果报告按日期显示时间序列,此指标会报告在该日期至少发生过一次崩溃的用户总数。崩溃是指名称为“app_exception”的事件。
crashFreeUsersRate 未遇到崩溃问题的用户占比 没有崩溃事件的用户数(报告中此行的值)除以用户总数。此指标以小数形式返回;例如,0.9243 表示 92.43% 的用户未遇到崩溃问题。
dauPerMau 日活/月活 既是过去 30 天活跃过的用户又是过去 1 天内活跃用户的用户滚动百分比。此指标以小数形式返回;例如,0.113 表示 11.3% 的 30 天活跃用户也是 1 天活跃用户。
dauPerWau 日活/周活 既是过去 7 天活跃过的用户又是过去 1 天内活跃用户的用户滚动百分比。此指标以小数形式返回;例如,0.082 表示 8.2% 的 7 天活跃用户也是 1 天活跃用户。
ecommercePurchases 电子商务购买次数 用户完成购买的次数。此指标会统计 purchase 事件;此指标不会统计 in_app_purchase 和订阅事件。
engagedSessions 感兴趣的会话数 持续时间超过 10 秒、包含关键事件或包含至少 2 次屏幕浏览的会话数。
engagementRate 感兴趣的会话占比 感兴趣的会话数所占的百分比(感兴趣的会话数除以总会话数)。此指标以小数形式返回;例如,0.7239 表示 72.39% 的会话是感兴趣的会话。
eventCount 事件数 事件数。
eventCountPerUser 每位用户的事件数 每位用户平均触发的事件数(事件数除以活跃用户数)。
eventValue 事件价值 名为 value 的事件参数的总和。
eventsPerSession 每次会话的事件数 每次会话的平均事件数(事件数除以会话数)。
firstTimePurchaserRate 首次购买者比率 进行首次购买的活跃用户所占的百分比。此指标以小数形式返回;例如,0.092 表示 9.2% 的活跃用户是首次购买者。
firstTimePurchasers 首次购买者人数 完成首次购买事件的用户数。
firstTimePurchasersPerNewUser 新用户中的首次购买者人数所占比例 新用户中的首次购买者人数所占比例。
grossItemRevenue 商品总收入 仅商品带来的总收入。商品总收入是商品价格和数量的乘积。商品收入不含税费和运费;税费和运费是在事件级别(而非商品级别)指定的。商品总收入不包括退款。
grossPurchaseRevenue 总购买收入 用户在您的应用或网站中购买商品给您带来的收入总和。“购买总收入”会对以下事件的收入进行求和:purchaseecommerce_purchasein_app_purchaseapp_store_subscription_convertapp_store_subscription_renew。购买收入由代码植入中的 value 参数指定。
itemDiscountAmount 商品折扣金额 电子商务事件中的商品折扣的货币价值。系统会在代码植入过程中通过 discount 商品参数填充此指标。
itemListClickEvents 商品列表点击事件数 当某件商品出现在列表中时,用户点击该商品的次数。此指标用于统计 select_item 事件的发生次数。
itemListClickThroughRate 商品列表的点击率 选择列表的用户数除以浏览过相同列表的用户数。此指标以小数形式返回;例如,0.2145 表示在浏览过某个列表的用户中,有 21.45% 的用户也选择了该列表。
itemListViewEvents 商品列表查看事件数 商品列表获得的浏览次数。此指标用于统计 view_item_list 事件的发生次数。
itemPromotionClickThroughRate 商品推广活动的点击率 选择促销活动的用户数除以浏览过相同促销活动的用户数。此指标以小数形式返回;例如,0.1382 表示在浏览过促销活动的用户中,有 13.82% 的用户选择了该促销活动。
itemRefundAmount 商品退款金额 商品退款金额是指仅商品带来的退款交易收入总额。商品退款金额是 refund 事件的价格和数量的乘积。
itemRevenue 商品收入 扣除仅商品带来的退款交易收入后的购买交易总收入。商品收入是其价格和数量的乘积。商品收入不含税费和运费;税费和运费是在事件级别(而非商品级别)指定的。
itemViewEvents 商品查看事件数 商品详情获得的浏览次数。该指标会统计 view_item 事件的发生次数。
itemsAddedToCart 加入购物车的商品数 添加到购物车的单件商品的数量。此指标用于统计 add_to_cart 事件中的商品数量。
itemsCheckedOut 结账的商品数 单件商品的结账数量。此指标用于统计 begin_checkout 事件中的商品数量。
itemsClickedInList 在列表中点击过的商品数 在列表中点击过的单件商品的数量。此指标用于统计 select_item 事件中的商品数量。
itemsClickedInPromotion 推广活动中获得点击的商品数 促销活动中获得点击的单件商品的数量。此指标用于统计 select_promotion 事件中的商品数量。
itemsPurchased 已购买的商品数 purchase 事件中所含单件商品的数量。此指标用于统计 purchase 事件中的商品数量。
itemsViewed 查看过的商品数 单件商品的查看次数。此指标用于统计 view_item 事件中的商品数量。
itemsViewedInList 在列表中查看过的商品数 在列表中查看过的单件商品的数量。此指标用于统计 view_item_list 事件中的商品数量。
itemsViewedInPromotion 推广活动中获得浏览的商品数 促销活动中查看过的单件商品的数量。此指标用于统计 view_promotion 事件中的商品数量。
keyEvents 关键事件 关键事件数。将事件标记为关键事件会从创建之时起影响报告,但不会更改历史数据。您可以在 Google Analytics 中将任何事件标记为关键事件,有些事件(例如 first_openpurchase)默认情况下会被标记为关键事件。
newUsers 新用户数 首次与您的网站互动或打开您的应用的用户数量(触发的事件:first_open 或 first_visit)。
organicGoogleSearchAveragePosition Google 搜索自然平均排名 Search Console 报告的网站网址针对查询显示时的平均排名。例如,如果网站网址针对某个查询显示时排在第 3 名,而针对另一个查询显示时排在第 7 名,则其平均排名应为第 5 名,计算方法为:(3+7)/2。此指标需要有效的 Search Console 关联。
organicGoogleSearchClickThroughRate Google 搜索自然点击率 Search Console 报告的 Google 搜索自然点击率。点击率是指每次展示带来的点击次数。此指标以小数形式返回;例如,0.0588 表示约 5.88% 的展示带来了点击。此指标需要有效的 Search Console 关联。
organicGoogleSearchClicks Google 搜索自然点击次数 Search Console 报告的 Google 搜索自然点击次数。此指标需要有效的 Search Console 关联。
organicGoogleSearchImpressions Google 搜索自然展示次数 Search Console 报告的 Google 搜索自然展示次数。此指标需要有效的 Search Console 关联。
promotionClicks 推广活动点击次数 商品促销活动获得的点击次数。此指标用于统计 select_promotion 事件的发生次数。
promotionViews 推广活动浏览次数 商品促销活动获得的浏览次数。此指标用于统计 view_promotion 事件的发生次数。
publisherAdClicks 发布商广告点击次数 ad_click 事件的数量。
publisherAdImpressions 发布商广告展示次数 ad_impression 事件的数量。
purchaseRevenue 购买收入 用户在您的应用或网站中购买商品给您带来的收入总和(扣除退款交易收入)。“购买收入”摘要卡会汇总以下事件的收入:purchaseecommerce_purchasein_app_purchaseapp_store_subscription_convertapp_store_subscription_renew。购买收入由代码植入中的 value 参数指定。
purchaseToViewRate 浏览后购买的比例 购买商品的用户数除以浏览过相同商品的用户数。此指标以小数形式返回;例如,0.128 表示在浏览过产品的用户中,有 12.8% 的用户购买了该产品。
purchaserRate 购买者比率 进行过一次或多次购买交易的活跃用户所占的百分比。此指标以小数形式返回;例如,0.412 表示 41.2% 的用户是购买者。
refundAmount 退款金额 退款的交易收入总额。退款金额会汇总 refundapp_store_refund 事件的退款收入。
returnOnAdSpend 广告支出回报率 广告支出回报率 (ROAS) 的计算方式为:总收入除以广告客户的广告费用。
screenPageViews 观看次数 用户浏览的应用屏幕或网页的数量。对同一网页或屏幕的重复浏览也会计入。(screen_view 事件数 + page_view 事件数)。
screenPageViewsPerSession 每次会话的浏览次数 用户每次会话所浏览应用屏幕或网页的数量。对同一网页或屏幕的重复浏览也会计入。计算方法是:screen_view 与 page_view 事件的数量之和除以会话数。
screenPageViewsPerUser 每位用户的浏览量 每位活跃用户浏览的应用屏幕或网页的数量。对同一网页或屏幕的重复浏览也会计入。计算方法是:screen_view 与 page_view 事件的数量之和除以活跃用户数。
scrolledUsers 执行了滚动操作的用户 至少滚动到网页 90% 的唯一身份用户数。
sessionKeyEventRate 会话关键事件率 触发了任何关键事件的会话所占的百分比。
sessions 会话 您的网站或应用中发起的会话数(触发的事件:session_start)。
sessionsPerUser 每位用户的会话数 每位用户的平均会话数(会话数除以活跃用户数)。
shippingAmount 运费 与交易相关的运费。由 shipping 事件参数填充。
taxAmount 税额 与交易相关的税额。由 tax 事件参数填充。
totalAdRevenue 总广告收入 AdMob 和第三方来源的总广告收入。
totalPurchasers 总购买者人数 据记录在所选时间段内产生过购买事件的用户数。
totalRevenue 总收入 用户购买、订阅和广告给您带来的收入总和(用户购买带来的收入加订阅收入加广告收入)减去退款交易收入。
totalUsers 用户总数 至少记录了 1 项事件的去重用户数,无论相应事件记录时网站或应用是否正在使用。
transactions 交易 包含购买收入的交易事件的计数。交易事件包括 in_app_purchase、ecommerce_purchase、purchase、app_store_subscription_renew、app_store_subscription_convert 和 refund。
transactionsPerPurchaser 每位购买者的交易次数 每位购买者的平均交易次数。
userEngagementDuration 用户互动 您的网站或应用在用户设备前台运行的总时长(以秒为单位)。
userKeyEventRate 用户关键事件率 触发了任意关键事件的用户所占的百分比。
wauPerMau 周活/月活 既是过去 30 天活跃过的用户又是过去 7 天活跃过的用户的用户滚动百分比。此指标以小数形式返回;例如,0.234 表示 23.4% 的过去 30 天活跃用户也是过去 7 天活跃用户。

自定义指标

Data API 可以针对事件级范围的自定义指标创建报告。 如需详细了解自定义指标,请参阅限定于事件的自定义维度和指标报告。自定义指标是在 API 报告请求中通过指标的参数名称和范围指定的。例如,在 Data API 请求中添加 "customEvent:levels_unlocked",以便为参数名称为 "levels_unlocked" 的事件级范围自定义指标创建报告。如果媒体资源尚未注册此事件级范围的自定义指标,此 API 请求将失败。

如果您在 2020 年 10 月之前注册了限定于事件的自定义指标,则必须在 API 请求中指定该指标及其事件名称。例如,对于参数名称为 "levels_unlocked" 且事件名称为 "tutorial_start" 的事件级范围自定义指标,请添加 "customEvent:levels_unlocked\[tutorial_start\]"。2020 年 10 月,Google Analytics 已将自定义参数报告替换为限定于事件的自定义维度和指标报告

以下是自定义指标的一般语法。 您可以查询 Metadata API 方法来列出媒体资源的所有自定义指标;下面是一个使用 Metadata API 方法的示例

通用 API 名称 说明
customEvent:parameter_name 针对 parameter_name 的事件级范围自定义指标
customEvent:parameter_name[event_name] 针对 parameter_name 的事件级范围自定义指标(如果在 2020 年 10 月之前注册)

自定义指标变体

媒体资源注册的每个自定义指标都会创建三个 API 指标变体:总和、平均值和计数。大多数请求将使用自定义指标的总和。自定义指标的平均值对于摘要统计信息很有用。如果参数的出现次数对您很有用,那么自定义指标的计数会很有趣。

您可以查询 Metadata API 方法来列出媒体资源的自定义指标的所有变体;下面是一个使用 Metadata API 方法计算自定义平均值的示例

通用 API 名称 说明
customEvent:parameter_name 针对 parameter_name 的事件级范围自定义指标的总和
averageCustomEvent:parameter_name 针对 parameter_name 的事件级范围自定义指标的平均值
countCustomEvent:parameter_name 事件级范围的自定义指标“parameter_name”的出现次数

每个关键事件的关键事件率指标

您在媒体资源上注册的每个关键事件都会创建一个“关键事件率”指标,您可以在报告中请求该指标。每个关键事件都有两个速率指标:基于会话的关键事件率和基于用户的关键事件率。

您可以查询 Metadata API 方法,以列出媒体资源的所有关键事件转化率指标。如果您尝试请求未注册为关键事件的事件的关键事件率,则请求将失败。以下示例展示了如何使用 Metadata API 方法计算一种关键事件的关键事件率指标

通用 API 名称 说明
sessionKeyEventRate:event_name 触发了特定关键事件的会话所占的百分比。
userKeyEventRate:event_name 触发了特定关键事件的用户所占的百分比。