API 维度和指标

Google Analytics Data API 漏斗报告支持这些维度和指标。

维度

对于任何媒体资源,都可以在漏斗报告中请求以下维度。 指定“API 名称”(位于 Dimension 资源的 name 字段。

API 名称 界面名称 在细分中可用 说明
achievementId 成就 ID 游戏中针对某个活动的成就 ID。由事件参数 achievement_id 填充。
adFormat 广告格式 描述广告的外观和位置。典型的格式包括 InterstitialBannerRewardedNative advanced
adSourceName 广告来源 投放广告的来源网络。典型来源包括 AdMob NetworkLiftoffFacebook Audience NetworkMediated house ads
adUnitName 广告单元 您选择用来描述该广告单元的名称。广告单元是您在应用中设置的容器,用来向用户展示广告。
appVersion 应用版本 应用的 versionName (Android) 或简短的软件包版本 (iOS)。
audienceId 受众群体 ID 受众群体的数字标识符。在报告的日期范围内,用户会按其所属的受众群体进行报告。当前的用户行为不会影响报告中的既往受众群体成员资格。
audienceName 受众群体名称 受众群体的指定名称。在报告的日期范围内,用户会按其所属的受众群体进行报告。当前的用户行为不会影响报告中的既往受众群体成员资格。
brandingInterest 兴趣 购物漏斗中靠近顶部的用户表现出的兴趣。同一用户可以计入到多个兴趣类别中。例如 ShoppersLifestyles & Hobbies/Pet LoversTravel/Travel Buffs/Beachbound Travelers
浏览器 浏览器 用于查看您网站的浏览器。
campaignId 广告系列 ID 营销广告系列的标识符。仅针对转化事件显示。
campaignName 广告系列 营销广告系列的名称。仅针对转化事件显示。
字符 字符 游戏中针对某个事件的玩家角色。由事件参数 character 填充。
city 城市 发起用户活动的城市。
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 这一日期范围,cohortNthWeek 将为 0001。
contentGroup 内容分组 适用于所发布内容的类别。由事件参数 content_group 填充。
contentId Content ID 所选内容的标识符。由事件参数 content_id 填充。
contentType 内容类型 所选内容的类别。由事件参数 content_type 填充。
country 国家/地区 发起用户活动的国家/地区。
countryId 国家/地区 ID 用户发起活动时所处的国家/地区的地理位置 ID,依据用户的 IP 地址得出。格式符合 ISO 3166-1 alpha-2 标准。
date 日期 事件的日期,格式为 YYYYMMDD。
dateHour 日期 + 时点 (YYYYMMDDhh) 采用 YYYYMMDDHH 格式的日期和时间组合值。
dateHourMinute 日期、小时和分钟 采用 YYYYMMDDHHMM 格式的日期、小时和分钟的组合值。
一个月中的某天(以 01 到 31 之间的两位数字表示)。
dayOfWeek 周几 星期几。它返回 [0,6] 范围内的值,其中星期日是一周的第一天。
defaultChannelGrouping 默认渠道分组 转化的默认渠道分组主要基于来源和媒介。一个枚举,其中包含 DirectOrganic SearchPaid SocialOrganic SocialEmailAffiliatesReferralPaid SearchVideoDisplay
deviceCategory 设备类别 设备类型:桌面设备、平板电脑或移动设备。
deviceModel 设备型号 移动设备型号(例如:iPhone 10、6)。
eventName 事件名称 事件名称。
fileExtension 文件扩展名 已下载文件的扩展名(例如 pdftxt)。如果启用了增强型衡量功能,系统会自动填充数据。由事件参数 file_extension 填充。
fileName 文件名 已下载文件的网页路径(例如 /menus/dinner-menu.pdf)。如果启用了增强型衡量功能,系统会自动填充数据。由事件参数 file_name 填充。
firstSessionDate 首次会话日期 用户首次会话的发生日期,格式为 YYYYMMDD。
firstUserCampaignId 带来用户首次互动的广告系列 ID 最先获取到用户的营销广告系列的标识符。包括 Google Ads 广告系列。
firstUserCampaignName 带来用户首次互动的广告系列 首次获取用户的营销广告系列的名称。包括 Google Ads 广告系列和人工广告系列。
firstUserDefaultChannelGrouping 带来用户首次互动的默认渠道分组 首次获取用户的默认渠道分组。默认渠道分组主要基于来源和媒介。一个枚举,其中包含 DirectOrganic SearchPaid SocialOrganic SocialEmailAffiliatesReferralPaid SearchVideoDisplay
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)
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 关键字文字 最先获取到用户的匹配关键字。关键字是用来描述您的产品或服务的字词或词组,通过选择关键字,您可以向合适的客户展示广告。如需详细了解关键字,请参阅关键字:定义
firstUserGoogleAdsQuery 带来用户首次互动的 Google Ads 查询 首次获取用户的搜索查询。
firstUserManualAdContent 带来用户首次互动的人工广告内容 最先获取到用户的广告内容。由 utm_content 参数填充。
firstUserManualTerm 带来用户首次互动的人工字词 首次获取用户的字词。由 utm_term 参数填充。
firstUserMedium 带来用户首次互动的媒介 首次访问您的网站或应用获取用户的媒介。
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
funnelStepName 步骤 为漏斗步骤分配的描述性名称。例如,如果在请求的第三个漏斗步骤中指定 name = Purchase,系统将在漏斗报告响应中为这个 funnelStepName 维度生成 3. Purchase
funnelStepNewVsContinuing 新维度与现有维度对比 如果用户在前面的漏斗步骤中存在过用户,则他们正在进入漏斗步骤。否则,该用户是新用户。此维度仅对开放漏斗有意义,并返回两个值:newcontinuing
funnelStepNextAction 漏斗中的下一项操作 下一个操作是用户在完成当前步骤后获得的下一个维度值,并且包括完成下一步。例如,如果请求的“下一步”操作维度是 eventName,则此维度会返回实现第 i 个步骤后的下一个事件的名称;此下一个操作不包括到达第 i 步的事件,以及到达第 i+1 步的事件。
googleAdsAccountName Google Ads 账号名称 促成转化事件的广告系列的 Google Ads 账号名称。对应于 Google Ads API 中的 customer.descriptive_name。
googleAdsAdGroupId Google Ads 广告组 ID 归因于转化事件的广告组 ID。
googleAdsAdGroupName Google Ads 广告组名称 归因于转化事件的广告组名称。
googleAdsAdNetworkType Google Ads 广告网络类型 转化的广告网络类型。一个枚举,其中包含 Google searchSearch partnersGoogle Display NetworkYoutube SearchYoutube VideosCross-networkSocial(universal campaign)
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。
小时 小时 事件所记录日期的两位数小时。此维度的范围为 0-23,并以您媒体资源的时区报告。
isConversionEvent 是转化事件 如果事件是转化,则返回字符串 true。事件在收集时被标记为转化;对事件的转化标记所做的更改将应用于未来数据。您可以在 Google Analytics 中将任何事件标记为转化事件,有些事件(例如 first_open、purchase)默认情况下会被标记为转化。如需了解详情,请参阅转化简介
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 商品列表名称 商品列表的名称。
itemName 商品名称 商品的名称。
itemPromotionCreativeName 商品推广活动的广告素材名称 商品促销活动所用广告素材的名称。
itemPromotionId 商品促销活动的 ID 商品促销活动的 ID。
itemPromotionName 商品推广活动的名称 商品促销活动的名称。
itemVariant 商品款式 产品的具体款式。例如,XS、S、M、L 代表尺寸;或红色、蓝色、绿色、黑色表示颜色。由 item_variant 参数填充。
landingPage 着陆页 与会话中的首次网页浏览相关联的网页路径 + 查询字符串。
language 语言 用户浏览器或设备的语言设置。例如,英语
languageCode 语言代码 用户浏览器或设备的语言设置 (ISO 639)。例如 en-us
level 级别 玩家在游戏中所处的关卡。由事件参数 level 填充。
linkClasses 链接类 出站链接的 HTML 类属性。例如,如果用户点击链接 <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 参数填充。
manualTerm 人工字词 归因于转化事件的字词。由 utm_term 参数填充。
medium 归因于转化事件的媒介。
method 方法 触发事件的方式。由事件参数 method 填充。
分钟 分钟 该事件所记录事件对应的小时的两位数分钟数。此维度的范围为 0-59,并采用您媒体资源的时区进行报告。
mobileDeviceBranding 设备品牌 制造商或品牌名称(例如 Samsung、HTC、Verizon、T-Mobile)。
mobileDeviceMarketingName 设备 品牌设备名称(例如:Galaxy S10 或 P30 Pro)。
mobileDeviceModel 移动设备型号 移动设备的型号名称(例如:iPhone X 或 SM-G950F)。
事件的月份(以 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 订单优惠券 订单级优惠券的代码。
出站 出站 如果指向某个网站的链接不属于相应资源的网域,则返回 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=true 的 pagePathPlusQueryString 部分为 /store/contact-us?query_string=true
pageReferrer 网页引荐来源网址 包含主机名和路径的完整引荐来源网址。此引荐来源网址是用户之前的网址,可以是此网站的网域或其他网域。由事件参数 page_referrer 填充。
pageTitle 网页标题 您网站上使用的网页标题。
percentScrolled 已滚动百分比 用户向下滚动页面的百分比(例如 90)。如果启用了增强型衡量功能,系统会自动填充数据。由事件参数 percent_scrolled 填充。
平台 平台 您的应用或网站的运行平台;例如网站、iOS 或 Android。要确定报告中的数据流类型,请同时使用 platform 和 streamId。
platformDeviceCategory 平台类别/设备类别 您的网站或移动应用的运行平台和设备类型。(例如:Android / 移动设备)
区域 区域 用户发起活动时所处的地理区域,依据用户的 IP 地址得出。
screenResolution 屏幕分辨率 用户显示器的屏幕分辨率。例如,1920x1080。
searchTerm 搜索字词 用户搜索的字词。例如,如果用户访问了 /some-page.html?q=some-term,则此维度会返回 some-term。如果启用了增强型衡量功能,系统会自动填充数据。由事件参数 search_term 填充。
细分 分割部分 “细分”是指您的一部分 Google Analytics 数据。例如,在您的整个用户群中,您可使用一个细分来指定来自特定国家/地区或城市的用户,如需了解详情,请参阅细分生成工具。细分维度会返回请求中分配给细分的名称,前缀从 1 开始(即,如果请求中的第一个细分名为 Paid Traffic,那么此细分在响应中将为 1. Paid Traffic)。如果请求中未指定细分名称,则细分将采用从 1 开始的名称(即 1. Segment2. Segment 等)。
sessionCampaignId 带来会话的广告系列 ID 会话的营销活动 ID。包括人工广告系列以及通过集成关联(例如 Google Ads 和 Search Ads 360)实现的广告系列。
sessionCampaignName 带来会话的广告系列 会话的营销广告系列名称。包括人工广告系列以及通过集成关联(例如 Google Ads 和 Search Ads 360)实现的广告系列。
sessionDefaultChannelGrouping 带来会话的默认渠道分组 会话的默认渠道分组主要基于来源和媒介。一个枚举,其中包含 DirectOrganic SearchPaid SocialOrganic SocialEmailAffiliatesReferralPaid SearchVideoDisplay
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)
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 参数填充。
sessionManualTerm 带来会话的人工字词 促成会话的字词。由 utm_term 参数填充。
sessionMedium 带来会话的媒介 在您的网站或应用上发起会话的媒介。
sessionSa360AdGroupName 带来会话的 SA360 广告组名称 促成此会话的 Search Ads 360 广告组名称。
sessionSa360CampaignName 带来会话的 SA360 广告系列 促成此会话的 Search Ads 360 广告系列名称。
sessionSa360CreativeFormat 带来会话的 SA360 广告素材格式 Search Ads 360 中促成此会话的广告素材类型。例如 Responsive search adExpanded text ad。 如需了解详情,请参阅 GA4 流量来源维度
sessionSa360EngineAccountId 带来会话的 SA360 引擎账号 ID SA360 中促成此会话的引擎账号 ID。
sessionSa360EngineAccountName 带来会话的 SA360 引擎账号名称 SA360 中促成此会话的引擎账号的名称。
sessionSa360EngineAccountType 带来会话的 SA360 引擎账号类型 Search Ads 360 中促成此会话的引擎账号的类型。例如 google adsbingbaidu
sessionSa360Keyword 带来会话的 SA360 关键字文字 Search Ads 360 中促成此会话的搜索引擎关键字。
sessionSa360Medium 带来会话的 SA360 媒介 Search Ads 360 中促成此会话的搜索引擎关键字。例如 cpc
sessionSa360Query 带来会话的 SA360 查询 Search Ads 360 中促成此会话的搜索查询。
sessionSa360Source 带来会话的 SA360 来源 促成此会话的 Search Ads 360 流量来源。例如,example.comgoogle
sessionSource 会话来源 在您的网站或应用上发起会话的来源。
sessionSourceMedium 带来会话的来源/媒介 维度 sessionSourcesessionMedium 的总值。
sessionSourcePlatform 带来会话的来源平台 会话的广告系列的来源平台。对于使用 UTM 的流量,请勿依赖返回 Manual 的此字段;对于即将发布的功能,此字段会从返回 Manual 更新为返回 (not set)
shippingTier 配送级别 用户为所购商品选择的配送级别(例如 Ground、Air、Next-day)。由 shipping_tier 事件参数填充。
signedInWithUserId 是否已使用用户 ID 登录 如果用户使用 User-ID 功能登录,则为字符串 yes。如需详细了解 User-ID,请参阅使用 User-ID 衡量跨平台活动
来源 来源 归因于转化事件的来源。
sourceMedium 来源/媒介 维度 sourcemedium 的总值。
sourcePlatform 来源平台 转化事件的广告系列的来源平台。对于使用 UTM 的流量,请勿依赖返回 Manual 的此字段;对于即将发布的功能,此字段会从返回 Manual 更新为返回 (not set)
streamId 数据流 ID 您的应用或网站的数字数据流标识符。
streamName 数据流名称 您的应用或网站的数据流名称。
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 填充。
事件的星期几(以 01 到 53 之间的两位数数字)。每周从周日开始。1 月 1 日始终是第 01 周。大多数年份中的第 1 周和第 1 周都少于 7 天。一年的第一周和最后一周以外的周始终为 7 天。对于 1 月 1 日是星期日的年份,当年的第 1 周和去年的最后一周均为 7 天。
事件的四位数年份,例如 2020。

