Dimension

Les dimensions correspondent aux attributs de vos données. Par exemple, la dimension "Ville" indique la ville d'où provient un événement. Les valeurs des dimensions dans les réponses au rapport sont des chaînes. Par exemple, la ville peut être "Paris". ou "New York". Les demandes peuvent comporter jusqu'à neuf dimensions.

Représentation JSON
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Champs
name

string

Nom de la dimension. Consultez Dimensions de l'API pour obtenir la liste des noms de dimensions compatibles avec les principales méthodes de création de rapports telles que runReport et batchRunReports. Consultez Dimensions en temps réel pour obtenir la liste des noms de dimensions acceptés par la méthode runRealtimeReport. Consultez la section Dimensions de l'entonnoir pour obtenir la liste des noms de dimensions acceptés par la méthode runFunnelReport.

Si dimensionExpression est spécifié, name peut correspondre à n'importe quelle chaîne que vous souhaitez dans le jeu de caractères autorisé. Par exemple, si une dimensionExpression concatène country et city, vous pouvez appeler cette dimension countryAndCity. Les noms des dimensions que vous choisissez doivent correspondre à l'expression régulière ^[a-zA-Z0-9_]$.

Les dimensions sont référencées par name dans dimensionFilter, orderBys, dimensionExpression et pivots.

dimensionExpression

object (DimensionExpression)

Une dimension peut être le résultat d'une expression de plusieurs dimensions. Par exemple, dimension "country, city": concatenate(country, ", ", city).

DimensionExpression

Permet d'exprimer une dimension résultant d'une formule à plusieurs dimensions. Exemples d'utilisation: 1) lowerCase(dimension) 2) concatenate(dimension1, symbole, dimension2).

Représentation JSON
{

  // 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.
}
Champs
Champ d'union one_expression. Spécifiez un type d'expression de dimension pour DimensionExpression. La one_expression ne peut être qu'un des éléments suivants :
lowerCase

object (CaseExpression)

Permet de convertir une valeur de dimension en minuscules.

upperCase

object (CaseExpression)

Permet de convertir une valeur de dimension en majuscules.

concatenate

object (ConcatenateExpression)

Permet de combiner des valeurs de dimension dans une seule dimension. Par exemple, dimension "country, city": concatenate(country, ", ", city).

CaseExpression

Permet de convertir une valeur de dimension en une seule casse.

Représentation JSON
{
  "dimensionName": string
}
Champs
dimensionName

string

Nom d'une dimension. Le nom doit faire référence à un nom figurant dans le champ "Dimensions" de la requête.

ConcatenateExpression

Permet de combiner des valeurs de dimension dans une seule dimension.

Représentation JSON
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Champs
dimensionNames[]

string

Noms des dimensions. Les noms doivent faire référence aux noms indiqués dans le champ "Dimensions" de la requête.

delimiter

string

Délimiteur placé entre les noms de dimension.

Les délimiteurs sont souvent des caractères uniques tels que "|". ou "," mais il peut s'agir de chaînes plus longues. Si une valeur de dimension contient le délimiteur, les deux seront présents en réponse sans distinction. Par exemple, si la valeur de la dimension 1 = "US,FR", la valeur de la dimension 2 = "JP" et le séparateur = ", la réponse contiendra "US,FR,JP".