Google Analytics(分析)Data API 查询支持的维度和指标。
尺寸
对于任何媒体资源,您都可以在报告中请求以下维度。 在报告响应中的维度列,在“维度”的名称字段中指定“API 名称”。
API 名称 | 界面名称 | 说明 |
---|---|---|
成就 ID | 成就 ID | 游戏中针对某个活动的成就 ID。由事件参数“achievement_id”填充。 |
广告格式 | 广告格式 | 描述广告的外观及位置。常见的格式包括“插页式”、“横幅”、“激励广告”和“原生高级广告”。 |
adSourceName | 广告来源 | 投放广告的来源网络。常见的来源包括“AdMob 广告联盟”“Liftoff”“Facebook Audience Network”和“参与中介的自家广告”。 |
adUnitName | 广告单元 | 您选择用来描述该广告单元的名称。广告单元是您在应用中设置的容器,用来向用户展示广告。 |
appVersion | 应用版本 | 应用的 versionName (Android) 或简短的软件包版本 (iOS)。 |
受众群体 ID | 受众群体 ID | 受众群体的数字标识符。系统会在报表日期范围内将用户添加到其所属的受众群体中。当前的用户行为不会影响报告中的既往受众群体成员资格。 |
受众群体名称 | 受众群体名称 | 受众群体的指定名称。系统会在报表日期范围内将用户添加到其所属的受众群体中。当前的用户行为不会影响报告中的既往受众群体成员资格。 |
brandingInterest | 兴趣 | 购物漏斗中靠近顶部的用户表现出的兴趣。用户可以计入多个兴趣类别。例如,“买家”、“生活方式与爱好/宠物爱好者”或“旅游/旅游爱好者/海滩旅行者”。 |
浏览器 | Browser | 用于查看您网站的浏览器。 |
campaignId | 广告系列 ID | 营销广告系列的标识符。仅针对转化事件显示。包括 Google Ads 广告系列、人工广告系列和其他广告系列。 |
campaignName | 广告系列 | 营销广告系列的名称。仅针对转化事件显示。包括 Google Ads 广告系列、人工广告系列和其他广告系列。 |
字符 | 字符 | 游戏中针对某个事件的玩家角色。由事件参数“character”填充。 |
城市 | 城市 | 发起用户活动的城市。 |
cityId | 城市 ID | 用户发起活动时所处的城市的地理位置 ID,依据 IP 地址得出。 |
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 之间的日期,同类群组 0 将是 0001。 |
contentGroup | 内容分组 | 适用于已发布内容项的类别。由事件参数“content_group”填充。 |
contentId | Content ID | 所选内容的标识符。由事件参数“content_id”填充。 |
contentType | 内容类型 | 所选内容的类别。由事件参数“content_type”填充。 |
大洲 | 洲 | 用户发起活动时所处的大洲。例如,“美洲”或“亚洲”。 |
洲 ID | 大洲 ID | 用户发起活动时所处的大陆地理位置 ID,依据 IP 地址得出。 |
国家/地区 | 国家/地区 | 发起用户活动的国家/地区。 |
countryId | 国家/地区 ID | 用户发起活动时所处的国家/地区的地理位置 ID,依据 IP 地址得出。采用 ISO 3166-1 alpha-2 标准格式。 |
date | 日期 | 事件的日期,格式为 YYYYMMDD。 |
dateHour | 日期 + 时点 (YYYYMMDDhh) | 日期和时间的组合值,格式为 YYYYMMDDHH。 |
dateHour 分钟 | 日期和分钟 | 日期、小时和分钟的组合值,格式为 YYYYMMDDHHMM。 |
天 | 天数 | 一个月中的某天(以 01 到 31 之间的两位数字表示)。 |
dayOfWeek | 周几 | 星期几。它会返回 [0,6] 范围内的值,其中星期日是一周的第一天。 |
defaultChannelGroup | 默认渠道组 | 转化的默认渠道分组主要基于来源和媒介。一个枚举,包括“直接”“自然搜索”“付费社交媒体”“自然社交媒体”“电子邮件”“联属营销”“引荐”“付费搜索”“视频”和“展示”。 |
deviceCategory | 设备类别 | 设备类型:桌面设备、平板电脑或移动设备。 |
设备型号 | 设备型号 | 移动设备型号(例如:iPhone 10、6)。 |
eventName | 活动名称 | 事件的名称。 |
文件扩展名 | 文件扩展名 | 已下载文件的扩展名(例如“pdf”或“txt”)。如果启用增强型衡量功能,则自动填充数据。由事件参数“file_extension”填充。 |
文件名 | 文件名 | 已下载文件的网页路径(例如“/menus/dinner-menu.pdf”)。如果启用增强型衡量功能,则自动填充数据。由事件参数“file_name”填充。 |
首次会话日期 | 首次会话日期 | 用户进行首次会话的日期,格式为 YYYYMMDD。 |
firstUserCampaignId | 带来用户首次互动的广告系列 ID | 首次获取用户的营销广告系列的标识符。包括 Google Ads 广告系列、人工广告系列和其他广告系列。 |
firstUserCampaignName | 带来用户首次互动的广告系列 | 最先获取到用户的营销广告系列的名称。包括 Google Ads 广告系列、人工广告系列和其他广告系列。 |
firstUserDefaultChannelGroup | 带来用户首次互动的默认渠道组 | 最先获取用户的默认渠道分组。默认渠道分组主要基于来源和媒介。一个枚举,包括“直接”“自然搜索”“付费社交媒体”“自然社交媒体”“电子邮件”“联属营销”“引荐”“付费搜索”“视频”和“展示”。 |
firstUserGoogleAdsAccountName | 带来用户首次互动的 Google Ads 帐号名称 | 首次获取用户的 Google Ads 帐号名称。 |
firstUserGoogleAds 广告组 ID | 带来用户首次互动的 Google Ads 广告组 ID | Google Ads 中首次获取用户的广告组 ID。 |
firstUserGoogleAds 广告组名称 | 首个带来用户交互的 Google Ads 广告组名称 | 首次获取用户的 Google Ads 中的广告组名称。 |
firstUserGoogleAdsAdNetworkType 类中的方法 | 首个带来用户交互的 Google Ads 广告网络类型 | 最先获取到用户的广告网络。一个枚举,包括“Google 搜索”“搜索网络合作伙伴”“Google 展示广告网络”“YouTube 搜索”“YouTube 视频”“跨广告网络”“社交”和“(通用广告系列)”。 |
firstUserGoogleAdsCampaignId | 带来用户首次互动的 Google Ads 广告系列 ID | 首次获取用户的 Google Ads 营销广告系列的标识符。 |
firstUserGoogleAdsCampaignName | 带来用户首次互动的 Google Ads 广告系列 | 首次获取用户的 Google Ads 营销广告系列的名称。 |
firstUserGoogleAdsCampaignType | 首个带来用户交互的 Google Ads 广告系列类型 | 首次获取用户的 Google Ads 广告系列的类型。广告系列类型决定客户会在何处看到您的广告以及您可以使用 Google Ads 中的设置和选项。广告系列类型是以下枚举之一:Search、Display、Shopping、Video、Discovery、App、Smart、Hotel、Local 和效果最大化广告系列。要了解详情,请参阅 https://support.google.com/google-ads/answer/2567043。 |
firstUserGoogleAdsCreativeId | 带来用户首次互动的 Google Ads 广告素材 ID | 首次获取用户的 Google Ads 广告素材的 ID。广告素材 ID 用于标识单个广告。 |
firstUserGoogleAdsCustomerId | 带来用户首次互动的 Google Ads 客户 ID | Google Ads 中首次获取用户的客户 ID。Google Ads 中的客户 ID 是 Google Ads 帐号的唯一标识符。 |
firstUserGoogleAdsKeyword | 带来用户首次互动的 Google Ads 关键字文字 | 最先获取到用户的匹配关键字。关键字是对您的产品或服务起到描述作用的字词或词组,通过选择关键字,您可以向合适的客户展示您的广告。如需详细了解关键字,请参阅 https://support.google.com/google-ads/answer/6323。 |
firstUserGoogleAdsQuery 类的构造函数 | 带来用户首次互动的 Google Ads 查询 | 首次获取用户的搜索查询。 |
firstUserManualAdContent | 带来用户首次互动的人工广告内容 | 最先获取到用户的广告内容。由 utm_content 参数填充。 |
firstUserManualTerm | 带来用户首次互动的人工字词 | 首次获取用户的字词。由 utm_term 参数填充。 |
firstUserMedium | 带来用户首次互动的媒介 | 首次获取您的网站或应用的用户的媒介。 |
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 | 归因于转化事件的广告组 ID。 |
googleAdsAdGroupName | Google Ads 广告组名称 | 归因于转化事件的广告组名称。 |
googleAdsAdNetworkType | Google Ads 广告网络类型 | 转化所属的广告网络类型。一个枚举,包括“Google 搜索”“搜索网络合作伙伴”“Google 展示广告网络”“YouTube 搜索”“YouTube 视频”“跨广告网络”“社交”和“(通用广告系列)”。 |
googleAdsCampaignId | Google Ads 广告系列 ID | 归因于转化事件的 Google Ads 广告系列 ID。 |
googleAdsCampaignName | Google Ads 广告系列 | 归因于转化事件的 Google Ads 广告系列的广告系列名称。 |
googleAdsCampaignType | Google Ads 广告系列类型 | 归因于转化事件的 Google Ads 广告系列的类型。广告系列类型决定客户会在何处看到您的广告以及您可以使用 Google Ads 中的设置和选项。广告系列类型是以下枚举之一:Search、Display、Shopping、Video、Discovery、App、Smart、Hotel、Local 和效果最大化广告系列。要了解详情,请参阅 https://support.google.com/google-ads/answer/2567043。 |
googleAdsCreativeId | Google Ads 广告素材 ID | 归因于转化事件的 Google Ads 广告素材的 ID。广告素材 ID 用于标识单个广告。 |
googleAdsCustomerId | Google Ads 客户 ID | Google Ads 中促成转化事件的广告系列的客户 ID。Google Ads 中的客户 ID 是 Google Ads 帐号的唯一标识符。 |
Google Ads 关键字 | Google Ads 关键字文字 | 促成转化事件的匹配关键字。关键字是对您的产品或服务起到描述作用的字词或词组,通过选择关键字,您可以向合适的客户展示您的广告。如需详细了解关键字,请参阅 https://support.google.com/google-ads/answer/6323。 |
googleAdsQuery | Google Ads 查询 | 促成转化事件的搜索查询。 |
groupId | 群组 ID | 游戏中针对某个事件的玩家群组 ID。由事件参数“group_id”填充。 |
hostName | 主机名 | 包括网址的子域名和域名,例如,www.example.com/contact.html 的主机名是 www.example.com。 |
小时 | 小时 | 当天记录事件的时间(两位数)。此维度的范围为 0-23,按您媒体资源的时区进行报告。 |
isConversionEvent | 是转化事件 | 如果事件为转化,值为“true”字符串。事件在收集时被标记为转化;日后对事件转化标记的更改会生效。您可以在 Google Analytics(分析)中将任何事件标记为转化,有些事件(即 first_open、purchase)默认标记为转化。有关详情,请参阅 https://support.google.com/analytics/answer/9267568。 |
itemAaffiliation | 商品联属营销企业 | 与单件商品关联的联属营销企业(合作伙伴/供应商;如果有)的名称或代码。由“affiliation”项参数填充。 |
itemBrand | 商品品牌 | 商品的品牌名称。 |
itemCategory | 商品类别 | 商品所属的层次结构类别。例如,在“服饰/男装/夏装/衬衫/T 恤”中,“服饰”为商品类别。 |
商品类别 2 | 商品类别 2 | 商品所属的层次结构类别。例如,在“服饰/男装/夏装/衬衫/T 恤”中,“男装”为商品类别 2。 |
商品类别 3 | 商品类别 3 | 商品所属的层次结构类别。例如,在“服饰/男装/夏装/衬衫/T 恤”中,“夏装”为商品类别 3。 |
商品类别 4 | 商品类别 4 | 商品所属的层次结构类别。例如,在“服饰/男装/夏装/衬衫/T 恤”中,“衬衫”为商品类别 4。 |
商品类别 5 | 商品类别 5 | 商品所属的层次结构类别。例如,在“服饰/男装/夏装/衬衫/T 恤”中,“T 恤”为商品类别 5。 |
itemId | 商品 ID | 商品的 ID。 |
itemListId | 商品列表 ID | 商品列表的 ID。 |
itemListName | 商品列表名称 | 商品列表的名称。 |
itemName | 商品名称 | 商品的名称。 |
itemPromotionCreativeName | 商品促销活动的广告素材名称 | 商品促销活动所用广告素材的名称。 |
itemPromotionId | 商品促销活动的 ID | 商品促销活动的 ID。 |
itemPromotionName | 商品促销活动的名称 | 商品促销活动的名称。 |
itemVariant [商品款式/规格] | 商品款式 | 商品的特定款式/规格,例如XS、S、M、L 等尺码;或红色、蓝色、绿色、黑色等颜色。由“item_variant”参数填充。 |
landingPage | 着陆页 + 查询字符串 | 与会话中的首次网页浏览相关联的网页路径 + 查询字符串。 |
language | 语言 | 用户的浏览器或设备的语言设置。例如,英语 |
languageCode | 语言代码 | 用户浏览器或设备的语言设置 (ISO 639)。例如“en-us” |
level | 等级 | 玩家在游戏中的等级。由事件参数“level”填充。 |
linkClass | 链接类 | 出站链接的 HTML 类属性。例如,如果用户点击链接“”,则此维度会返回“center”。如果启用增强型衡量功能,则自动填充数据。由事件参数“link_classes”填充。 |
链接域名 | 链接域名 | 出站链接的目标网域。例如,如果用户点击链接“”,此维度会返回“youtube.com”。如果启用增强型衡量功能,则自动填充数据。由事件参数“link_domain”填充。 |
关联 ID | 关联 ID | 出站链接或文件下载的 HTML ID 属性。例如,如果用户点击链接“”,则此维度会返回“socialLinks”。如果启用增强型衡量功能,则自动填充数据。由事件参数“link_id”填充。 |
linkText | 链接文字 | 文件下载的链接文字。如果启用增强型衡量功能,则自动填充数据。由事件参数“link_text”填充。 |
linkUrl | 链接网址 | 出站链接或文件下载的完整网址。例如,如果用户点击链接“”,此维度会返回“https://www.youtube.com/results?search_query=analytics”。如果启用增强型衡量功能,则自动填充数据。由事件参数“link_url”填充。 |
手动广告内容 | 人工广告内容 | 归因于转化事件的广告内容。由 utm_content 参数填充。 |
人工期限 | 人工字词 | 归因于转化事件的字词。由 utm_term 参数填充。 |
媒介 | 中 | 归因于转化事件的媒介。 |
method | 方法 | 触发事件的方式。由事件参数“method”填充。 |
分钟 | 分 | 表示事件记录的那小时的两位数分钟数。该维度的范围为 0-59,并以您媒体资源的时区进行报告。 |
mobileDeviceBranding | 设备品牌 | 制造商或品牌名称(例如 Samsung、HTC、Verizon、T-Mobile)。 |
mobileDeviceMarketingName | 设备 | 品牌的设备名称(例如:Galaxy S10 或 P30 Pro)。 |
mobileDeviceModel | 移动设备型号 | 移动设备型号名称(例如:iPhone X 或 SM-G950F)。 |
月 | 月份 | 事件的月份(以 01 到 12 之间的两位数字表示)。 |
回头客 | 新用户/回访用户 | 新用户有 0 次先前的会话,回访用户有 1 次或多次之前的会话。此维度会返回两个值:“全新”或“退货”。 |
nthDay | 第 N 天 | 自日期范围的起始日期起经过的天数。 |
nthHour | 第 N 个小时 | 自日期范围的起始日期起经过的小时数。起始小时为 0000。 |
第 n 分钟 | 第 N 分钟 | 自日期范围的起始日期起经过的分钟数。起始分钟为 0000。 |
nthMonth | 第 N 个月 | 自日期范围的起始日期起所经过的月数。起始月份为 0000。 |
nthWeek | 第 N 周 | 此数字表示自日期范围的起始日期起所经过的周数。 |
第 N 年 | 第 N 年 | 自日期范围的起始日期起经过的年数。起始年份为 0000。 |
operatingSystem | 操作系统 | 应用或网站的访问者使用的操作系统,包括桌面和移动操作系统,如 Windows 和 Android。 |
operatingSystemVersion | 操作系统版本 | 您的网站或应用的访问者使用的操作系统版本。例如,Android 10 的版本为 10,iOS 13.5.1 的版本为 13.5.1。 |
operatingSystemWithVersion | 操作系统及版本 | 操作系统和版本。例如,Android 10 或 Windows 7。 |
orderCoupon | 订单优惠券 | 订单级优惠券的代码。 |
出境 | 外发 | 如果指向网站的链接不属于该媒体资源的网域,则返回“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 | 网页标题 | 您网站上使用的网页标题。 |
已滚动的百分比 | 已滚动百分比 | 用户向下滚动页面的百分比(例如“90”)。如果启用增强型衡量功能,则自动填充数据。由事件参数“percent_scrolled”填充。 |
平台 | 平台 | 您的应用或网站在哪个平台上运行;例如 Web、iOS 或 Android。要确定视频流的类型,请同时使用平台和视频流 ID。 |
平台设备类别 | 平台类别/设备类别 | 您的网站或移动应用在哪个平台上运行的设备。(示例:Android / 移动设备) |
区域 | 区域 | 用户发起活动时所处的地理区域,根据用户的 IP 地址得出。 |
screenResolution | 屏幕分辨率 | 用户显示器的屏幕分辨率。例如 1920x1080。 |
searchTerm | 搜索字词 | 用户搜索的字词。例如,如果用户访问“/some-page.html?q=some-term”,此维度会返回“some-term”。如果启用增强型衡量功能,则自动填充数据。由事件参数“search_term”填充。 |
sessionCampaignId | 带来会话的广告系列 ID | 会话的营销广告系列 ID。包括 Google Ads 广告系列、人工广告系列和其他广告系列。 |
sessionCampaignName | 会话广告系列 | 会话的营销广告系列名称。包括 Google Ads 广告系列、人工广告系列和其他广告系列。 |
sessionDefaultChannelGroup | 带来会话的默认渠道组 | 会话的默认渠道分组主要基于来源和媒介。一个枚举,包括“直接”“自然搜索”“付费社交媒体”“自然社交媒体”“电子邮件”“联属营销”“引荐”“付费搜索”“视频”和“展示”。 |
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 搜索”“搜索网络合作伙伴”“Google 展示广告网络”“YouTube 搜索”“YouTube 视频”“跨广告网络”“社交”和“(通用广告系列)”。 |
sessionGoogleAdsCampaignId | 带来会话的 Google Ads 广告系列 ID | 促成此会话的 Google Ads 广告系列 ID。 |
sessionGoogleAdsCampaignName | 带来会话的 Google Ads 广告系列 | 促成此会话的 Google Ads 广告系列的名称。 |
sessionGoogleAdsCampaignType | 带来会话的 Google Ads 广告系列类型 | 促成此会话的 Google Ads 广告系列的类型。广告系列类型决定客户会在何处看到您的广告以及您可以使用 Google Ads 中的设置和选项。广告系列类型是以下枚举之一:Search、Display、Shopping、Video、Discovery、App、Smart、Hotel、Local 和效果最大化广告系列。要了解详情,请参阅 https://support.google.com/google-ads/answer/2567043。 |
sessionGoogleAdsCreativeId | 会话 Google Ads 广告素材 ID | 带来网站或应用上会话的 Google Ads 广告素材的 ID。广告素材 ID 用于标识各个广告。 |
sessionGoogleAdsCustomerId | 带来会话的 Google Ads 客户 ID | 促成此次会话的 Google Ads 客户 ID。Google Ads 中的客户 ID 是 Google Ads 帐号的唯一标识符。 |
sessionGoogleAdsKeyword | 会话的 Google Ads 关键字文字 | 促成会话的匹配关键字。关键字是对您的产品或服务起到描述作用的字词或词组,通过选择关键字,您可以向合适的客户展示您的广告。如需详细了解关键字,请参阅 https://support.google.com/google-ads/answer/6323。 |
sessionGoogleAdsQuery | 会话的 Google Ads 查询 | 促成会话的搜索查询。 |
sessionManualAdContent | 带来会话的人工广告内容 | 促成会话的广告内容。由 utm_content 参数填充。 |
sessionManualTerm | 带来会话的人工字词 | 促成会话的字词。由 utm_term 参数填充。 |
sessionMedium | 会话媒介 | 在您的网站或应用中发起会话的媒介。 |
sessionSa360 广告组名称 | 带来会话的 SA360 广告组名称 | 促成此会话的 Search Ads 360 广告组名称。 |
sessionSa360CampaignId | 带来会话的 SA360 广告系列 ID | 促成此会话的 Search Ads 360 广告系列 ID。 |
sessionSa360CampaignName | 带来会话的 SA360 广告系列 | 促成此会话的 Search Ads 360 广告系列名称。 |
sessionSa360CreativeFormat | 带来会话的 SA360 广告素材格式 | 在 Search Ads 360 中促成此会话的广告素材类型。例如,“自适应搜索广告”或“加大型文字广告”。如需了解详情,请参阅 GA4 流量来源维度。 |
sessionSa360EngineAccountId | 带来会话的 SA360 引擎帐号 ID | 促成此会话的 SA360 引擎帐号 ID。 |
sessionSa360EngineAccountName | 带来会话的 SA360 引擎帐号名称 | 促成此会话的 SA360 中的引擎帐号名称。 |
sessionSa360EngineAccountType | 带来会话的 SA360 引擎帐号类型 | 在 Search Ads 360 中促成此会话的引擎帐号类型。例如,“google ads”、“bing”或“baidu”。 |
sessionSa360 关键字 | 带来会话的 SA360 关键字文字 | 在 Search Ads 360 中促成此会话的搜索引擎关键字。 |
sessionSa360 媒介 | 带来会话的 SA360 媒介 | 在 Search Ads 360 中促成此会话的搜索引擎关键字。例如,“cpc”。 |
sessionSa360 查询 | 带来会话的 SA360 查询 | 促成此会话的 Search Ads 360 搜索查询。 |
sessionSa360Source | 带来会话的 SA360 来源 | 促成此会话的 Search Ads 360 流量来源。例如,“example.com”或“google”。 |
sessionSource | 会话来源 | 在您的网站或应用中发起会话的来源。 |
sessionSourceMedium | 会话来源/媒介 | 维度“sessionSource”和“sessionMedium”的组合值。 |
sessionSourcePlatform | 会话来源平台 | 会话广告系列的来源平台。对于使用 UTM 的流量,请勿依赖返回“Manual”的字段;对于即将发布的功能,此字段将从返回“Manual”更新为返回“(not set)”。 |
shippingTier(运费层级) | 配送级别 | 为交付已购商品而选择的配送级别(例如陆运、空运、次日达)。由“shipping_tier”事件参数填充。 |
登录用户 ID | 是否已使用用户 ID 登录 | 如果用户使用 User-ID 功能登录,会显示字符串“yes”。要详细了解 User-ID,请参阅 https://support.google.com/analytics/answer/9213390。 |
源颜色 | 来源 | 归因于转化事件的来源。 |
来源媒介 | 来源/媒介 | 维度“来源”和“媒介”的组合值。 |
sourcePlatform | 源平台 | 转化事件的广告系列的来源平台。对于使用 UTM 的流量,请勿依赖返回“Manual”的字段;对于即将发布的功能,此字段将从返回“Manual”更新为返回“(not set)”。 |
视频流 ID | 数据流 ID | 应用或网站的数字数据流标识符。 |
视频流名称 | 数据流名称 | 应用或网站的数据流名称。 |
testDataFilterId | 测试数据的过滤器 ID | 处于测试状态的数据过滤器的数字标识符。您可以使用数据过滤器根据事件参数值在报告中包含或排除事件数据。有关详情,请参阅 https://support.google.com/analytics/answer/10108813。 |
testDataFilterName | 测试数据过滤器名称 | 处于测试状态的数据过滤器的名称。您可以使用数据过滤器根据事件参数值在报告中包含或排除事件数据。有关详情,请参阅 https://support.google.com/analytics/answer/10108813。 |
transactionId | 交易 ID | 电子商务交易的 ID。 |
统一网页路径屏幕 | 网页路径和屏幕类别 | 记录事件的网页路径(网站)或屏幕类(应用)。 |
统一页面屏幕 | 网页路径 + 查询字符串和屏幕类 | 记录事件的网页路径和查询字符串(网站)或屏幕类(应用)。 |
统一屏幕类 | 网页标题和屏幕类 | 记录事件的网页标题(网页)或屏幕类(应用)。 |
unifiedScreenName | 网页标题和屏幕名称 | 记录事件的网页标题(网页)或屏幕名称(应用)。 |
userAgeBracket | 年龄 | 用户年龄段。 |
userGender | 性别 | 用户性别。 |
videoProvider | 视频提供方 | 视频的来源(例如“youtube”)。如果启用了增强型衡量功能,系统会针对嵌入式视频自动填充数据。由事件参数“video_provider”填充。 |
videoTitle | 视频标题 | 视频标题。如果启用了增强型衡量功能,系统会针对嵌入式视频自动填充数据。由事件参数“video_title”填充。 |
视频网址 | 视频网址 | 视频的网址。如果启用了增强型衡量功能,系统会针对嵌入式视频自动填充数据。由事件参数“video_url”填充。 |
virtualCurrencyName | 虚拟货币名称 | 用户与之互动的虚拟货币名称。例如,在游戏中消费或购买宝石。由“virtual_currency_name”事件参数填充。 |
visible | 可见 | 如果内容可见,则返回“true”。如果启用了增强型衡量功能,系统会针对嵌入式视频自动填充数据。由事件参数“visible”填充。 |
周 | 周 | 发生事件的星期(以 01 到 53 之间的两位数字表示)。每周从星期日开始。1 月 1 日始终在第 1 周。一年中的第一周和最后一周大多数时候少于 7 天。除了一年的第一周和最后一周,每周都有 7 天。对于 1 月 1 日是星期日的年份,该年的第一周以及上一年的最后一周有 7 天。 |
年 | 年份 | 发生事件的四位数年份,例如 2020。 |
自定义维度
Data API 可以创建事件级范围和用户级范围的自定义维度报告。如需详细了解自定义维度,请参阅事件级范围的自定义维度和指标报告和自定义用户属性。自定义维度在 API 报告请求中按维度的参数名称和范围指定。 例如,您可以在数据 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:param_name(自定义事件:参数名称) | 参数名称的事件级范围的自定义维度 |
customEvent:param_name[事件名称] | 2020 年 10 月之前注册的参数为事件级范围的自定义维度 |
customUser:参数名称 | “<参数名称>”的用户级自定义维度 |
指标
您可以针对任何媒体资源在报告中请求以下指标。在报告响应中的指标列的指标名称字段中指定“API 名称”。
API 名称 | 界面名称 | 说明 |
---|---|---|
active1DayUsers | 过去 1 天内用过的用户数 | 网站或应用在 1 天内的唯一身份活跃用户数。该 1 天时段包括报告日期范围内的最后 1 天。注意:与“活跃用户数”相同。 |
active28DayUsers | 28 天活跃用户 | 网站或应用在 28 天内的唯一身份活跃用户数。此 28 天时段包括报告日期范围内的最后一天。 |
active7DayUsers | 过去 7 天内用过的用户数 | 网站或应用在 7 天内的唯一身份活跃用户数。此 7 天时段包括报告日期范围内的最后 1 天。 |
活跃用户 | 活跃用户数 | 访问过您的网站或应用的去重用户数。 |
adUnitExposure | 广告单元曝光时间 | 广告单元向用户展示的时间(以毫秒为单位)。 |
addToCarts | 添加到购物车的次数 | 用户将商品添加到购物车的次数。 |
广告客户的广告点击次数 | Ads 点击次数 | 用户点击广告进入媒体资源的总次数。包括来自关联的集成(如关联的 Search Ads 360 广告客户)的点击。还包括因数据导入而产生的点击。 |
广告客户费用 | 广告费用 | 您为广告支付的总金额。包括关联的集成(例如关联的 Google Ads 帐号)的费用。还包括通过数据导入上传的费用;如需了解详情,请参阅导入费用数据。 |
广告客户广告每点击费用 | 广告的每次点击费用 | 每次点击费用是广告费用除以广告点击次数,通常简称为每次点击费用。 |
广告客户广告每转化费用 | 每次转化费用 | 每次转化费用是广告费用除以转化次数所得的值。 |
广告客户广告展示次数 | Ads 展示次数 | 总展示次数。包括来自关联的集成(例如关联的 Display & amp; Video 360 广告客户)的展示次数。还包括因数据导入而上传的展示。 |
平均购买收入 | 平均购买收入 | 事件交易组的平均购买收入。 |
AveragePurchaseRevenuePerPayingUser | ARPPU | 每位付费用户平均收入 (ARPPU) 是指记录了购买事件的每位活跃用户带来的购买总收入。摘要指标适用于所选时间段。 |
每位用户的平均购买收入 | 用户平均购买收入 | 每位活跃用户带来的平均购买收入是指每位活跃用户在记录任何事件时的购买总收入。摘要指标适用于所选时间段。 |
每用户平均收入 | ARPU | 每位活跃用户平均收入 (ARPU)。摘要指标适用于所选时间段。ARPU 使用总收入并包含 AdMob 估算收入。 |
平均会话时长 | 平均会话时长 | 用户会话的平均时长(以秒为单位)。 |
跳出率 | 跳出率 | 非感兴趣的会话数所占的百分比(会话数减去感兴趣的会话数)。此指标以小数形式返回;例如,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 之间的关系。 |
转化 | 转化情况 | 转化事件的数量。事件在收集时被标记为转化;日后对事件转化标记的更改会生效。您可以在 Google Analytics(分析)中将任何事件标记为转化,有些事件(即 first_open、purchase)默认标记为转化。有关详情,请参阅 https://support.google.com/analytics/answer/9267568。 |
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”和订阅事件。 |
感兴趣的会话数 | 感兴趣的会话数 | 持续时间超过 10 秒、发生了转化事件或者屏幕浏览量不低于 2 次的会话数。 |
互动率 | 感兴趣的会话占比 | 感兴趣的会话数所占的百分比(感兴趣的会话数除以会话数)。此指标以小数形式返回;例如,0.7239 表示 72.39% 的会话是感兴趣的会话。 |
eventCount | 事件数 | 事件数。 |
eventCountPerUser | 每位用户的事件数 | 每位用户的平均事件数(事件数除以活跃用户数)。 |
eventValue | 事件价值 | 名为“value”的事件参数的总和。 |
eventsPerSession | 每次会话的事件数 | 每次会话的平均事件数(事件数除以会话数)。 |
firstTimePurchaserConversionRate | 首次购买者转化率 | 进行首次购买的活跃用户所占的百分比。此指标以小数形式返回;例如,0.092 表示 9.2% 的活跃用户是首次购买者。 |
firstTimePurchasers | 首次购买者人数 | 完成首次购买事件的用户数。 |
firstTimePurchasersPerNewUser | 新用户中的首次购买者人数所占比例 | 新用户首次购买的平均次数。 |
itemListClickEvents | 商品列表点击事件数 | 当某件商品出现在列表中时,用户点击该商品的次数。此指标统计“select_item”事件的发生次数。 |
itemListClickThroughRate | 商品列表的点击率 | 选择列表的用户数除以浏览过相同列表的用户数。此指标以小数形式返回;例如,0.2145 表示查看列表的用户中,21.45% 还选择了相同的列表。 |
itemListViewEvents | 商品列表浏览事件数 | 商品列表获得的浏览次数。此指标统计“view_item_list”事件的发生次数。 |
itemPromotionClickThroughRate | 商品促销活动的点击率 | 选择促销活动的用户数除以浏览过相同促销活动的用户数。此指标以小数形式返回;例如,0.1382 表示查看过促销活动的用户中有 13.82% 也选择了该促销活动。 |
itemRevenue | 商品收入 | 仅商品带来的总收入。商品收入是指其价格和数量的乘积。商品收入不包含税费和运费值;税费和运费值在事件中指定,而不是在商品级别指定。 |
itemViewEvents | 商品浏览事件数 | 商品详情获得的浏览次数。该指标用于统计“view_item”事件的发生次数。 |
已添加到购物车 | 加入购物车的商品数 | 单件商品加入购物车的数量。此指标统计“add_to_cart”事件中的商品数量。 |
itemsCheckedOut | 结账的商品数 | 为单件商品结账的数量。该指标会统计 'begin_checkout' 事件中的商品数量。 |
itemsClickedInList 中的字段 | 在列表中点击过的商品数 | 列表中单个商品的点击数量。此指标统计 'select_item' 事件中的商品数量。 |
itemsClickedIn 促销活动 | 在促销活动中点击过的商品数 | 单件商品的促销活动所获得的点击次数。此指标统计“select_promotion”事件中的商品数量。 |
所购商品 | 已购买的商品数 | 购买事件中所含单件商品的数量。该指标用于统计购买事件中的商品数量。 |
已查看商品 | 查看过的商品数 | 查看的单件商品的数量。此指标统计“view_item”事件中的商品数量。 |
itemsViewedInList 中的字段 | 在列表中查看过的商品数 | 在列表中查看的单个商品的数量。此指标统计“view_item_list”事件中的商品数量。 |
itemsViewedIn 促销活动 | 在促销活动中查看过的商品数 | 促销活动中查看的一件商品的数量。此指标统计“view_promotion”事件中的商品数量。 |
newUsers | 新用户数 | 首次与您的网站互动或打开您的应用的用户数(触发的事件:first_open 或 first_visit)。 |
Google 搜索平均排名 | 自然 Google 搜索平均排名 | 您的网站网址在 Search Console 中报告的相应查询的平均排名。例如,如果网站网址针对某个查询显示时的排名是第 3 位,而针对另一个查询的显示排名是第 7 位,则其平均排名将为第 5 名 (3+7/2)。此指标需要有效的 Search Console 关联。 |
Google 搜索点击率 | 自然 Google 搜索点击率 | Search Console 报告的自然 Google 搜索点击率。点击率是指每次展示的点击次数。此指标以小数形式返回;例如,0.0588 表示约 5.88% 的展示促成了点击。此指标需要有效的 Search Console 关联。 |
自然 Google 搜索点击 | 自然 Google 搜索点击次数 | Search Console 报告的自然 Google 搜索点击次数。此指标需要有效的 Search Console 关联。 |
自然 Google 搜索展示次数 | 自然 Google 搜索展示次数 | 通过 Search Console 报告的自然 Google 搜索展示次数。此指标需要有效的 Search Console 关联。 |
promotionClicks | 促销信息点击次数 | 商品促销活动获得的点击次数。此指标统计“select_promotion”事件的发生次数。 |
promotionViews [促销观看次数] | 促销信息浏览次数 | 商品促销活动获得的浏览次数。此指标统计“view_promotion”事件的发生次数。 |
publisherAdClicks | 发布商广告点击次数 | ad_click 事件的数量。 |
publisherAdImpressions | 发布商广告展示次数 | ad_impression 事件数量。 |
purchase 收入 | 购买收入 | 用户在您的应用或网站中购买商品给您带来的收入总和。购买收入是以下事件带来的收入之和:“purchase”、“ecommerce_purchase”、“in_app_purchase”、“app_store_subscription_convert”和“app_store_subscription_renew”。购买收入由代码中的“value”参数指定。 |
purchaseToViewRate | 浏览后购买的比例 | 购买过产品的用户数除以浏览过相同产品的用户数。此指标以小数形式返回;例如,0.128 表示查看过商品的用户中有 12.8% 还购买了相同的商品。 |
purchaserConversionRate | 购买者转化率 | 完成一次或多次购买交易的活跃用户所占的百分比。此指标以小数形式返回;例如,0.412 表示 41.2% 的用户为购买者。 |
returnOnAdSpend | 广告支出回报率增幅 | 广告支出回报率的计算方法是:用总收入除以广告客户广告费用。 |
screenPageViews | View | 用户查看的应用屏幕或网页的数量。对同一网页或屏幕的重复浏览也会计入。(screen_view + page_view 事件)。 |
screenPageViewsPerSession | 每次会话的浏览次数 | 用户每次会话所浏览应用屏幕或网页的数量。对同一网页或屏幕的重复浏览也会计入。计算方法是:screen_view 与 page_view 事件的数量之和除以会话数。 |
screenPageViewsPerUser | 每位用户的浏览量 | 用户查看的每个应用屏幕或网页的数量。对同一网页或屏幕的重复浏览也会计入。(screen_view + page_view 事件)/活跃用户数。 |
scrolledUsers | 已滚动的用户 | 向下滚动页面至少 90% 的唯一身份用户的数量。 |
sessionConversionRate(会话转化率) | 会话转化率 | 触发了任何转化事件的会话所占的百分比。 |
sessions | 会话 | 您的网站或应用中发起的会话数(触发的事件:session_start)。 |
sessionsPerUser | 每位用户的会话数 | 每位用户的平均会话数(会话数除以活跃用户数)。 |
shippingAmount [运费] | 运费 | 与交易相关的运费。由“shipping”事件参数填充。 |
taxAmount | 税额 | 与交易相关的税额。由“tax”事件参数填充。 |
总广告收入 | 总广告收入 | 来自 AdMob 和第三方来源的广告收入总额。 |
总购买者人数 | 总购买者人数 | 所选时间段内记录了购买事件的用户数。 |
总收入 | 总收入 | 购买、订阅和广告带来的收入总和(购买收入加订阅收入加广告收入)。 |
totalUsers | 用户总数 | 至少记录一个事件的不同用户数,无论该事件在记录时是否正在使用。 |
交易 | 事务 | 包含购买收入的交易事件数。交易事件包括 in_app_purchase、ecommerce_purchase、purchase、app_store_subscription_renew、app_store_subscription_convert 和退款。 |
transactionPerPurchaser | 每位购买者的交易次数 | 每位购买者的平均交易次数。 |
用户转化率 | 用户转化率 | 表示有多大比例的用户触发了任意转化事件。 |
userEngagementDuration | 用户互动 | 您的网站或应用在用户设备前台运行的总时长(以秒为单位)。 |
WauPerMau | 周活/月活 | 既是过去 30 天活跃过的用户又是过去 7 天内活跃用户的用户所占的百分比。此指标以小数形式返回;例如,0.234 表示 33 天活跃用户中有 23.4% 也是 7 天活跃用户。 |
自定义指标
Data API 可以创建有关事件级范围的自定义指标的报告。如需详细了解自定义指标,请参阅事件级范围的自定义维度和指标报告。自定义指标由指标的参数名称和范围在 API 报告请求中指定。例如,您可以在数据 API 请求中包含“customEvent:levels_unlocked”,从而为事件级范围的自定义指标(参数名称为“levels_unlocked”)创建报告。 如果媒体资源尚未注册此事件级范围的自定义指标,则此 API 请求将失败。
如果事件级范围的自定义指标是在 2020 年 10 月之前注册的,则该 API 必须通过其事件名称指定。例如,为参数范围为“levels_unlocked”和事件名称“tutorials_start”的事件范围自定义指标添加“customEvent:levels_unlocked[tutorials_start]”。2020 年 10 月,Google Analytics(分析)用事件级范围的自定义维度和指标报告取代了自定义参数报告。
以下是自定义指标的常规语法。 您可以查询 Metadata API 方法以列出媒体资源的所有自定义指标;以下是使用 Metadata API 方法的示例。
通用 API 名称 | 说明 |
---|---|
customEvent:param_name(自定义事件:参数名称) | 参数 name_name 的事件级范围的自定义指标 |
customEvent:param_name[event_name ] | 2020 年 10 月之前注册的参数为事件级范围的自定义指标 |
自定义指标变体
媒体资源注册的每个自定义指标都会创建三个 API 指标变体:总和、平均值和计数。大多数请求将使用自定义指标的总和。 自定义指标的平均值对于摘要统计信息很有用。如果参数的出现次数对您有用,那么自定义指标的计数就很有趣。
您可以查询 Metadata API 方法,以列出媒体资源的所有自定义指标变体;以下是将 Metadata API 方法用于自定义平均值的示例。
通用 API 名称 | 说明 |
---|---|
customEvent:param_name(自定义事件:参数名称) | 参数 name_name 的事件级范围的自定义指标的总和 |
AverageCustomEvent:参数名称 | 参数_name 的事件级范围自定义指标的平均值 |
countCustomEvent:param_name | 参数_name 的事件级范围的自定义指标出现的次数 |
一种转化的转化率指标
您在媒体资源中注册的每个转化事件都会创建您可以在报表中请求的“转化率”指标。每次转化有两种转化率指标:一种是基于转化的转化率,另一种是基于用户的转化率。
您可以查询 Metadata API 方法,以列出媒体资源的一项特定转化的所有转化率指标。如果您尝试针对未注册为转化的事件请求转化率,请求将会失败。此处:使用 Metadata API 方法为一次转化的转化率指标。
通用 API 名称 | 说明 |
---|---|
sessionConversionRate:event_name 敬上 | 触发了特定转化事件的会话所占的百分比。 |
userConversionRate:event_name 敬上 | 触发了特定转化事件的用户所占的百分比。 |