您可以在 Data API Core Reporting 查询中使用的维度和指标。
维度
您可以在任何媒体资源的报告中请求以下维度。
在 Dimension 资源的 name 字段中，为报告响应中维度的一列指定“API 名称”。
| API 名称 | 界面名称 | 说明 |
|---|---|---|
achievementId |
成就 ID | 游戏中针对某个事件的成就 ID。由事件参数 achievement_id 填充。 |
adFormat |
广告格式 | 说明广告的展示方式和展示位置。典型格式包括 Interstitial、Banner、Rewarded 和 Native advanced。 |
adSourceName |
广告来源 | 投放广告的来源网络。典型来源包括 AdMob Network、Liftoff、Facebook Audience Network 和 Mediated house ads。 |
adUnitName |
广告单元 | 您选择用来描述该广告单元的名称。广告单元是您在应用中设置的容器，用来向用户展示广告。 |
appVersion |
应用版本 | 应用的 versionName (Android) 或简短的软件包版本 (iOS)。 |
audienceId |
受众群体 ID | 受众群体的数字标识符。在报告的日期范围内，用户按其所属的受众群体进行报告。当前的用户行为不会影响报告中的既往受众群体成员资格。 |
audienceName |
受众群体名称 | 受众群体的指定名称。在报告的日期范围内，用户按其所属的受众群体进行报告。当前的用户行为不会影响报告中的既往受众群体成员资格。 |
audienceResourceName |
受众群体资源名称 | 相应受众群体的资源名称。资源名称包含集合标识符和资源标识符，用于唯一标识资源；如需了解详情，请参阅资源名称。 |
brandingInterest |
兴趣 | 购物漏斗中靠近顶部的用户表现出的兴趣。同一用户可以计入到多个兴趣类别中。例如 Shoppers、Lifestyles & Hobbies/Pet Lovers 或 Travel/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 |
Content ID | 所选内容的标识符。由事件参数 content_id 填充。 |
contentType |
内容类型 | 所选内容的类别。由事件参数 content_type 填充。 |
continent |
大洲 | 用户活动的发起地所在的大洲。例如，Americas 或 Asia。 |
continentId |
大洲 ID | 用户发起活动时所处的大洲的地理 ID，根据用户的 IP 地址得出。 |
country |
国家/地区 | 发起用户活动的国家/地区。 |
countryId |
国家/地区 ID | 用户发起活动时所处的国家/地区的地理位置 ID，根据用户的 IP 地址得出。根据 ISO 3166-1 alpha-2 标准设置格式。 |
currencyCode |
币种 | 电子商务事件的本地货币代码（基于 ISO 4217 标准）。例如 USD 或 GBP。 币种是通过标记中的 currency 参数指定的。使用多种货币进行交易的商家可以在向 Google Analytics 发送电子商务事件时指定一种本地货币代码，此维度会显示这些货币。如需了解详情，请参阅币种参考文档。 |
date |
日期 | 事件的日期，格式为 YYYYMMDD。 |
dateHour |
日期 + 时点 (YYYYMMDDhh) | 日期和小时的组合值，格式为 YYYYMMDDHH。 |
dateHourMinute |
日期、小时和分钟 | 日期、小时和分钟的组合值，格式为 YYYYMMDDHHMM。 |
day |
天 | 一个月中的某天（以 01 到 31 之间的两位数字表示）。 |
dayOfWeek |
周几 | 星期几（整数）。它返回 0 到 6 范围内的值，其中星期日是一周的第一天。 |
dayOfWeekName |
周几名称 | 英文星期几。此维度具有星期日或星期一等值。 |
defaultChannelGroup |
默认渠道组 | 关键事件的默认渠道组主要基于来源和媒介，一种枚举，包括 Direct、Organic Search、Paid Social、Organic Social、Email、Affiliates、Referral、Paid Search、Video 和 Display。 |
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 |
文件扩展名 | 已下载文件的扩展名（例如 pdf 或 txt）。如果启用了增强型衡量功能，则会自动填充数据。由事件参数 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 |
带来用户首次互动的默认渠道组 | 首次获取用户的默认渠道组。默认渠道组主要基于来源和媒介。一种枚举，包括 Direct、Organic Search、Paid Social、Organic Social、Email、Affiliates、Referral、Paid Search、Video 和 Display。 |
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 search、Search partners、Google Display Network、Youtube Search、Youtube Videos、Cross-network、Social 和 (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 |
带来用户首次互动的来源/媒介 | 维度 firstUserSource 和 firstUserMedium 的组合值。 |
firstUserSourcePlatform |
带来用户首次互动的来源平台 | 首次获取用户的来源平台。请勿依赖于此字段针对使用 UTM 的流量返回 Manual；此字段将从返回 Manual 更新为返回 (not set)，以支持即将推出的功能。 |
fullPageUrl |
完整网址 | 所访问网页的主机名、网页路径和查询字符串；例如，https://www.example.com/store/contact-us?query_string=true 的 fullPageUrl 部分为 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 search、Search partners、Google Display Network、Youtube Search、Youtube Videos、Cross-network、Social 和 (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_open 或 purchase）默认情况下会被标记为关键事件。 |
isoWeek |
ISO 周序号 | ISO 周序号，每周从星期一开始。如需了解详情，请参阅 http://en.wikipedia.org/wiki/ISO_week_date。示例值包括 01、02 和 53。 |
isoYear |
ISO 年份 | 相应事件的 ISO 年份。如需了解详情，请参阅 http://en.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 次或多次会话。此维度会返回两个值：new 或 returning。 |
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=true 的 pageLocation 部分为 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=true 中的 pagePathPlusQueryString 部分为 /store/contact-us?query_string=true。 |
pageReferrer |
网页引荐来源网址 | 包含主机名和路径的完整引荐来源网址。此引荐来源网址是用户之前所在的网址，可以是此网站的网域，也可以是其他网域。由事件参数 page_referrer 填充。 |
pageTitle |
网页标题 | 您网站上使用的网页标题。 |
percentScrolled |
已滚动百分比 | 用户向下滚动页面的百分比（例如 90）。如果启用了增强型衡量功能，系统会自动填充此参数。由事件参数 percent_scrolled 填充。 |
platform |
平台 | 指您的应用或网站在哪个平台上运行；例如 Web、iOS 或 Android。如需确定报告中的视频流类型，请同时使用平台和 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 |
带来会话的默认渠道组 | 会话的默认渠道组主要基于来源和媒介。一种枚举，包括 Direct、Organic Search、Paid Social、Organic Social、Email、Affiliates、Referral、Paid Search、Video 和 Display。 |
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 search、Search partners、Google Display Network、Youtube Search、Youtube Videos、Cross-network、Social 和 (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 ads、bing 或 baidu。 |
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 |
带来会话的来源/媒介 | 维度 sessionSource 和 sessionMedium 的组合值。 |
sessionSourcePlatform |
带来会话的来源平台 | 相应会话的广告系列的来源平台。请勿依赖于此字段针对使用 UTM 的流量返回 Manual；此字段将从返回 Manual 更新为返回 (not set)，以支持即将推出的功能。 |
shippingTier |
配送级别 | 用户为所购商品选择的配送级别。例如 Ground、Air 或 Next-day。由 shipping_tier 事件参数填充。 |
signedInWithUserId |
是否已使用用户 ID 登录 | 如果用户使用 User-ID 功能登录，则为字符串 yes。如需详细了解 User-ID，请参阅使用 User-ID 跨平台衡量活动。 |
source |
来源 | 归因于关键事件的来源。 |
sourceMedium |
来源/媒介 | 维度 source 和 medium 的组合值。 |
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 日始终在第 01 周。在大多数年份中，一年中的第一周和最后一周都少于 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 |
总购买收入 | 用户在您的应用或网站中购买商品给您带来的收入总和。总购买收入是指以下事件的收入总和：purchase、ecommerce_purchase、in_app_purchase、app_store_subscription_convert 和 app_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 事件中所含单件商品的数量。此指标用于统计购买事件中的商品数量。 |
itemsViewed |
查看过的商品数 | 单个商品的浏览次数。此指标用于统计 view_item 事件中的商品数量。 |
itemsViewedInList |
在列表中查看过的商品数 | 单个商品在列表中获得的浏览次数。此指标用于统计 view_item_list 事件中的商品数量。 |
itemsViewedInPromotion |
推广活动中获得浏览的商品数 | 单个商品在推广活动中获得的浏览次数。此指标用于统计 view_promotion 事件中的商品数量。 |
keyEvents |
关键事件 | 关键事件数。将事件标记为关键事件会从创建之时起影响报告，但不会更改历史数据。您可以在 Google Analytics 中将任何事件标记为关键事件，有些事件（例如 first_open 或 purchase）默认情况下会被标记为关键事件。 |
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 |
购买收入 | 用户在您的应用或网站中购买商品给您带来的收入总和（扣除退款交易带来的收入）。购买收入是指以下事件的收入总和：purchase、ecommerce_purchase、in_app_purchase、app_store_subscription_convert 和 app_store_subscription_renew。购买收入由代码植入中的 value 参数指定。 |
purchaseToViewRate |
浏览后购买的比例 | 购买商品的用户数除以浏览过相同商品的用户数。此指标以小数形式返回；例如，0.128 表示在浏览过产品的用户中，有 12.8% 的用户购买了该产品。 |
purchaserRate |
购买者比率 | 进行过一次或多次购买交易的活跃用户所占的百分比。此指标以小数形式返回；例如，0.412 表示 41.2% 的用户是购买者。 |
refundAmount |
退款金额 | 退款交易的总收入。退款金额是指 refund 和 app_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 |
用户总数 | 记录了至少一个事件的去重用户数，无论记录该事件时网站或应用是否正在使用。 |
transactions |
交易 | 具有购买收入的交易事件的数量。交易事件包括 in_app_purchase、ecommerce_purchase、purchase、app_store_subscription_renew、app_store_subscription_convert 和 refund。 |
transactionsPerPurchaser |
每位购买者的交易次数 | 每位购买者的平均交易次数。 |
userEngagementDuration |
用户互动 | 您的网站或应用在用户设备前台运行的总时长（以秒为单位）。 |
userKeyEventRate |
用户关键事件率 | 触发关键事件的用户所占的百分比。 |
wauPerMau |
周活/月活 | 既是过去 30 天活跃过的用户又是过去 7 天活跃过的用户的滚动百分比。此指标以小数形式返回；例如，0.234 表示在过去 30 天活跃过的用户中，有 23.4% 的用户也是过去 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 将自定义参数报告替换为限定于事件的自定义维度和指标报告。
以下是自定义指标的一般语法。 您可以查询元数据 API 方法，以列出媒体资源的所有自定义指标；以下是使用元数据 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 方法，以列出媒体资源的所有关键事件速率指标。 如果您尝试请求未注册为关键事件的事件的关键事件率，则请求会失败。以下示例展示了如何使用元数据 API 方法来获取一种关键事件的关键事件率指标。
| 通用 API 名称 | 说明 |
|---|---|
sessionKeyEventRate:event_name |
触发了特定关键事件的会话所占的百分比。 |
userKeyEventRate:event_name |
触发了特定关键事件的用户所占的百分比。 |