Dimension

Dimensionen sind Attribute Ihrer Daten. So gibt die Dimension „Stadt“ beispielsweise den Ort an, von dem ein Ereignis stammt. Dimensionswerte in Berichtsantworten sind Strings, z. B. „Berlin“ oder „München“. Anfragen sind mit bis zu 9 Dimensionen zulässig.

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

string

Der Name der Dimension. Eine Liste der von den wichtigsten Berichtsmethoden wie runReport und batchRunReports unterstützten Dimensionsnamen finden Sie unter API-Dimensionen. Eine Liste der von der Methode runRealtimeReport 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 mit dimensionExpression die Werte von country und city zusammengeführt werden, können Sie diese Dimension countryAndCity nennen. Die von Ihnen ausgewählten Dimensionsnamen müssen dem regulären Ausdruck ^[a-zA-Z0-9_]$ entsprechen.

Auf Dimensionen wird in dimensionFilter, orderBys, dimensionExpression und pivots über name verwiesen.
dimensionExpression

object (DimensionExpression)

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

DimensionExpression

Wird verwendet, um eine Dimension auszudrücken, die das Ergebnis einer Formel mit mehreren Dimensionen ist. Beispiele für die Verwendung: 1) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2).

JSON-Darstellung 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of mutually exclusive fields.
}
Felder
Geben Sie einen Typ von Dimensionsausdruck für DimensionExpression an. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
lowerCase

object (CaseExpression)

Wird verwendet, um einen Dimensionswert in Kleinbuchstaben zu konvertieren.
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).
Ende der sich gegenseitig ausschließenden Felder.

CaseExpression

Wird verwendet, um einen Dimensionswert in einen einzelnen Fall zu konvertieren.

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

string

Name einer Dimension. Der Name muss sich auf einen Namen im Feld „dimensions“ der Anfrage beziehen.

ConcatenateExpression

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

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

string

Namen von Dimensionen. Die Namen müssen sich auf Namen im Feld „dimensions“ der Anfrage beziehen.
delimiter

string

Das Trennzeichen zwischen Dimensionsnamen.

Trennzeichen sind oft einzelne Zeichen wie „|“ oder „,“, können aber auch längere Strings sein. Wenn ein Dimensionswert das Trennzeichen enthält, sind beide in der Antwort vorhanden, ohne dass eine Unterscheidung erfolgt. Wenn beispielsweise der Wert für Dimension 1 „US,FR“, der Wert für Dimension 2 „JP“ und das Trennzeichen „,“ ist, enthält die Antwort „US,FR,JP“.