自定义维度

Data API 可以创建关于事件级和用户级范围的自定义维度的报告。请参阅 事件级范围的自定义维度和指标报告自定义用户属性,以 详细了解自定义维度。自定义维度是在 API 中指定的 维度的参数名称和范围。例如,添加 "customEvent:achievement_id",以便为 参数名称为“"achievement_id"”的事件级范围的自定义维度。此 API 则请求将失败。 维度。

如果事件级范围的自定义维度是在 2020 年 10 月之前注册的,则 维度及其事件名称。例如: 针对事件级范围的自定义交易添加 "customEvent:achievement_id\[level_up\]" 参数名称为 "achievement_id",事件名称为 "level_up" 的维度。在 2020 年 10 月,Google Analytics 取代了自定义参数 使用事件级范围的报告 自定义维度和指标 报告。

以下是自定义维度的一般语法。您可以使用 Metadata API 方法用于列出 媒体资源的自定义维度;请参阅此处的使用 Metadata API 的示例 方法

通用 API 名称 在细分中可用 说明
customEvent:parameter_name parameter_name 的事件级范围的自定义维度
customEvent:parameter_name[event_name] 参数_name 的事件级范围的自定义维度(如果在 2020 年 10 月之前注册)
customUser:parameter_name parameter_name 的用户级范围的自定义维度

