Dimension

Wymiary to atrybuty danych. Na przykład wymiar Miasto wskazuje miasto, z którego pochodzi zdarzenie. Wartości wymiarów w odpowiedziach na raporty są ciągami znaków. na przykład miasto może być „Paryż” czy „Nowy Jork”. Dozwolonych jest maksymalnie 9 wymiarów.

Zapis JSON
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Pola
name

string

Nazwa wymiaru. Listę wymiarów obsługiwanych przez podstawowe metody raportowania, np. runReport i batchRunReports, znajdziesz w artykule Wymiary interfejsu API. Lista nazw wymiarów obsługiwanych przez metodę runRealtimeReport znajdziesz w artykule Wymiary w czasie rzeczywistym. Listę nazw wymiarów obsługiwanych przez metodę runFunnelReport znajdziesz w artykule Wymiary ścieżki.

Jeśli parametr dimensionExpression jest określony, name może być dowolnym ciągiem znaków z zakresu dozwolonego zestawu. Jeśli np. wymiar dimensionExpression łączy elementy country i city, możesz nazwać ten wymiar countryAndCity. Wybrane nazwy wymiarów muszą być zgodne z wyrażeniem regularnym ^[a-zA-Z0-9_]$.

Wymiary są przywoływane przez atrybut name w atrybutach dimensionFilter, orderBys, dimensionExpression i pivots.

dimensionExpression

object (DimensionExpression)

Jeden wymiar może być wynikiem wyrażenia obejmującego kilka wymiarów. np. wymiar „kraj, miasto”: konkatenat(kraj, ", ", miasto).

DimensionExpression

Służy do wyrażenia wymiaru, który jest wynikiem formuły obejmującej kilka wymiarów. Przykładowe zastosowania: 1) małe litery(wymiar) 2) konkatenacja(wymiar1, symbol, wymiar2).

Zapis 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.
}
Pola
Pole sumy one_expression. Określ 1 typ wyrażenia wymiaru na potrzeby elementu DimensionExpression. one_expression może mieć tylko jedną z tych wartości:
lowerCase

object (CaseExpression)

Służy do konwertowania wartości wymiaru na małe litery.

upperCase

object (CaseExpression)

Służy do konwertowania wartości wymiaru na wielkie litery.

concatenate

object (ConcatenateExpression)

Służy do łączenia wartości wymiarów w jeden wymiar. np. wymiar „kraj, miasto”: konkatenat(kraj, ", ", miasto).

CaseExpression

Służy do konwertowania wartości wymiaru na pojedynczą wielkość liter.

Zapis JSON
{
  "dimensionName": string
}
Pola
dimensionName

string

Nazwa wymiaru. Nazwa musi odnosić się do nazwy w polu wymiarów żądania.

ConcatenateExpression

Służy do łączenia wartości wymiarów w jeden wymiar.

Zapis JSON
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Pola
dimensionNames[]

string

Nazwy wymiarów. Nazwy muszą odnosić się do nazw podanych w polu wymiarów w żądaniu.

delimiter

string

Separator umieszczony między nazwami wymiarów.

Ograniczniki to często pojedyncze znaki, np. „|” lub „,” ale mogą też być dłuższe. Jeśli wartość wymiaru zawiera separator, obie występują w odpowiedzi bez rozróżniania. Jeśli np. wartość wymiaru 1 to „PL,FR”, wymiar 2 = „JP”, a separator = „,”, odpowiedź będzie zawierać te ciągi „US,FR,JP”.