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 de relatórios são strings. Por exemplo, a cidade pode ser "Paris" ou "New 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 as dimensões da API para ver a lista de nomes de dimensões compatíveis com métodos de relatórios principais, 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 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, 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(dimensão) 2) concatenate(dimensão1, símbolo, dimensão2).

Representação JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of mutually exclusive fields.
}
Campos
Especifique um tipo de expressão de dimensão para DimensionExpression. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
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 letras maiúsculas.

concatenate

object (ConcatenateExpression)

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

Fim dos campos mutuamente exclusivos.

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 "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 "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 contiver 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 for ",", a resposta vai conter "US,FR,JP".