自定义渠道组

Google Data API 可以创建有关自定义渠道组的报告。要详细了解 自定义渠道组,请参阅 Google Analytics 。 在 API 报告请求中,系统会按维度的 范围和渠道组 ID例如,添加 Data API 中的 "sessionCustomChannelGroup:9432931" 请求为会话级范围的自定义渠道生成 ID 为 9432931。如果媒体资源不含自定义属性,则此 API 请求将失败 与此 ID 相关联的频道

以下是自定义渠道组的一般语法。您可以使用 Metadata API 方法列出 媒体资源的自定义渠道分组。

通用 API 名称 说明
sessionCustomChannelGroup:custom_channel_id 促成此会话的自定义渠道。
firstUserCustomChannelGroup:custom_channel_id 最先获取了该用户的自定义渠道。
customChannelGroup:custom_channel_id 促成转化事件的自定义渠道。

指标

以下指标可以显示在任何媒体资源的漏斗报告中。

API 名称 界面名称 说明
activeUsers 活跃用户数 访问过您的网站或应用的去重用户数。
funnelStepAbandonmentRate 放弃率 在这一步放弃漏斗的用户所占的百分比。此指标以小数形式返回;例如,0.412 表示 41.2% 的用户在这一步骤放弃渠道。
funnelStepAbandonments 放弃人数 在这一步放弃漏斗的用户绝对数量。
funnelStepCompletionRate 完整播放率 完成漏斗这一步骤的用户所占的百分比。此指标以小数形式返回;例如,0.588 表示 58.8% 的用户完成了此漏斗步骤。