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 poderia 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

Nome da dimensão. Consulte as Dimensões da API para ver a lista de nomes de dimensões compatíveis com os principais métodos de geração de relatórios, como runReport e batchRunReports. Consulte Dimensões em tempo real para ver 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 compatíveis com o método runFunnelReport.

Se dimensionExpression for especificado, name poderá ser qualquer string que você quiser dentro do conjunto de caracteres permitidos. Por exemplo, se um dimensionExpression concatenar country e city, essa dimensão poderá ser chamada de countryAndCity. Os nomes de dimensões 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, dimensão "country, city": 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 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 a uma única dimensão. Por exemplo, dimensão "country, city": 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 deve se referir a um nome no campo de dimensões da solicitação.

ConcatenateExpression

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

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

string

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

delimiter

string

O delimitador colocado entre os nomes da dimensão.

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 estarão 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 = ", a resposta vai conter "US,FR,JP".