Google Analytics(分析)Data API 漏斗报告支持这些维度和指标。
维度
您可以在任何媒体资源的漏斗报告中请求以下维度。
在 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 | 受众群体名称 | 否 | 受众群体的给定名称。在报告日期范围内,用户按用户所属的受众群体进行报告。当前的用户行为不会影响报告中的既往受众群体成员资格。 |
brandingInterest | 兴趣 | 否 | 购物漏斗中靠近顶部的用户表现出的兴趣。同一用户可以计入到多个兴趣类别中。例如 Shoppers 、Lifestyles & Hobbies/Pet Lovers 或 Travel/Travel Buffs/Beachbound Travelers 。 |
browser | 浏览器 | 是 | 用于查看您网站的浏览器。 |
campaignId | 广告系列 ID | 否 | 营销广告系列的标识符。仅针对转化事件显示。 |
campaignName | 广告系列 | 否 | 营销广告系列的名称。仅针对转化事件显示。 |
字符 | 基于字符, | 是 | 游戏中针对某个事件的玩家角色。由事件参数 character 填充。 |
city | 城市 | 是 | 发起用户活动的城市。 |
cityId | 城市 ID | 是 | 用户发起活动时所处的城市的地理位置 ID,依据用户的 IP 地址得出。 |
cohort | 同类群组 | 否 | 请求中的同类群组名称。同类群组是指在任意连续几天内开始使用您的网站或应用的一组用户。如果未在请求中指定同类群组名称,则同类群组以其从零开始的索引命名,例如:同类群组 _0、同类群组 _1。 |
cohortNthDay | 每日同类群组 | 否 | 同类群组中用户相对于 firstSessionDate 的日期偏移量。例如,如果选择的同类群组的开始日期和结束日期均为 2020-03-01,则对于 2020-03-02,同类群组 NthDay 将为 0001。 |
cohortNthMonth | 每月同类群组 | 否 | 同类群组中用户相对于 firstSessionDate 的月份偏移量。月边界与日历月边界一致。例如,如果选择同类群组的开始日期和结束日期分别是 2020 年 3 月,则对于 2020 年 4 月的任何日期,同类群组 NthMonth 将为 0001。 |
cohortNthWeek | 每周同类群组 | 否 | 同类群组中用户相对于 firstSessionDate 的周偏移量。一周从星期日开始,到星期六结束。例如,如果选择同类群组的开始日期和结束日期介于 2020-11-08 至 2020-11-14 之间,则对于 2020-11-15 至 2020-11-21 这一日期,同类群组 NthWeek 将为 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 | 默认渠道分组 | 否 | 转化的默认渠道分组主要基于来源和媒介。一个枚举,包含 Direct 、Organic Search 、Paid Social 、Organic Social 、Email 、Affiliates 、Referral 、Paid Search 、Video 和 Display 。 |
deviceCategory | 设备类别 | 是 | 设备类型:桌面设备、平板电脑或移动设备。 |
deviceModel | 设备型号 | 是 | 移动设备型号(例如:iPhone 10、6)。 |
eventName | 事件名称 | 是 | 事件名称。 |
fileExtension | 文件扩展名 | 是 | 所下载文件的扩展名(例如 pdf 或 txt )。如果启用增强型衡量功能,系统会自动填充数据。由事件参数 file_extension 填充。 |
fileName | 文件名 | 是 | 已下载文件的网页路径(例如 /menus/dinner-menu.pdf )。如果启用增强型衡量功能,则自动填充。由事件参数 file_name 填充。 |
firstSessionDate | 首次会话日期 | 是 | 用户首次会话发生的日期,格式为 YYYYMMDD。 |
firstUserCampaignId | 带来用户首次互动的广告系列 ID | 否 | 最先获取到用户的营销广告系列的标识符。包括 Google Ads 广告系列。 |
firstUserCampaignName | 带来用户首次互动的广告系列 | 是 | 最先获取到用户的营销广告系列的名称。包括 Google Ads 广告系列和人工广告系列。 |
firstUserDefaultChannelGrouping | 带来用户首次互动的默认渠道分组 | 是 | 最先获取到用户的默认渠道分组。默认渠道分组主要基于来源和媒介。一个枚举,包含 Direct 、Organic Search 、Paid Social 、Organic Social 、Email 、Affiliates 、Referral 、Paid Search 、Video 和 Display 。 |
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) 。 |
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 | 带来用户首次互动的来源/媒介 | 否 | 维度 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 。 |
funnelStepName | 步骤 | 否 | 为漏斗步骤分配的描述性名称。例如,如果在请求的第三个漏斗步骤中指定 name = Purchase ,系统会在漏斗报告响应中为此 funnelStepName 维度生成 3. Purchase 。 |
funnelStepNewVsContinuing | 新维度与现有维度对比 | 否 | 如果用户出现在之前的漏斗步骤中,则继续完成漏斗步骤。否则,该用户就是新用户。此维度仅适用于开放漏斗,会返回两个值:new 和 continuing 。 |
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 search 、Search partners 、Google Display Network 、Youtube Search 、Youtube Videos 、Cross-network 、Social 和 (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。 |
hour | 小时 | 是 | 记录事件的当天的两位数小时。此维度的范围是 0-23,按照您媒体资源的时区进行报告。 |
isConversionEvent | 是转化事件 | 是 | 如果事件属于转化,则返回字符串 true 。事件会在收集时标记为转化;对事件转化标记所做的更改今后会生效。您可以在 Google Analytics(分析)中将任何事件标记为转化,有些事件(例如 first_open、purchase)会默认标记为转化。如需了解详情,请参阅转化简介。 |
itemAffiliation | 商品关联商户 | 否 | 与单件商品关联的联属营销方(合作伙伴/供应商;如果有)的名称或代码。由 affiliation item 参数填充。 |
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 | 新用户/回访用户 | 是 | 新用户之前有 0 个会话,回访用户之前有 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 | 订单优惠券 | 是 | 订单级优惠券的代码。 |
出站 | 外发 | 是 | 如果指向某个网站的链接不属于相应媒体资源的网域,则返回 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。如需在报告中确定数据流的类型,请同时使用 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. Segment 、2. Segment 等)为细分受众群命名。 |
sessionCampaignId | 带来会话的广告系列 ID | 否 | 会话的营销广告系列 ID。包括人工广告系列和来自 Google Ads 与 Search Ads 360 等集成关联的广告系列。 |
sessionCampaignName | 带来会话的广告系列 | 是 | 会话的营销广告系列名称。包括人工广告系列和来自 Google Ads 与 Search Ads 360 等集成关联的广告系列。 |
sessionDefaultChannelGrouping | 带来会话的默认渠道分组 | 是 | 会话的默认渠道分组主要基于来源和媒介。一个枚举,包含 Direct 、Organic Search 、Paid Social 、Organic Social 、Email 、Affiliates 、Referral 、Paid Search 、Video 和 Display 。 |
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) 。 |
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 关键字文字 | 否 | 促成会话的匹配关键字。关键字是用来描述产品或服务的字词或词组,您选择用来将您的广告展示给合适的客户。要详细了解关键字,请参阅 [关键字:定义 |
](//support.google.com/google-ads/answer/6323)。
sessionGoogleAdsQuery | 带来会话的 Google Ads 查询 | 否 | 促成会话的搜索查询。
sessionManualAdContent | 会话人工广告内容 | 是 | 促成会话的广告内容。由 utm_content 参数填充。
sessionManualTerm | 带来会话的手动字词 | 是 | 促成会话的字词。由 utm_term 参数填充。
sessionMedium | Session medium | 是 | 在您的网站或应用上发起会话的媒介。
sessionSa360AdGroupName | 会话 SA360 广告组名称 | 否 | Search Ads 360 中促成此会话的广告组名称。
会话 Search Ads 360CampaignFormat 中促成此会话的 SA3 | 会话 SA360 中的 SA360 广告系列名称。例如 Responsive search ad
或 Expanded text ad
。 有关详情,请参阅 GA4 流量来源维度。
sessionSa360EngineAccountId | 带来会话的 SA360 引擎账号 ID | 否 | SA360 中促成此会话的引擎账号的 ID。
sessionSa360EngineAccountName | 带来会话的 SA360 引擎账号名称 | 否 | 此 Search Ads 360 中由 SA360 发起的会话的引擎账号名称:Search Ads 360 中由 SA360 发起的 SA3030 引擎账号。会话类型为 SA360 的引擎账号。例如 google ads
、bing
或 baidu
。
sessionSa360Keyword | 带来会话的 SA360 关键字文字 | 否 | Search Ads 360 中促成了此会话的搜索引擎关键字。
sessionSa360Medium | 带来会话的 SA360 媒介 | 否 | Search Ads 360 中促成此会话的搜索引擎关键字。例如 cpc
。
sessionSa360Query | 带来会话的 SA360 查询 | 否 | Search Ads 360 中促成此会话的搜索查询。
sessionSa360Source | 带来会话的 SA360 来源 | 否 | Search Ads 360 促成此会话的流量来源。例如 example.com
或 google
。
sessionSource | 会话来源 | 是 | 在您的网站或应用中发起会话的来源。
sessionSourceMedium | 会话来源 / 媒介 | 否 | 维度 sessionSource
和 sessionMedium
的组合值。
sessionSourcePlatform | 会话来源平台 | 否 | 会话的广告系列的来源平台。对于使用 UTM 的流量,请勿依赖此字段返回 Manual
;对于即将推出的功能,此字段将从返回 Manual
更新为返回 (not set)
。shippingTier | Shipping Tier | 否 | 为所购商品选择的配送级别(例如:陆运、空运、次日达)。由 shipping_tier
事件参数填充。
signedInWithUserId | 已使用用户 ID 登录 | 是 | 如果用户使用 User-ID 功能登录,则为字符串 yes
。如需详细了解 User-ID,请参阅使用 User-ID 衡量跨平台活动。
来源 | 来源 | 否 | 归因于转化事件的来源。
sourceMedium | 来源 / 媒介 | 否 | 维度 source
和 medium
的组合值。
sourcePlatform | 来源平台 | 否 | 转化事件所对应的广告系列的来源平台。对于使用 UTM 的流量,请勿依赖此字段返回 Manual
;对于即将推出的功能,此字段将从返回 Manual
更新为返回 (not set)
。
streamId | 数据流 ID | 是 | 应用或网站的数字数据流标识符。
streamName | 数据流名称 | 是 | 应用或网站的数据流名称。
testDataFilterName | 测试数据过滤器名称 | 否 | 处于测试状态的数据过滤器名称。您可以使用数据过滤器根据事件参数值在报告中包含或排除事件数据。如需了解详情,请参阅数据过滤条件 |youtube
由事件参数 video_provider
填充。
videoTitle | 视频标题 | 是 | 视频的标题。如果启用了增强型衡量功能,系统会自动填充嵌入视频。由事件参数 video_title
填充。
videoUrl | 视频网址 | 是 | 视频的网址。如果启用了增强型衡量功能,系统会自动填充嵌入视频。由事件参数 video_url
填充。
virtualCurrencyName | 虚拟货币名称 | 是 | 用户与之互动的虚拟货币的名称。例如,在游戏中消费或购买宝石。由 virtual_currency_name
事件参数填充。visible | Visible | Yes | 如果内容可见,则返回 true
。如果启用了增强型衡量功能,系统会自动填充嵌入视频。由事件参数 visible
填充。
周 | 周 | 是 | 事件是在哪周发生的,以 01 到 53 之间的两位数数字表示。每周从星期日开始。1 月 1 日始终位于第 1 周。在大多数年份中,一年的第一周和最后一周的天数少于 7 天。除了一年中的第 1 周和最后一周,其他周始终有 7 天。对于 1 月 1 日是星期日的年份,如果年份 1 月 1 日是星期日,那么这一年的第一周和前一年的最后一周有 7 天。
year | Year | Yes | 事件的四位数年份,例如 2020。
自定义维度
Google 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 月,Analytics(分析)用事件级范围的自定义维度和指标报告取代了自定义参数报告。
以下是自定义维度的通用语法。您可以查询 Metadata API 方法以列出属性的所有自定义维度;以下是 Metadata API 方法使用示例。
通用 API 名称 | 在细分中可用 | 说明 |
---|---|---|
customEvent:parameter_name | 是 | attribute_name 事件级范围的自定义维度 |
customEvent:parameter_name[event_name] | 是 | attribute_name 事件级范围的自定义维度(如果在 2020 年 10 月之前注册) |
customUser:parameter_name | 是 | attribute_name 的用户级范围的自定义维度 |
自定义渠道组
Google Data API 可以创建有关自定义渠道组的报告。如需详细了解自定义渠道组,请参阅 GA4 中的自定义渠道组。在 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 | 促成转化事件的自定义渠道。 |
指标
以下指标可以出现在任何媒体资源的漏斗报告中。
API 名称 | 界面名称 | 说明 |
---|---|---|
activeUsers | 活跃用户数 | 访问过您的网站或应用的去重用户数。 |
funnelStepAbandonmentRate | 放弃率 | 在这一步放弃漏斗的用户所占的百分比。此指标以小数形式返回;例如,0.412 表示 41.2% 的用户在这一步放弃了漏斗。 |
funnelStepAbandonments | 放弃人数 | 在这一步放弃漏斗的用户的绝对数量。 |
funnelStepCompletionRate | 完整播放率 | 完成漏斗中这一步骤的用户所占的百分比。此指标以小数形式返回;例如,0.588 表示 58.8% 的用户完成了此漏斗步骤。 |