Dimension

Dimensionen sind Attribute Ihrer Daten. Die Dimension „Stadt“ gibt beispielsweise den Ort an, von dem aus das Ereignis stammt. Dimensionswerte in Berichtsantworten sind Strings. Die Stadt könnte z. B. „Paris“ oder „New York“ sein. Anfragen sind mit 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 Dimensionsnamen, die von der runRealtimeReport-Methode unterstützt werden, finden Sie unter Echtzeitdimensionen. Eine Liste der Dimensionsnamen, die von der runFunnelReport-Methode unterstützt werden, 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önnten Sie diese Dimension countryAndCity nennen. Die ausgewählten Dimensionsnamen müssen mit dem regulären Ausdruck ^[a-zA-Z0-9_]$ übereinstimmen.

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

dimensionExpression

object (DimensionExpression)

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

DimensionExpression

Damit wird eine Dimension ausgedrückt, die das Ergebnis einer Formel mit mehreren 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: Dimension „Land, Stadt“: verketten(Land, ", ", Stadt).

CaseExpression

Damit wird ein Dimensionswert in Groß- und Kleinschreibung umgewandelt.

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 der Dimensionen. Die Namen müssen sich auf die Namen im Dimensionsfeld der Anfrage beziehen.

delimiter

string

Trennzeichen zwischen Dimensionsnamen

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