Dimension

“维度”是指数据的属性。例如,“城市”维度表示的是事件发起城市。报告响应中的维度值是字符串;例如,城市可以是“Paris”或“New York”。请求最多允许使用 9 个维度。

JSON 表示法
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
字段
name

string

维度的名称。如需查看核心报告方法(例如 runReportbatchRunReports)支持的维度名称列表,请参阅 API 维度。如需查看 runRealtimeReport 方法支持的维度名称列表,请参阅“实时维度”。如需查看 runFunnelReport 方法支持的维度名称列表,请参阅漏斗维度

如果指定了 dimensionExpression,则 name 可以是您希望在允许的字符集中使用的任意字符串。例如,如果 dimensionExpressioncountrycity 串联在一起,您可以调用该维度 countryAndCity。您选择的维度名称必须与正则表达式 ^[a-zA-Z0-9_]$ 匹配。

维度由 dimensionFilterorderBysdimensionExpressionpivots 中的 name 引用。

dimensionExpression

object (DimensionExpression)

一个维度可以是多个维度的表达式的结果。例如,维度“国家/地区, 城市”:concatenate(country, ", ", city)。

DimensionExpression

用于表示一个维度,该维度是多重维度的公式结果。用法示例:1)LowerCase(dimension) 2) concatenate(dimension1, characters, dimension2)。

JSON 表示法
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
字段
联合字段 one_expression。为 DimensionExpression 指定一种类型的维度表达式。one_expression 只能是下列其中一项:
lowerCase

object (CaseExpression)

用于将维度值转换为小写。

upperCase

object (CaseExpression)

用于将尺寸值转换为大写。

concatenate

object (ConcatenateExpression)

用于将多个维度值合并为一个维度。例如,维度“国家/地区, 城市”:concatenate(country, ", ", city)。

CaseExpression

用于将维度值转换为单个 case。

JSON 表示法
{
  "dimensionName": string
}
字段
dimensionName

string

维度名称。该名称必须回指请求的维度字段中的名称。

ConcatenateExpression

用于将多个维度值合并为一个维度。

JSON 表示法
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
字段
dimensionNames[]

string

维度的名称。这些名称必须回指请求的维度字段中的名称。

delimiter

string

维度名称之间的分隔符。

分隔符通常是单个字符,例如“|”或“,”,但也可以是较长的字符串。如果某个维度值包含分隔符,则响应中都会包含这两个分隔符,不会区分开来。例如,如果维度 1 的值 =“US,FR”,维度 2 的值 =“JP”,且分隔符 =“,”,则响应将包含“US,FR,JP”。