Dimension

Wymiary to atrybuty danych. Na przykład wymiar Miasto wskazuje miasto, z którego pochodzi zdarzenie. Wartości wymiarów w odpowiedziach w raporcie są ciągami tekstowymi, np. miastem może być „Paryż” lub „Nowy Jork”. Żądania może zawierać maksymalnie 9 wymiarów.

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

string

Nazwa wymiaru. Listę nazw wymiarów obsługiwanych przez podstawowe metody raportowania, np. runReport czy batchRunReports, znajdziesz w sekcji Wymiary interfejsu API. Listę 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 sekcji Wymiary ścieżki.

Jeśli określono dimensionExpression, name może być dowolnym ciągiem znaków z dozwolonego zestawu znaków. Jeśli np. zmienna 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 powiązane z wymiarami: name (dimensionFilter, orderBys, dimensionExpression i pivots).

dimensionExpression

object (DimensionExpression)

Jeden wymiar może być wynikiem wyrażenia wielu wymiarów. Na przykład wymiar „kraj, miasto”: concatenate(kraj, ", ", miasto).

DimensionExpression

Służy do wyrażenia wymiaru, który jest wynikiem formuły złożonej z wielu wymiarów. Przykładowe zastosowania: 1) LowCase(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 jeden typ wyrażenia wymiaru dla funkcji DimensionExpression. one_expression może być tylko jedną z tych wartości:
lowerCase

object (CaseExpression)

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

upperCase

object (CaseExpression)

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

concatenate

object (ConcatenateExpression)

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

CaseExpression

Służy do konwertowania wartości wymiaru na jeden przypadek.

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ą się odwoływać do nazw podanych w polu wymiarów żądania.

delimiter

string

Separator umieszczony między nazwami wymiarów.

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