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 aux rapports sont des chaînes. Par exemple, la ville peut être "Paris" ou "New York". Les requêtes sont autorisées 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 dimension compatibles avec les méthodes de reporting de base telles que runReport et batchRunReports. Pour obtenir la liste des noms de dimension compatibles avec la méthode runRealtimeReport, consultez la section Dimensions en temps réel. Pour obtenir la liste des noms de dimension compatibles avec la méthode runFunnelReport, consultez la section Dimensions de l'entonnoir.

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

Permet d'exprimer une dimension qui est le résultat d'une formule de 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 en une seule dimension. Par exemple, dimension "pays, ville": concatenate(pays, ", ", ville).

CaseExpression

Permet de convertir une valeur de dimension en majuscule ou minuscule.

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

delimiter

string

Délimiteur placé entre les noms de dimension.

Les séparateurs sont souvent des caractères uniques tels que "|" ou ",", mais ils peuvent également être des chaînes plus longues. Si une valeur de dimension contient le délimiteur, les deux éléments 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 séparateur est ",", la réponse contient "US,FR,JP".