As dimensões são atributos dos seus dados. Por exemplo, a dimensão "Cidade" indica a cidade de origem de um evento. Os valores de dimensão nas respostas do relatório são strings. Por exemplo, a cidade pode ser "Paris" ou "Nova York". As solicitações podem ter até nove dimensões.
O nome da dimensão. Consulte Dimensões da API para conferir a lista de nomes de dimensões aceitos pelos métodos de relatórios principais, como runReport e batchRunReports. Consulte Dimensões em tempo real para conferir a lista de nomes de dimensões compatíveis com o método runRealtimeReport. Consulte Dimensões do funil para ver a lista de nomes de dimensões aceitos pelo método runFunnelReport.
Se dimensionExpression for especificado, name poderá ser qualquer string dentro do conjunto de caracteres permitido. Por exemplo, se um dimensionExpression concatenar country e city, você poderá chamar essa dimensão de countryAndCity. Os nomes de dimensão escolhidos precisam corresponder à expressão regular ^[a-zA-Z0-9_]$.
As dimensões são referenciadas por name em dimensionFilter, orderBys, dimensionExpression e pivots.
Uma dimensão pode ser o resultado de uma expressão de várias dimensões. Por exemplo, a dimensão "país, cidade": concatenate(country, ", ", city).
DimensionExpression
Usado para expressar uma dimensão que é o resultado de uma fórmula de várias dimensões. Exemplos de uso: 1) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2).
Representação 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.}
Campos
Campo de união one_expression. Especifique um tipo de expressão de dimensão para DimensionExpression. one_expression pode ser apenas de um dos tipos a seguir:
Usado para combinar valores de dimensão em uma única dimensão. Por exemplo, a dimensão "país, cidade": concatenate(country, ", ", city).
CaseExpression
Usado para converter um valor de dimensão em um único caso.
Representação JSON
{"dimensionName": string}
Campos
dimensionName
string
Nome de uma dimensão. O nome precisa se referir a um nome no campo de dimensões da solicitação.
ConcatenateExpression
Usado para combinar valores de dimensão em uma única dimensão.
Representação JSON
{"dimensionNames": [string],"delimiter": string}
Campos
dimensionNames[]
string
Nomes das dimensões. Os nomes precisam se referir aos nomes no campo de dimensões da solicitação.
delimiter
string
O delimitador colocado entre os nomes das dimensões.
Os delimitadores geralmente são caracteres únicos, como "|" ou ",", mas podem ser strings mais longas. Se um valor de dimensão tiver o delimitador, ambos vão estar presentes na resposta sem distinção. Por exemplo,se o valor da dimensão 1 for "US,FR", o valor da dimensão 2 for "JP" e o delimitador for ",", a resposta conterá "US,FR,JP".
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003eDimensions represent data attributes, like city or country, and are limited to 9 per request.\u003c/p\u003e\n"],["\u003cp\u003eYou can create custom dimensions using expressions that manipulate existing dimensions (e.g., lowercase, concatenate).\u003c/p\u003e\n"],["\u003cp\u003eDimension expressions can combine multiple dimensions with delimiters, such as joining country and city with a comma.\u003c/p\u003e\n"],["\u003cp\u003eDimension names in expressions should refer to existing dimension names defined in the request.\u003c/p\u003e\n"],["\u003cp\u003eWhen using delimiters, ensure they don't clash with values within your dimension data to avoid ambiguity.\u003c/p\u003e\n"]]],["This document outlines the structure and usage of dimensions in data reporting, focusing on creating custom dimensions. Dimensions are data attributes, like \"city.\" You can define a `dimension` with a `name` and an optional `dimensionExpression`. `DimensionExpression` allows combining or modifying existing dimensions using `lowerCase`, `upperCase`, or `concatenate` functions. `CaseExpression` changes dimension cases. `ConcatenateExpression` merges dimension values with a specified `delimiter`. Each dimension name is a string with allowed characters.\n"],null,[]]