Dimension

Dimensionen sind Attribute Ihrer Daten. Die Dimension „Stadt“ gibt beispielsweise den Ort an, von dem das Ereignis ausgeht. Dimensionswerte in Berichtsantworten sind Strings. So könnte die Stadt „Paris“ oder „New York“ sein. Für 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 wichtigen Berichtsmethoden wie runReport und batchRunReports unterstützt werden. Eine Liste der von der runRealtimeReport-Methode unterstützten Dimensionsnamen finden Sie unter Echtzeitdimensionen. Eine Liste der von der runFunnelReport-Methode unterstützten Dimensionsnamen finden Sie unter Trichterdimensionen.

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

In dimensionFilter, orderBys, dimensionExpression und pivots wird von name auf die Dimensionen verwiesen.

dimensionExpression

object (DimensionExpression)

Eine Dimension kann das Ergebnis eines Ausdrucks mehrerer Dimensionen sein. Beispiel: Die Dimension „Land, Stadt“: verketten(Land, ", ", Stadt).

DimensionExpression

Damit wird eine Dimension ausgedrückt, die das Ergebnis einer Formel mehrerer Dimensionen ist. Anwendungsbeispiele: 1) Kleinbuchstaben(Dimension) 2) Verketten(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 eine Art von Dimensionsausdruck für DimensionExpression an. Für one_expression ist nur einer der folgenden Werte zulässig:
lowerCase

object (CaseExpression)

Damit wird ein Dimensionswert in Kleinbuchstaben umgewandelt.

upperCase

object (CaseExpression)

Damit wird ein Dimensionswert in Großbuchstaben umgewandelt.

concatenate

object (ConcatenateExpression)

Damit werden Dimensionswerte zu einer einzelnen Dimension kombiniert. Beispiel: Die Dimension „Land, Stadt“: verketten(Land, ", ", Stadt).

CaseExpression

Damit wird ein Dimensionswert in einen einzelnen Fall konvertiert.

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

string

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

ConcatenateExpression

Damit werden Dimensionswerte zu einer einzelnen Dimension kombiniert.

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

string

Namen von Dimensionen. Die Namen müssen sich auf die Namen im Dimensionsfeld der Anfrage beziehen.

delimiter

string

Das Trennzeichen zwischen den Dimensionsnamen.

Trennzeichen sind häufig einzelne Zeichen wie „|“ oder „“, können aber auch längere Strings sein. Wenn ein Dimensionswert das Trennzeichen enthält, werden beide als Antwort ohne Unterscheidung angezeigt. Beispiel: Wenn der Wert der Dimension 1 „US,FR“, der Wert der Dimension 2 „JP“ und das Trennzeichen „,“ ist, enthält die Antwort „US,FR,JP“.