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. Die Stadt könnte beispielsweise „Berlin“ oder „München“ sein. Anfragen dürfen bis zu 9 Dimensionen enthalten.

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

string

Der Name der Dimension. Eine Liste der Dimensionennamen, die von den wichtigsten Berichtsmethoden wie runReport und batchRunReports unterstützt werden, finden Sie unter API-Dimensionen. Eine Liste der von der Methode runRealtimeReport unterstützten Dimensionsnamen finden Sie unter Dimensionen in Echtzeit. Eine Liste der Dimensionen, die von der runFunnelReport-Methode unterstützt werden, finden Sie unter Trichterdimensionen.

Wenn dimensionExpression angegeben ist, kann name beliebiger String innerhalb des zulässigen Zeichensatzes sein. Wenn beispielsweise dimensionExpression aus country und city zusammengesetzt ist, 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 mit 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 anzugeben, die das Ergebnis einer Formel mit mehreren Dimensionen ist. Beispiele: 1) lowerCase(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 Dimensionsausdruck für DimensionExpression an. Für one_expression ist nur einer der folgenden Werte zulässig:
lowerCase

object (CaseExpression)

Hiermit wird ein Dimensionswert in Kleinbuchstaben umgewandelt.

upperCase

object (CaseExpression)

Wandelt einen Dimensionswert in Großbuchstaben um.

concatenate

object (ConcatenateExpression)

Hiermit werden Dimensionswerte zu einer einzelnen Dimension kombiniert. Beispiel: Dimension „Land, Stadt“: concatenate(country, ", ", city)

CaseExpression

Wird verwendet, um einen Dimensionswert in einen einzelnen Fall umzuwandeln.

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

string

Name einer Dimension. Der Name muss sich auf einen Namen im Dimensions-Feld der Anfrage beziehen.

ConcatenateExpression

Hiermit werden Dimensionswerte zu einer einzelnen Dimension kombiniert.

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

string

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

delimiter

string

Das Trennzeichen zwischen den 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 enthalten, ohne dass sie unterschieden werden. Wenn der Wert für Dimension 1 beispielsweise „DE,FR“ und der Wert für Dimension 2 „JP“ ist und „,“ als Trennzeichen festgelegt ist, enthält die Antwort „DE,FR,JP“.