Dimension

Dimensionen sind Attribute Ihrer Daten. Die Dimension „Stadt“ gibt beispielsweise die Stadt an, von der ein Ereignis ausgeht. Dimensionswerte in Berichtsantworten sind Strings. z. B. „Paris“. oder "New York". Anfragen sind bis zu neun Dimensionen zulässig.

JSON-Darstellung
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Felder
name

string

Der Name der Dimension. Unter API-Dimensionen finden Sie eine Liste der Dimensionsnamen, die von zentralen Berichtsmethoden wie runReport und batchRunReports unterstützt werden. Eine Liste der von der Methode runRealtimeReport unterstützten Dimensionsnamen finden Sie unter Echtzeitdimensionen. Eine Liste der von der Methode runFunnelReport unterstützten Dimensionsnamen finden Sie unter Trichterdimensionen.

Wenn dimensionExpression angegeben ist, kann name ein beliebiger String innerhalb des zulässigen Zeichensatzes sein. Wenn beispielsweise eine dimensionExpression country und city verkettet, können Sie diese Dimension countryAndCity nennen. Die von Ihnen ausgewählten Dimensionsnamen müssen dem regulären Ausdruck ^[a-zA-Z0-9_]$ entsprechen.

name verweist in dimensionFilter, orderBys, dimensionExpression und pivots auf die Dimensionen.

dimensionExpression

object (DimensionExpression)

Eine Dimension kann das Ergebnis eines Ausdrucks mit mehreren Dimensionen sein. Beispiel: Dimension „Land, Stadt“: concatenate(country, ", ", city).

DimensionExpression

Hiermit wird eine Dimension ausgedrückt, die das Ergebnis einer Formel mit mehreren Dimensionen ist. Anwendungsbeispiele: 1) lessCase(Dimension) 2) concatenate(Dimension1, Symbol, Dimension2).

JSON-Darstellung
{

  // 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.
}
Felder
Union-Feld one_expression. Geben Sie einen Typ von Dimensionsausdruck für DimensionExpression an. Für one_expression ist nur einer der folgenden Werte zulässig:
lowerCase

object (CaseExpression)

Wird verwendet, um einen Dimensionswert in Kleinbuchstaben umzuwandeln.

upperCase

object (CaseExpression)

Wird verwendet, um einen Dimensionswert in Großbuchstaben umzuwandeln.

concatenate

object (ConcatenateExpression)

Wird verwendet, um Dimensionswerte zu einer einzelnen Dimension zu kombinieren. Beispiel: Dimension „Land, Stadt“: concatenate(country, ", ", city).

CaseExpression

Wird verwendet, um einen Dimensionswert in einen Einzelfall umzuwandeln.

JSON-Darstellung
{
  "dimensionName": string
}
Felder
dimensionName

string

Name einer Dimension. Der Name muss sich auf einen Namen im Dimensionsfeld der Anfrage beziehen.

ConcatenateExpression

Wird verwendet, um Dimensionswerte zu einer einzelnen Dimension zu kombinieren.

JSON-Darstellung
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Felder
dimensionNames[]

string

Namen der Dimensionen. Die Namen müssen auf Namen im Dimensionsfeld der Anfrage verweisen.

delimiter

string

Das Trennzeichen zwischen Dimensionsnamen.

Trennzeichen bestehen oft aus einzelnen Zeichen wie „|“ oder "," können aber auch längere Zeichenfolgen sein. Wenn ein Dimensionswert das Trennzeichen enthält, sind beide unverändert in der Antwort vorhanden. Beispiel: Wert für Dimension 1 = „US,FR“, Wert für Dimension 2 = „JP“ und Trennzeichen = „,“, dann enthält die Antwort „US,FR,JP“.