- HTTP 请求
- 路径参数
- 请求正文
- 响应正文
- 授权范围
- DateRange
- 漏斗
- FunnelStep
- FunnelFilterExpression
- FunnelFilterExpressionList
- FunnelFieldFilter
- 字符串过滤条件
- MatchType
- InListFilter
- NumericFilter
- 操作
- NumericValue
- BetweenFilter
- FunnelEventFilter
- FunnelParameterFilterExpression
- FunnelParameterFilterExpressionList
- FunnelParameterFilter
- FunnelBreakdown
- 维度
- DimensionExpression
- Case 表达式
- ConcatenateExpression
- FunnelNextAction
- FunnelVisualizationType
- 细分
- 用户细分
- UserSegmentCriteria
- UserSegmentConditionGroup
- 用户条件范围
- SegmentFilter 表达式
- SegmentFilter 表达式列表
- SegmentFilter
- SegmentFilterScoping
- SegmentEventFilter
- SegmentParameterFilter 表达式
- SegmentParameterFilterExpressionList
- SegmentParameterFilter
- SegmentParameterFilterScoping
- UserSegmentSequenceGroup
- UserSequenceStep
- UserSegmentExclusion
- 用户排除时长
- SessionSegment
- SessionSegmentCriteria
- SessionSegmentConditionGroup
- SessionCriteriaScoping
- SessionSegmentExclusion
- SessionExclusionDuration
- 事件细分
- EventSegmentCriteria
- EventSegmentConditionGroup
- EventCriteriaScoping
- EventSegmentExclusion
- EventExclusionDuration
- FilterExpression
- FilterExpressionList
- 过滤条件
- FunnelSubReport
- DimensionHeader
- MetricHeader
- MetricType
- 行
- DimensionValue
- MetricValue
- FunnelResponseMetadata
- SamplingMetadata
- PropertyQuota
- QuotaStatus
- 试试看!
返回 Google Analytics(分析)事件数据的自定义漏斗报告。从 API 返回的数据会以表格形式列出所请求的维度和指标。
漏斗探索可以直观呈现用户为完成任务而采取的步骤,并让您迅速了解用户在每个步骤上的成功或失败情况。例如,潜在客户如何成为购物者,进而成为买家?一次性买家如何成为回头客?借助这些信息,您可以改进效率低下的或已放弃的客户转化历程。如需了解详情,请参阅 GA4 漏斗探索。
此方法是在 Alpha 版稳定性阶段推出的,目的是在进入 Beta 版之前收集有关语法和功能的反馈。欢迎填写 Google Analytics(分析)Data API 漏斗报告反馈,提供您对此 API 的反馈。
HTTP 请求
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
property |
跟踪事件的 Google Analytics(分析)GA4 媒体资源标识符。在网址路径(而非正文)中指定。如需了解详情,请参阅在哪里可以找到您的媒体资源 ID。在批处理请求中,此属性应未指定或与批次级属性保持一致。 示例:properties/1234 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "dateRanges": [ { object ( |
字段 | |
---|---|
dateRanges[] |
要读取的数据的日期范围。如果请求了多个日期范围,则每个响应行都会包含一个从零开始的日期范围索引。如果两个日期范围发生重叠,则重叠日期范围的事件数据会同时添加到两个日期范围的响应行中。 |
funnel |
此请求的漏斗配置。必须提供此漏斗配置。 |
funnelBreakdown |
如果指定,此细分会在漏斗表格子报告响应中添加一个维度。此细分维度将每个漏斗步骤扩展为细分维度的唯一值。例如,如果按 |
funnelNextAction |
如果已指定,则下一步操作会为“渠道可视化”子报告响应添加一个维度。此“下一个操作”维度将每个漏斗步骤扩展到下一个操作的“唯一”值。例如, Next 操作仅支持 |
funnelVisualizationType |
漏斗可视化类型用于控制漏斗可视化子报告响应中显示的维度。如果未指定,则系统会使用 |
segments[] |
细分的配置。细分是媒体资源数据的子集。在包含细分的漏斗报告中,系统会在每个细分中对漏斗进行评估。 此请求中指定的每个细分都会在响应中生成单独的一行;在响应中,每个细分都由其名称标识。 segments 参数是可选的。请求最多只能包含 4 个细分。 |
limit |
要返回的行数。如果未指定,则返回 10000 行。无论您要求返回多少行,该 API 最多可为每个请求返回 10 万行。“ 如果维度值数量少于 |
dimensionFilter |
通过维度过滤条件,您可以仅要求在报告中提供特定的维度值。如需了解详情,请参阅创建报告:维度过滤条件。此过滤条件中不能使用指标。 |
returnPropertyQuota |
选择是否返回此 Google Analytics(分析)媒体资源配额的当前状态。配额在 PropertyQuota 中返回。 |
响应正文
如果成功,响应正文将包含结构如下的数据:
漏斗报告响应包含两个子报告。这两种子报告是维度和指标的组合。
JSON 表示法 |
---|
{ "funnelTable": { object ( |
字段 | |
---|---|
funnelTable |
“漏斗表”是一个包含漏斗步骤、细分、细分维度、活跃用户、完整率、放弃率和放弃率的报告。 只有在已请求细分的情况下,此响应中才会显示细分维度。仅当收到细分维度请求时,此维度才会显示在此响应中。 |
funnelVisualization |
“漏斗可视化”报告包含漏斗步骤、细分、日期、下一个操作维度和活跃用户。 只有在已请求细分的情况下,此响应中才会显示细分维度。只有通过 |
propertyQuota |
此 Google Analytics(分析)媒体资源的配额状态,包括此请求。 |
kind |
标识此消息的资源类型。此 |
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
DateRange
一组连续的日期:startDate、startDate + 1、...、endDate。最多可以有 4 个日期范围的请求。
JSON 表示法 |
---|
{ "startDate": string, "endDate": string, "name": string } |
字段 | |
---|---|
startDate |
查询的开始日期(包含该日期),格式为 |
endDate |
包含查询的结束日期(格式为 |
name |
为此日期范围指定一个名称。在报告响应中,维度 |
漏斗
在漏斗报告请求中配置漏斗。漏斗报告的是用户经历一系列步骤的情况。
漏斗探索可以直观呈现用户为完成任务而采取的步骤,并让您迅速了解用户在每个步骤上的成功或失败情况。例如,潜在客户如何成为购物者,进而成为买家?一次性买家如何成为回头客?根据这些信息,您可以改进低效或被用户放弃的客户转化历程。
JSON 表示法 |
---|
{
"isOpenFunnel": boolean,
"steps": [
{
object ( |
字段 | |
---|---|
isOpenFunnel |
在开放漏斗中,用户可以在任何步骤进入漏斗;在封闭漏斗中,用户必须在第一个步骤进入漏斗。(可选)如果未指定,则使用封闭漏斗。 |
steps[] |
此漏斗的连续步骤。 |
漏斗步骤
步骤定义着您要衡量的用户历程。步骤包含一个或多个条件,您的用户必须满足这些条件才能被纳入漏斗历程的相应步骤。
JSON 表示法 |
---|
{
"name": string,
"isDirectlyFollowedBy": boolean,
"filterExpression": {
object ( |
字段 | |
---|---|
name |
此步骤的独特名称。如果未指定,步骤将基于从 1 开始编入索引的名称(即 "0)。&tot;1. " 等)。此名称定义了 |
isDirectlyFollowedBy |
如果为 true,则此步骤必须直接执行上一步。如果为 false,则上一步和此步骤之间可能存在事件。如果未指定,则将 |
filterExpression |
用户必须满足的哪些条件,才能纳入漏斗历程的这一步。 |
withinDurationFromPriorStep |
如果指定,则此步骤必须在上一步完成的这段时间内完成。
此时长以秒为单位,最多包含九个小数位,以 ' |
漏斗过滤条件表达式
表示漏斗过滤条件的组合。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 expr 。为 FunnelFilterExpression 指定一种类型的过滤器。expr 只能是下列其中一项: |
|
andGroup |
|
orGroup |
|
notExpression |
FunnelFilterExpression 不是 |
funnelFieldFilter |
维度或指标的漏斗过滤条件。 |
funnelEventFilter |
创建与单个事件名称的事件匹配的过滤器。如果指定了参数过滤条件表达式,则只有与单个事件名称和参数过滤条件表达式匹配的部分事件与此事件过滤条件匹配。 |
FunnelFilterExpressionList
漏斗过滤条件表达式列表。
JSON 表示法 |
---|
{
"expressions": [
{
object ( |
字段 | |
---|---|
expressions[] |
漏斗过滤条件表达式列表。 |
漏斗字段过滤条件
用于过滤维度或指标值的表达式。
JSON 表示法 |
---|
{ "fieldName": string, // Union field |
字段 | |
---|---|
fieldName |
维度名称或指标名称。 |
联合字段 one_filter 。指定一种类型的过滤条件。one_filter 只能是下列其中一项: |
|
stringFilter |
与字符串相关的过滤条件。 |
inListFilter |
列表值中的过滤条件。 |
numericFilter |
数字或日期值的过滤条件。 |
betweenFilter |
两个值之间的过滤条件。 |
字符串过滤器
字符串过滤条件
JSON 表示法 |
---|
{
"matchType": enum ( |
字段 | |
---|---|
matchType |
此过滤器的匹配类型。 |
value |
用于匹配的字符串值。 |
caseSensitive |
如果为 true,则字符串值区分大小写。 |
MatchType
字符串过滤器的匹配类型
枚举 | |
---|---|
MATCH_TYPE_UNSPECIFIED |
未指定 |
EXACT |
字符串值完全匹配。 |
BEGINS_WITH |
以字符串值开头。 |
ENDS_WITH |
以字符串值结尾。 |
CONTAINS |
包含字符串值。 |
FULL_REGEXP |
正则表达式与字符串值的完全匹配。 |
PARTIAL_REGEXP |
正则表达式与字符串值的部分匹配。 |
InListFilter
结果必须位于字符串值列表中。
JSON 表示法 |
---|
{ "values": [ string ], "caseSensitive": boolean } |
字段 | |
---|---|
values[] |
字符串值的列表。不得为空。 |
caseSensitive |
如果为 true,则字符串值区分大小写。 |
数值过滤条件
数值或日期值的过滤条件。
JSON 表示法 |
---|
{ "operation": enum ( |
字段 | |
---|---|
operation |
此过滤器的操作类型。 |
value |
数值或日期值。 |
操作
应用于数字过滤器的操作
枚举 | |
---|---|
OPERATION_UNSPECIFIED |
未指定。 |
EQUAL |
等于 |
LESS_THAN |
小于 |
LESS_THAN_OR_EQUAL |
小于或等于 |
GREATER_THAN |
大于 |
GREATER_THAN_OR_EQUAL |
大于或等于 |
NumericValue
表示数字。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 one_value 。数值 one_value 只能是下列其中一项: |
|
int64Value |
整数值 |
doubleValue |
DoubleValue |
介于两者之间
表示结果必须介于两个数字(含)之间。
JSON 表示法 |
---|
{ "fromValue": { object ( |
字段 | |
---|---|
fromValue |
以此编号开头。 |
toValue |
以此编号结尾。 |
漏斗事件过滤器
创建与单个事件名称的事件匹配的过滤器。如果指定了参数过滤条件表达式,则只有与单个事件名称和参数过滤条件表达式匹配的部分事件与此事件过滤条件匹配。
JSON 表示法 |
---|
{
"eventName": string,
"funnelParameterFilterExpression": {
object ( |
字段 | |
---|---|
eventName |
此过滤条件与这个事件名称中的事件相匹配。事件名称为必填项。 |
funnelParameterFilterExpression |
如果指定,此过滤条件将匹配与单个事件名称和参数过滤条件表达式匹配的事件。 在参数过滤条件表达式内,只有参数过滤条件可用。 |
FunnelParameterFilterExpression
表示参数组合的漏斗过滤条件组合。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 expr 。为 FunnelParameterFilterExpression 指定一种类型的过滤器。expr 只能是下列其中一项: |
|
andGroup |
|
orGroup |
|
notExpression |
FunnelParameterFilterExpression 不是 |
funnelParameterFilter |
初始漏斗参数过滤条件。 |
FunnelParameterFilterExpressionList
漏斗参数过滤条件表达式列表。
JSON 表示法 |
---|
{
"expressions": [
{
object ( |
字段 | |
---|---|
expressions[] |
漏斗参数过滤条件表达式列表。 |
FunnelParameterFilter
用于过滤漏斗中参数值的表达式。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 one_parameter 。要过滤的字段。one_parameter 只能是下列其中一项: |
|
eventParameterName |
系统将根据指定的事件参数评估此过滤条件。事件参数会记录为事件的参数。事件参数包括 &firebaseotscreen" & "currency" 等字段。 事件参数只能在细分和漏斗中使用,并且只能在 EventFilter 的后代过滤器中使用。在 EventFilter 的后代过滤器中,应使用事件参数或商品参数。 |
itemParameterName |
系统将根据指定的 item 参数评估此过滤条件。系统会将 item 参数记录为 item 数组中的参数。商品参数包含 "item_name" & "item_category"> 等字段。 Item 参数只能在细分和漏斗中使用,并且只能在 EventFilter 的后代过滤条件中使用。在 EventFilter 的后代过滤器中,应使用事件参数或商品参数。 商品参数仅适用于电子商务事件。如需详细了解电子商务事件,请参阅衡量电子商务指南。 |
联合字段 one_filter 。指定一种类型的过滤条件。one_filter 只能是下列其中一项: |
|
stringFilter |
与字符串相关的过滤条件。 |
inListFilter |
列表值中的过滤条件。 |
numericFilter |
数字或日期值的过滤条件。 |
betweenFilter |
两个值之间的过滤条件。 |
漏斗细分
细分会在漏斗表格子报告响应中添加一个维度。
JSON 表示法 |
---|
{
"breakdownDimension": {
object ( |
字段 | |
---|---|
breakdownDimension |
添加到漏斗表子报告响应中的维度列。细分维度会细分每个漏斗步骤。如果指定了 |
limit |
在响应中返回的细分维度的不同值数上限。如果未指定限制,则系统会使用 |
尺寸
“维度”是指数据的属性。例如,维度“城市”表示产生事件的城市。报告响应中的维度值是字符串;例如,城市可以是“巴黎”或“纽约”。
JSON 表示法 |
---|
{
"name": string,
"dimensionExpression": {
object ( |
字段 | |
---|---|
name |
维度的名称。如需查看维度名称列表,请参阅 API 维度。 如果指定了 尺寸由 |
dimensionExpression |
一个维度可以是多个维度的表达式的结果。例如,维度“国家/地区,城市”:concatenate(国家/地区, ", 和城市)。 |
DimensionExpression
用于表示一个维度,其结果是包含多个维度的公式的结果。用法示例:1)lowerCase(dimension) 2) concatenate(dimension1, 符号, dimension2)。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 one_expression 。为 DimensionExpression 指定一种维度表达式。one_expression 只能是下列其中一项: |
|
lowerCase |
用于将维度值转换为小写。 |
upperCase |
用于将维度值转换为大写。 |
concatenate |
用于将维度值合并到单个维度。例如,维度“国家/地区,城市”:concatenate(国家/地区, ", 和城市)。 |
案例表达式
用于将维度值转换为单一大小写。
JSON 表示法 |
---|
{ "dimensionName": string } |
字段 | |
---|---|
dimensionName |
维度的名称。名称必须引用该请求的维度字段中的名称。 |
串联表达式
用于将维度值合并到单个维度。
JSON 表示法 |
---|
{ "dimensionNames": [ string ], "delimiter": string } |
字段 | |
---|---|
dimensionNames[] |
维度的名称。名称必须引用到相应请求的维度字段中的名称。 |
delimiter |
维度名称之间的分隔符。 分隔符通常是单个字符,如“|”或“,”,但也可以是更长的字符串。如果维度值包含分隔符,两者都会同时出现且不区分。例如,如果维度 1 值 =“US,FR”、维度 2 值 =“JP”和分隔符 =“&”,则响应会包含“US,FR,JP”。 |
漏斗下一步操作
“下一项操作”会在用户完成一个步骤之后但同一用户还未完成下一步之前说明该维度的值。例如,如果 nextActionDimension
为 eventName
,则第 i
个漏斗步骤行中的 nextActionDimension
将返回符合让用户进入第 i
个漏斗步骤但还未达到第 i+1
个漏斗步骤的事件之前的首个事件。
JSON 表示法 |
---|
{
"nextActionDimension": {
object ( |
字段 | |
---|---|
nextActionDimension |
添加到漏斗可视化图表子报告响应中的维度列。在用户完成第
|
limit |
在响应中返回的细分维度的不同值数上限。如果未指定限制,则系统会使用 |
漏斗可视化类型
控制“渠道可视化”子报告响应中显示的维度。
枚举 | |
---|---|
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED |
未指定类型。 |
STANDARD_FUNNEL |
标准(阶梯式)漏斗。响应中的漏斗可视化子报告将不包含日期。 |
TRENDED_FUNNEL |
一种趋势(折线图)漏斗。响应中的漏斗可视化子报告将包含日期维度。 |
片段
“细分”是指您的一部分 Google Analytics(分析)数据。例如,在您的整个用户群中,您可使用一个细分来指定来自特定国家/地区或城市的用户,您还可以使用另一个细分来指定购买特定产品系列、访问网站上特定部分或触发应用中某些事件的用户。
如需了解详情,请参阅 GA4 细分生成工具。
JSON 表示法 |
---|
{ "name": string, // Union field |
字段 | |
---|---|
name |
此细分受众群的名称。如果未指定,则将细分受众群命名为“细分受众群”。此名称定义了 |
联合字段 one_segment_scope 。在一个范围内指定细分。one_segment_scope 只能是下列其中一项: |
|
userSegment |
细分用户群是指与您的网站或应用进行过互动的用户的子集。 |
sessionSegment |
会话细分是在您的网站或应用上发生的一部分会话。 |
eventSegment |
事件细分是在您的网站或应用上触发的事件子集。 |
用户细分
用户细分是与您的网站或应用进行过互动的部分用户。例如,之前有过购买行为的用户;向购物车添加了商品,但并未完成购买的用户。
JSON 表示法 |
---|
{ "userInclusionCriteria": { object ( |
字段 | |
---|---|
userInclusionCriteria |
定义哪些用户包含在此细分受众群中。可选。 |
exclusion |
定义在此细分中排除哪些用户。可选。 |
用户细分条件
如果用户的事件满足条件中的条件,就会匹配该条件。
JSON 表示法 |
---|
{ "andConditionGroups": [ { object ( |
字段 | |
---|---|
andConditionGroups[] |
如果用户符合所有这些 |
andSequenceGroups[] |
如果用户符合所有这些 |
用户细分条件组
条件用于告知 Google Analytics(分析)要在细分中包含或排除哪些数据。
JSON 表示法 |
---|
{ "conditionScoping": enum ( |
字段 | |
---|---|
conditionScoping |
根据数据是否与条件组匹配,在细分中包含或排除数据。这种范围界定了在确定条件组是否匹配之前, (可选)如果未指定,系统会使用 |
segmentFilterExpression |
根据是否与此表达式匹配,在细分中包含或排除数据。表达式表示对维度、指标和/或参数的条件。 |
用户条件范围
限定范围可指定在评估用户是否符合条件时要考虑哪些事件。
枚举 | |
---|---|
USER_CRITERIA_SCOPING_UNSPECIFIED |
未指定条件范围。请勿指定。 |
USER_CRITERIA_WITHIN_SAME_EVENT |
如果在一个事件中满足条件,用户与该条件匹配。 |
USER_CRITERIA_WITHIN_SAME_SESSION |
如果在一个会话中满足条件,用户便会匹配该条件。 |
USER_CRITERIA_ACROSS_ALL_SESSIONS |
如果用户的任何事件都满足条件,用户就会匹配该条件。 |
SegmentFilter 表达式
表示对细分过滤器的组合。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 expr 。为 SegmentFilterExpression 指定一种类型的过滤器。expr 只能是下列其中一项: |
|
andGroup |
|
orGroup |
|
notExpression |
SegmentFilterExpression 不是 |
segmentFilter |
基本细分过滤器。 |
segmentEventFilter |
创建与单个事件名称的事件匹配的过滤器。如果指定了参数过滤条件表达式,则只有与单个事件名称和参数过滤条件表达式匹配的部分事件与此事件过滤条件匹配。 |
细分过滤条件表达式列表
细分过滤条件表达式列表。
JSON 表示法 |
---|
{
"expressions": [
{
object ( |
字段 | |
---|---|
expressions[] |
细分过滤条件表达式列表 |
SegmentFilter
用于过滤维度或指标值的表达式。
JSON 表示法 |
---|
{ "fieldName": string, "filterScoping": { object ( |
字段 | |
---|---|
fieldName |
维度名称或指标名称。 |
filterScoping |
指定过滤器的范围。 |
联合字段 one_filter 。为 Filter 指定一种类型的过滤器。one_filter 只能是下列其中一项: |
|
stringFilter |
与字符串相关的过滤条件。 |
inListFilter |
列表值中的过滤条件。 |
numericFilter |
数字或日期值的过滤条件。 |
betweenFilter |
两个值之间的过滤条件。 |
细分过滤条件范围
界定范围指定在评估细分过滤器时应如何考虑多个事件的维度与指标。
JSON 表示法 |
---|
{ "atAnyPointInTime": boolean } |
字段 | |
---|---|
atAnyPointInTime |
如果 此 只有在条件范围限定为 如果条件范围限定为 |
SegmentEventFilter
创建与单个事件名称的事件匹配的过滤器。如果指定了参数过滤条件表达式,则只有与单个事件名称和参数过滤条件表达式匹配的部分事件与此事件过滤条件匹配。
JSON 表示法 |
---|
{
"eventName": string,
"segmentParameterFilterExpression": {
object ( |
字段 | |
---|---|
eventName |
此过滤条件与这个事件名称中的事件相匹配。事件名称为必填项。 |
segmentParameterFilterExpression |
如果指定,此过滤条件将匹配与单个事件名称和参数过滤条件表达式匹配的事件。 在参数过滤条件表达式内,只有参数过滤条件可用。 |
SegmentParameterFilter 表达式
表示对参数的细分过滤条件组合。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 expr 。为 SegmentParameterFilterExpression 指定一种类型的过滤器。expr 只能是下列其中一项: |
|
andGroup |
|
orGroup |
|
notExpression |
SegmentParameterFilterExpression 不是 |
segmentParameterFilter |
基本细分参数过滤条件。 |
SegmentParameterFilterExpressionList
细分参数过滤条件表达式列表。
JSON 表示法 |
---|
{
"expressions": [
{
object ( |
字段 | |
---|---|
expressions[] |
细分参数过滤条件表达式列表。 |
SegmentParameterFilter
用于过滤细分中的参数值的表达式。
JSON 表示法 |
---|
{ "filterScoping": { object ( |
字段 | |
---|---|
filterScoping |
指定过滤器的范围。 |
联合字段 one_parameter 。要过滤的字段。one_parameter 只能是下列其中一项: |
|
eventParameterName |
系统将根据指定的事件参数评估此过滤条件。事件参数会记录为事件的参数。事件参数包括 &firebaseotscreen" & "currency" 等字段。 事件参数只能在细分和漏斗中使用,并且只能在 EventFilter 的后代过滤器中使用。在 EventFilter 的后代过滤器中,应使用事件参数或商品参数。 |
itemParameterName |
系统将根据指定的 item 参数评估此过滤条件。系统会将 item 参数记录为 item 数组中的参数。商品参数包含 "item_name" & "item_category"> 等字段。 Item 参数只能在细分和漏斗中使用,并且只能在 EventFilter 的后代过滤条件中使用。在 EventFilter 的后代过滤器中,应使用事件参数或商品参数。 商品参数仅适用于电子商务事件。如需详细了解电子商务事件,请参阅衡量电子商务指南。 |
联合字段 one_filter 。指定一种类型的过滤条件。one_filter 只能是下列其中一项: |
|
stringFilter |
与字符串相关的过滤条件。 |
inListFilter |
列表值中的过滤条件。 |
numericFilter |
数字或日期值的过滤条件。 |
betweenFilter |
两个值之间的过滤条件。 |
SegmentParameterFilterScoping
限定范围用于指定在评估细分参数过滤条件时应考虑多个事件。
JSON 表示法 |
---|
{ "inAnyNDayPeriod": string } |
字段 | |
---|---|
inAnyNDayPeriod |
应用过滤器之前,在指定天数内累积参数。仅在范围限定为 例如,如果 日期范围不会延长,以便在日期范围即将开始之际留出完整的 N 天时间范围。例如,如果报表针对 2021-11-01 至 2021-11-10,且
|
用户细分序列组
以特定顺序定义用户必须是细分受众群成员的条件。
JSON 表示法 |
---|
{ "sequenceScoping": enum ( |
字段 | |
---|---|
sequenceScoping |
必须在作用域内满足所有序列步骤,才能使用户序列匹配。例如,如果为 (可选)如果未指定,系统会使用 |
sequenceMaximumDuration |
指定整个序列必须在多长时间内完成,例如 30 分钟。
此时长以秒为单位,最多包含九个小数位,以 ' |
userSequenceSteps[] |
条件步骤的有序序列。用户的事件必须完成每个步骤,用户才会与 |
用户序列步骤
必须按指定步骤顺序执行的条件,用户才能与序列匹配。
JSON 表示法 |
---|
{ "isDirectlyFollowedBy": boolean, "stepScoping": enum ( |
字段 | |
---|---|
isDirectlyFollowedBy |
如果为 true,则满足此步骤的事件必须是在满足最后一个步骤之后的下一个事件。如果为 false,则此步骤会间接后跟上一步;例如,上一步和此步骤之间可能存在事件。第一步的 |
stepScoping |
必须在范围限定中满足此序列步骤,才能使用户序列匹配。例如,如果为 (可选)如果未指定, |
segmentFilterExpression |
如果用户的事件与此表达式步骤匹配,则与其匹配。表达式表示对维度、指标和/或参数的条件。 |
用户细分排除
指定要在此细分中排除的用户。
JSON 表示法 |
---|
{ "userExclusionDuration": enum ( |
字段 | |
---|---|
userExclusionDuration |
指定当用户与 (可选)如果未指定,系统会使用 |
userExclusionCriteria |
如果用户满足此条件,该用户就会从“ |
用户排除时长
枚举排除时长与 userExclusionCriteria
匹配的用户选项。
枚举 | |
---|---|
USER_EXCLUSION_DURATION_UNSPECIFIED |
未指定的排除时长。请勿指定。 |
USER_EXCLUSION_TEMPORARY |
在用户满足 userExclusionCriteria 条件期间暂时将用户排除在细分受众群之外。 |
USER_EXCLUSION_PERMANENT |
如果用户满足 userExclusionCriteria 条件,则将用户从细分中永久排除。 |
会话细分
会话细分是在您的网站或应用上发生的一部分会话,例如:源自特定广告系列的所有会话。
JSON 表示法 |
---|
{ "sessionInclusionCriteria": { object ( |
字段 | |
---|---|
sessionInclusionCriteria |
定义此细分中包含哪些会话。可选。 |
exclusion |
定义此细分中排除了哪些会话。可选。 |
SessionSegmentCriteria
如果某个会话的事件满足条件中的条件,那么此会话就会匹配该条件。
JSON 表示法 |
---|
{
"andConditionGroups": [
{
object ( |
字段 | |
---|---|
andConditionGroups[] |
如果某个会话与上述每一个 |
SessionSegmentConditionGroup
条件用于告知 Google Analytics(分析)要在细分中包含或排除哪些数据。
JSON 表示法 |
---|
{ "conditionScoping": enum ( |
字段 | |
---|---|
conditionScoping |
根据数据是否与条件组匹配,在细分中包含或排除数据。这种范围界定了在确定条件组是否匹配之前, (可选)如果未指定,系统会使用 |
segmentFilterExpression |
根据是否与此表达式匹配,在细分中包含或排除数据。表达式表示对维度、指标和/或参数的条件。 |
SessionCriteriaScoping
界定范围指定评估会话是否符合条件时要考虑哪些事件。
枚举 | |
---|---|
SESSION_CRITERIA_SCOPING_UNSPECIFIED |
未指定条件范围。请勿指定。 |
SESSION_CRITERIA_WITHIN_SAME_EVENT |
如果在一个事件内满足条件,会话将与该条件匹配。 |
SESSION_CRITERIA_WITHIN_SAME_SESSION |
如果在一个会话中满足条件,则该会话与条件匹配。 |
SessionSegmentExclusion
指定要在此细分中排除的会话。
JSON 表示法 |
---|
{ "sessionExclusionDuration": enum ( |
字段 | |
---|---|
sessionExclusionDuration |
指定会话持续与 (可选)如果未指定,系统会使用 |
sessionExclusionCriteria |
如果某个会话满足此条件,该会话将不会是 |
会话排除时长
枚举在会话与 sessionExclusionCriteria
匹配的情况下将排除对象持续多长时间的选项。
枚举 | |
---|---|
SESSION_EXCLUSION_DURATION_UNSPECIFIED |
未指定的排除时长。请勿指定。 |
SESSION_EXCLUSION_TEMPORARY |
在会话满足 sessionExclusionCriteria 条件期间暂时从细分中排除会话。 |
SESSION_EXCLUSION_PERMANENT |
如果会话曾满足 sessionExclusionCriteria 条件,则会从细分中永久排除会话。 |
事件细分
事件细分是在您的网站或应用上触发的事件子集,例如,在特定位置发生的所有购买事件;在特定操作系统上发生的 app_exception 事件。
JSON 表示法 |
---|
{ "eventInclusionCriteria": { object ( |
字段 | |
---|---|
eventInclusionCriteria |
定义此细分中包含哪些事件。可选。 |
exclusion |
定义在此细分中排除哪些事件。可选。 |
EventSegmentCriteria
如果事件满足条件中的条件,则该事件与条件匹配。
JSON 表示法 |
---|
{
"andConditionGroups": [
{
object ( |
字段 | |
---|---|
andConditionGroups[] |
如果某个事件与所有这些 |
EventSegmentConditionGroup
条件用于告知 Google Analytics(分析)要在细分中包含或排除哪些数据。
JSON 表示法 |
---|
{ "conditionScoping": enum ( |
字段 | |
---|---|
conditionScoping |
(可选)如果未指定,系统会使用 |
segmentFilterExpression |
根据是否与此表达式匹配,在细分中包含或排除数据。表达式表示对维度、指标和/或参数的条件。 |
EventCriteriaScoping
限定范围可指定在评估事件是否符合条件时要考虑哪些事件。
枚举 | |
---|---|
EVENT_CRITERIA_SCOPING_UNSPECIFIED |
未指定条件范围。请勿指定。 |
EVENT_CRITERIA_WITHIN_SAME_EVENT |
如果一个事件满足条件,该事件就会匹配该条件。 |
EventSegmentExclusion
指定要在此细分中排除哪些事件。
JSON 表示法 |
---|
{ "eventExclusionDuration": enum ( |
字段 | |
---|---|
eventExclusionDuration |
(可选)如果未指定,系统会使用 |
eventExclusionCriteria |
如果某个事件满足此条件,系统会从 |
事件排除时长
枚举在事件与 eventExclusionCriteria
匹配时排除项将持续的时间选项。
枚举 | |
---|---|
EVENT_EXCLUSION_DURATION_UNSPECIFIED |
未指定的排除时长。请勿指定。 |
EVENT_EXCLUSION_PERMANENT |
如果事件曾经满足 eventExclusionCriteria 条件,则会从细分中永久排除事件。 |
FilterExpression
表示维度或指标过滤条件。同一 FilterExpression 中的字段需要是所有维度或所有指标。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 expr 。为 FilterExpression 指定一种类型的过滤条件表达式。expr 只能是下列其中一项: |
|
andGroup |
andGroup 中的 FilterExpression 具有 AND 关系。 |
orGroup |
OrGroup 中的 FilterExpression 具有 OR 关系。 |
notExpression |
Filter 表达式不是 NOT 表达式。 |
filter |
基本过滤条件。在同一过滤条件表达式中,过滤条件的所有字段名称都必须是所有维度或所有指标。 |
FilterExpressionList
过滤条件表达式列表。
JSON 表示法 |
---|
{
"expressions": [
{
object ( |
字段 | |
---|---|
expressions[] |
过滤条件表达式列表。 |
过滤
用于过滤维度或指标值的表达式。
JSON 表示法 |
---|
{ "fieldName": string, // Union field |
字段 | |
---|---|
fieldName |
维度名称或指标名称。必须是维度或指标中定义的名称。 |
联合字段 one_filter 。为 Filter 指定一种类型的过滤器。one_filter 只能是下列其中一项: |
|
stringFilter |
与字符串相关的过滤条件。 |
inListFilter |
列表值中的过滤条件。 |
numericFilter |
数字或日期值的过滤条件。 |
betweenFilter |
两个值之间的过滤条件。 |
漏斗子报告
漏斗子报告包含维度和指标数据值。例如,12 位用户到达了漏斗的第二个步骤。
JSON 表示法 |
---|
{ "dimensionHeaders": [ { object ( |
字段 | |
---|---|
dimensionHeaders[] |
描述维度列。漏斗报告始终在子报告响应中包含漏斗步骤维度。若有请求,响应中可能会显示细分、日期和后续操作等其他维度。 |
metricHeaders[] |
描述指标列。漏斗报告始终在子报告响应中包括活跃用户。漏斗表包含其他指标,例如完成率、放弃率和放弃率。 |
rows[] |
报告中维度值组合和指标值的行。 |
metadata |
漏斗报告的元数据。 |
DimensionHeader
说明报告中的维度列。报告中请求的维度会在行和 DimensionHeaders 内生成列条目。但是,仅在过滤器或表达式中使用的维度不会在报表中生成列;因此,这些维度不会生成标题。
JSON 表示法 |
---|
{ "name": string } |
字段 | |
---|---|
name |
维度的名称。 |
MetricHeader
描述报告中的指标列。报告中请求的可见指标会在各行和 MetricHeaders 中生成列条目。但是,仅在过滤器或表达式中使用的指标不会在报表中生成列;因此,这些指标不会生成标题。
JSON 表示法 |
---|
{
"name": string,
"type": enum ( |
字段 | |
---|---|
name |
指标的名称。 |
type |
指标的数据类型。 |
MetricType
指标的值类型。
枚举 | |
---|---|
METRIC_TYPE_UNSPECIFIED |
未指定类型。 |
TYPE_INTEGER |
整数类型。 |
TYPE_FLOAT |
浮点类型。 |
TYPE_SECONDS |
秒数;特殊浮点类型。 |
TYPE_MILLISECONDS |
以毫秒为单位的持续时间;一种特殊的浮点类型。 |
TYPE_MINUTES |
持续时间(以分钟为单位);一种特殊的浮点类型。 |
TYPE_HOURS |
时长(以小时为单位);一种特殊的浮点类型。 |
TYPE_STANDARD |
标准类型的自定义指标;特殊的浮点类型。 |
TYPE_CURRENCY |
金额;一种特殊的浮点类型。 |
TYPE_FEET |
以英尺为单位的长度;特殊的浮点类型。 |
TYPE_MILES |
长度(以英里为单位);一种特殊的浮点类型。 |
TYPE_METERS |
一个以米为单位的长度;一种特殊的浮点类型。 |
TYPE_KILOMETERS |
以公里为单位的长度;特殊的浮点类型。 |
行
每一行的报告数据。例如,如果 RunReportRequest 包含以下内容:
"dimensions": [
{
"name": "eventName"
},
{
"name": "countryId"
}
],
"metrics": [
{
"name": "eventCount"
}
]
一行代码为 'in_app_purchase' 作为 eventName,'JP' 作为 countryId,15 作为 eventCount,则:
"dimensionValues": [
{
"value": "in_app_purchase"
},
{
"value": "JP"
}
],
"metricValues": [
{
"value": "15"
}
]
JSON 表示法 |
---|
{ "dimensionValues": [ { object ( |
字段 | |
---|---|
dimensionValues[] |
请求的维度值列表。在 PivotReport 中,系统只会针对数据透视中包含的维度列出维度值。 |
metricValues[] |
所请求的可见指标值的列表。 |
DimensionValue
维度的值。
JSON 表示法 |
---|
{ "value": string } |
字段 | |
---|---|
value |
如果维度类型是字符串,则为字符串值。 |
MetricValue
指标的值。
JSON 表示法 |
---|
{ "value": string } |
字段 | |
---|---|
value |
测量值。如需了解类型,请参阅 MetricHeader。 |
漏斗响应元数据
漏斗报告的响应元数据中包含有关漏斗报告的其他信息。
JSON 表示法 |
---|
{
"samplingMetadatas": [
{
object ( |
字段 | |
---|---|
samplingMetadatas[] |
如果对漏斗报告结果进行抽样,则表示此漏斗报告中所用的事件所占百分比。系统会为每个日期范围填充一个 但如果未对结果进行抽样,则不会定义此字段。 |
抽样元数据
如果对漏斗报告结果进行抽样,此元数据可描述该日期范围内此漏斗报告中所用的事件所占百分比。抽样是指分析所有数据的子集,以发现较大数据集中的有意义的信息。
JSON 表示法 |
---|
{ "samplesReadCount": string, "samplingSpaceSize": string } |
字段 | |
---|---|
samplesReadCount |
此抽样报告中针对某一日期范围内读取的事件总数。这是此漏斗报告中分析的此媒体资源的数据大小。 |
samplingSpaceSize |
此漏斗报告中针对某个日期范围的媒体资源中的数据可能进行分析的事件总数。抽样揭示的是有关较大数据集的有意义的信息,这就是较大数据集的大小。 要计算此漏斗报告中使用的可用数据所占的百分比,请计算 |
PropertyQuota
此 Google Analytics(分析)媒体资源的所有配额的当前状态。如果资源有任何配额已用尽,则向该资源发出的所有请求都将返回“资源用尽”错误。
JSON 表示法 |
---|
{ "tokensPerDay": { object ( |
字段 | |
---|---|
tokensPerDay |
标准 Analytics 媒体资源每天最多可以使用 25000 个令牌;Analytics 360 媒体资源每天最多可以使用 250000 个令牌。大部分请求消耗的令牌数都少于 10 个。 |
tokensPerHour |
标准 Analytics 媒体资源每小时最多可以使用 5000 个令牌;Analytics 360 媒体资源每小时最多可以使用 50000 个令牌。API 请求消耗单个令牌,并且该数字将从所有每小时、每日和每个项目每小时配额中扣除。 |
concurrentRequests |
标准 Analytics(分析)媒体资源最多可以发送 10 个并发请求;Analytics 360 媒体资源最多可以使用 50 个并发请求。 |
serverErrorsPerProjectPerHour |
标准 Google Analytics(分析)媒体资源和云项目对每小时最多可以出现 10 个服务器错误;Analytics 360 媒体资源和云项目对每小时最多可以出现 50 个服务器错误。 |
potentiallyThresholdedRequestsPerHour |
Google Analytics(分析)媒体资源每小时最多可以发送 120 个请求,其中可能会包含阈值阈值。在批量请求中,如果请求包含可能达到阈值的维度,则系统会针对该请求分别计算每个报告请求。 |
tokensPerProjectPerHour |
Google Analytics(分析)媒体资源每小时最多可以使用 25% 的令牌。标准 Analytics(分析)媒体资源每小时最多可以使用 1250 个令牌,Analytics 360 媒体资源每小时最多可以使用 12500 个令牌。API 请求消耗单个令牌,并且该数字将从所有每小时、每日和每个项目每小时配额中扣除。 |
QuotaStatus
特定配额组的当前状态。
JSON 表示法 |
---|
{ "consumed": integer, "remaining": integer } |
字段 | |
---|---|
consumed |
此请求消耗的配额。 |
remaining |
此请求后剩余配额。 |