Google 애널리틱스용 MCP 서버를 사용해 보세요.
GitHub에서 설치하고
공지사항에서 자세한 내용을 확인하세요.
Dimension
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
측정기준은 데이터의 속성입니다. 예를 들어 도시 측정기준은 이벤트가 발생한 도시를 나타냅니다. 보고서 응답의 측정기준 값은 문자열입니다. 예를 들어 도시는 '파리' 또는 '뉴욕'일 수 있습니다. 요청은 최대 9개의 측정기준을 허용합니다.
필드 |
name |
string
측정기준의 이름입니다. runReport 및 batchRunReports 와 같은 핵심 보고 메서드에서 지원하는 측정기준 이름 목록은 API 측정기준을 참고하세요. runRealtimeReport 메서드에서 지원하는 측정기준 이름 목록은 실시간 측정기준을 참고하세요. runFunnelReport 메서드에서 지원하는 측정기준 이름 목록은 유입경로 측정기준을 참고하세요. dimensionExpression 가 지정된 경우 name 는 허용되는 문자 집합 내에서 원하는 문자열이 될 수 있습니다. 예를 들어 dimensionExpression 가 country 와 city 를 연결하는 경우 이 측정기준을 countryAndCity 이라고 부를 수 있습니다. 선택한 측정기준 이름은 정규 표현식 ^[a-zA-Z0-9_]$ 와 일치해야 합니다.
크기는 dimensionFilter , orderBys , dimensionExpression , pivots 에서 name 로 참조됩니다.
|
dimensionExpression |
object (DimensionExpression )
하나의 측정기준은 여러 측정기준의 표현식의 결과일 수 있습니다. 예를 들어 측정기준 '국가, 도시': concatenate(국가, ", ", 도시)
|
DimensionExpression
여러 측정기준의 수식의 결과인 측정기준을 표현하는 데 사용됩니다. 사용 예: 1) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2)
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 .
} |
필드 |
통합 필드 one_expression . DimensionExpression 에 하나의 크기 표현식 유형을 지정합니다. one_expression 은 다음 중 하나일 수 있습니다. |
lowerCase |
object (CaseExpression )
측정기준 값을 소문자로 변환하는 데 사용됩니다.
|
upperCase |
object (CaseExpression )
측정기준 값을 대문자로 변환하는 데 사용됩니다.
|
concatenate |
object (ConcatenateExpression )
측정기준 값을 단일 측정기준으로 결합하는 데 사용됩니다. 예를 들어 측정기준 '국가, 도시': concatenate(국가, ", ", 도시)
|
CaseExpression
측정기준 값을 단일 케이스로 변환하는 데 사용됩니다.
JSON 표현 |
{
"dimensionName": string
} |
필드 |
dimensionName |
string
측정기준의 이름입니다. 이름은 요청의 측정기준 필드에 있는 이름을 다시 참조해야 합니다.
|
ConcatenateExpression
측정기준 값을 단일 측정기준으로 결합하는 데 사용됩니다.
JSON 표현 |
{
"dimensionNames": [
string
],
"delimiter": string
} |
필드 |
dimensionNames[] |
string
측정기준의 이름입니다. 이름은 요청의 측정기준 필드에 있는 이름을 다시 참조해야 합니다.
|
delimiter |
string
측정기준 이름 사이에 배치되는 구분 기호입니다. 구분자는 '|' 또는 ','와 같은 단일 문자인 경우가 많지만 더 긴 문자열일 수도 있습니다. 측정기준 값에 구분자가 포함된 경우 구분 없이 둘 다 응답에 표시됩니다. 예를 들어 측정기준 1 값이 'US,FR', 측정기준 2 값이 'JP', 구분자가 ','인 경우 응답에는 'US,FR,JP'가 포함됩니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["Dimensions represent data attributes, like city or country, and are limited to 9 per request."],["You can create custom dimensions using expressions that manipulate existing dimensions (e.g., lowercase, concatenate)."],["Dimension expressions can combine multiple dimensions with delimiters, such as joining country and city with a comma."],["Dimension names in expressions should refer to existing dimension names defined in the request."],["When using delimiters, ensure they don't clash with values within your dimension data to avoid ambiguity."]]],["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"]]