Dimension

As dimensões são atributos dos seus dados. Por exemplo, a dimensão "Cidade" indica a cidade de origem de um evento. Os valores de dimensão nas respostas do relatório são strings. Por exemplo, a cidade pode ser "Paris" ou "Nova York". As solicitações podem ter até nove dimensões.

Representação JSON
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Campos
name

string

O nome da dimensão. Consulte Dimensões da API para conferir a lista de nomes de dimensões aceitos pelos métodos de relatórios principais, como runReport e batchRunReports. Consulte Dimensões em tempo real para conferir a lista de nomes de dimensões compatíveis com o método runRealtimeReport. Consulte Dimensões do funil para ver a lista de nomes de dimensões aceitos pelo método runFunnelReport.

Se dimensionExpression for especificado, name poderá ser qualquer string dentro do conjunto de caracteres permitido. Por exemplo, se um dimensionExpression concatenar country e city, você poderá chamar essa dimensão de countryAndCity. Os nomes de dimensão escolhidos precisam corresponder à expressão regular ^[a-zA-Z0-9_]$.

As dimensões são referenciadas por name em dimensionFilter, orderBys, dimensionExpression e pivots.

dimensionExpression

object (DimensionExpression)

Uma dimensão pode ser o resultado de uma expressão de várias dimensões. Por exemplo, a dimensão "país, cidade": concatenate(country, ", ", city).

DimensionExpression

Usado para expressar uma dimensão que é o resultado de uma fórmula de várias dimensões. Exemplos de uso: 1) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2).

Representação 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.
}
Campos
Campo de união one_expression. Especifique um tipo de expressão de dimensão para DimensionExpression. one_expression pode ser apenas de um dos tipos a seguir:
lowerCase

object (CaseExpression)

Usado para converter um valor de dimensão em letras minúsculas.

upperCase

object (CaseExpression)

Usado para converter um valor de dimensão em maiúsculas.

concatenate

object (ConcatenateExpression)

Usado para combinar valores de dimensão em uma única dimensão. Por exemplo, a dimensão "país, cidade": concatenate(country, ", ", city).

CaseExpression

Usado para converter um valor de dimensão em um único caso.

Representação JSON
{
  "dimensionName": string
}
Campos
dimensionName

string

Nome de uma dimensão. O nome precisa se referir a um nome no campo de dimensões da solicitação.

ConcatenateExpression

Usado para combinar valores de dimensão em uma única dimensão.

Representação JSON
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Campos
dimensionNames[]

string

Nomes das dimensões. Os nomes precisam se referir aos nomes no campo de dimensões da solicitação.

delimiter

string

O delimitador colocado entre os nomes das dimensões.

Os delimitadores geralmente são caracteres únicos, como "|" ou ",", mas podem ser strings mais longas. Se um valor de dimensão tiver o delimitador, ambos vão estar presentes na resposta sem distinção. Por exemplo,se o valor da dimensão 1 for "US,FR", o valor da dimensão 2 for "JP" e o delimitador for ",", a resposta conterá "US,FR,JP".