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 de dimension dans les réponses des rapports sont des chaînes. Par exemple, la ville peut être "Paris" ou "New York". Les requêtes peuvent comporter jusqu'à neuf dimensions.

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

string

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

Si dimensionExpression est spécifié, name peut être n'importe quelle chaîne de caractères de votre choix dans l'ensemble de caractères autorisé. Par exemple, si une dimensionExpression concatène country et city, vous pouvez appeler cette dimension countryAndCity. Les noms de 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 "pays, ville" : concatenate(pays, ", ", ville).

DimensionExpression

Utilisé pour exprimer une dimension qui est le résultat d'une formule de plusieurs dimensions. Exemples d'utilisation : 1) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2).

Représentation JSON
{

  // 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.
}
Champs
Spécifiez un type d'expression de dimension pour DimensionExpression. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
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 en une seule dimension. Par exemple, dimension "pays, ville" : concatenate(pays, ", ", ville).

Fin des champs qui s'excluent mutuellement.

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 dans le champ "dimensions" de la requête.

ConcatenateExpression

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

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

string

Noms des dimensions. Les noms doivent faire référence à ceux du champ "dimensions" de la requête.

delimiter

string

Délimiteur placé entre les noms de dimensions.

Les délimiteurs sont souvent des caractères uniques tels que "|" ou ",", mais peuvent être des chaînes plus longues. Si une valeur de dimension contient le délimiteur, les deux seront présents dans la réponse sans distinction. Par exemple,si la valeur de la dimension 1 est "US,FR", celle de la dimension 2 est "JP" et le délimiteur est ",", la réponse contiendra "US,FR,JP".