Google Analytics Data API 漏斗报告支持这些维度和指标。
维度
对于任何媒体资源，都可以在漏斗报告中请求以下维度。
指定“API 名称”（位于 Dimension 资源的
name 字段。
| 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。 |
| 浏览器 | 浏览器 | 是 | 用于查看您网站的浏览器。 |
| 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 | 默认渠道分组 | 否 | 转化的默认渠道分组主要基于来源和媒介。一个枚举，其中包含 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。 |
| 小时 | 小时 | 是 | 事件所记录日期的两位数小时。此维度的范围为 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 次或多次会话。此维度会返回两个值：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 填充。 |
| 平台 | 平台 | 是 | 您的应用或网站的运行平台；例如网站、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 关键字文字 | 否 | 促成会话的匹配关键字。关键字是用来描述您的产品或服务的字词或词组，通过选择关键字，您可以向合适的客户展示广告。如需详细了解关键字，请参阅关键字：定义。 |
| 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 ad 或 Expanded text ad。 如需了解详情，请参阅 GA4 流量来源维度。 |
| sessionSa360EngineAccountId | 带来会话的 SA360 引擎账号 ID | 否 | SA360 中促成此会话的引擎账号 ID。 |
| sessionSa360EngineAccountName | 带来会话的 SA360 引擎账号名称 | 否 | SA360 中促成此会话的引擎账号的名称。 |
| sessionSa360EngineAccountType | 带来会话的 SA360 引擎账号类型 | 否 | Search Ads 360 中促成此会话的引擎账号的类型。例如 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 | 配送级别 | 否 | 用户为所购商品选择的配送级别（例如 Ground、Air、Next-day）。由 shipping_tier 事件参数填充。 |
| signedInWithUserId | 是否已使用用户 ID 登录 | 是 | 如果用户使用 User-ID 功能登录，则为字符串 yes。如需详细了解 User-ID，请参阅使用 User-ID 衡量跨平台活动。 |
| 来源 | 来源 | 否 | 归因于转化事件的来源。 |
| sourceMedium | 来源/媒介 | 否 | 维度 source 和 medium 的总值。 |
| 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% 的用户完成了此漏斗步骤。 |