실시간 측정기준 및 측정항목
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Analytics Data API의 실시간 메서드에 대한 쿼리에서 지원되는 측정기준 및 측정항목입니다. 핵심 보고 메서드 (예: RunReport)는 실시간 메서드와 다른 측정기준 및 측정항목 집합을 허용합니다.
측정기준
다음 측정기준은 모든 속성의 보고서에서 요청할 수 있습니다. 보고서 응답의 측정기준 열에 대해 Dimension 리소스의 name 필드에 'API 이름'을 지정합니다.
| API 이름 |
UI 이름 |
설명 |
appVersion |
앱 버전 |
앱의 버전 이름(Android) 또는 약식 번들 버전(iOS)입니다. |
audienceId |
잠재고객 ID |
잠재고객의 숫자 식별자입니다. 사용자는 보고서 기간 동안 사용자가 속한 잠재고객으로 보고됩니다. 현재 사용자 행동은 보고서의 이전 잠재고객 멤버십에 영향을 미치지 않습니다. |
audienceName |
잠재고객 이름 |
잠재고객의 이름입니다. 사용자는 보고서 기간 동안 사용자가 속한 잠재고객으로 보고됩니다. 현재 사용자 행동은 보고서의 이전 잠재고객 멤버십에 영향을 미치지 않습니다. |
audienceResourceName |
잠재고객 리소스 이름 |
이 잠재고객의 리소스 이름입니다. 리소스 이름에는 리소스를 고유하게 식별하는 컬렉션 및 리소스 식별자가 모두 포함됩니다. 자세한 내용은 리소스 이름을 참고하세요. |
city |
도시 |
사용자 활동이 시작된 도시입니다. |
cityId |
도시 ID |
사용자 활동이 시작된 도시의 지리적 ID입니다. IP 주소에서 파생됩니다. |
country |
국가 |
사용자 활동이 시작된 국가입니다. |
countryId |
국가 ID |
사용자 활동이 시작된 국가의 지리적 ID입니다(IP 주소에서 파생됨). ISO 3166-1 alpha-2 표준에 따라 형식이 지정됩니다. |
deviceCategory |
기기 카테고리 |
기기의 유형(데스크톱, 태블릿, 모바일)입니다. |
eventName |
이벤트 이름 |
이벤트 이름 |
minutesAgo |
실시간 몇 분 전 |
이벤트가 수집된 후 경과된 시간(분)입니다. 00은 현재 분을 나타내고 01은 이전 분을 나타냅니다. |
platform |
플랫폼 |
앱이나 웹사이트가 실행된 플랫폼(예: 웹, iOS, Android)입니다. 보고서에서 스트림의 유형을 확인하려면 플랫폼과 streamId를 모두 사용하세요. |
streamId |
스트림 ID |
앱 또는 웹사이트의 숫자 데이터 스트림 식별자입니다. |
streamName |
스트림 이름 |
앱 또는 웹사이트의 데이터 스트림 이름입니다. |
unifiedScreenName |
페이지 제목 및 화면 이름 |
이벤트가 기록된 페이지 제목 (웹) 또는 화면 이름 (앱)입니다. |
맞춤 측정기준
Realtime Data API는 사용자 범위 맞춤 측정기준에 대한 보고서를 만들 수 있습니다. 맞춤 측정기준에 대해 자세히 알아보려면 맞춤 사용자 속성을 참고하세요. 맞춤 측정기준은 측정기준의 매개변수 이름과 범위에 따라 API 보고서 요청에 지정됩니다. 예를 들어 데이터 API 요청에 "customUser:last_level"를 포함하여 매개변수 이름이 "last_level"인 사용자 범위 맞춤 측정기준의 보고서를 만듭니다. 속성이 이 사용자 범위 맞춤 측정기준을 등록하지 않은 경우 이 API 요청은 실패합니다.
다음은 맞춤 측정기준의 일반적인 문법입니다. Metadata API 메서드를 쿼리하여 속성의 모든 맞춤 측정기준을 나열할 수 있습니다.
| 일반 API 이름 |
설명 |
customUser:parameter_name |
parameter_name의 사용자 범위 맞춤 측정기준 |
실시간 API에서는 이벤트 범위 맞춤 측정기준이 지원되지 않습니다.
측정항목
다음 측정항목은 모든 속성의 보고서에서 요청할 수 있습니다. 보고서 응답의 측정항목 열에 대해 Metric 리소스의 name 필드에 'API 이름'을 지정합니다.
| API 이름 |
UI 이름 |
설명 |
activeUsers |
활성 사용자 |
내 사이트 또는 앱을 방문한 개별 사용자의 수입니다. |
eventCount |
이벤트 수 |
이벤트 수입니다. |
keyEvents |
주요 이벤트 |
주요 이벤트 수입니다. 이벤트를 주요 이벤트로 표시하면 이 시점 이후의 보고서 데이터가 영향을 받습니다. 이전 데이터는 변경되지 않습니다. Google 애널리틱스에서 모든 이벤트를 주요 이벤트로 표시할 수 있으며, 일부 이벤트 (예: first_open 또는 purchase)는 기본적으로 주요 이벤트로 표시됩니다. |
screenPageViews |
조회수 |
사용자가 조회한 앱 화면 또는 웹페이지의 수입니다. 한 페이지 또는 한 화면을 반복해서 조회한 횟수도 집계에 포함됩니다. (screen_view 이벤트 수 + page_view 이벤트 수) |
이벤트 범위 맞춤 측정항목은 Realtime API에서 지원되지 않습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-29(UTC)
[null,null,["최종 업데이트: 2025-07-29(UTC)"],[[["\u003cp\u003eThe Realtime reporting method of the Analytics Data API allows you to query specific dimensions and metrics to analyze real-time user behavior on your app or website.\u003c/p\u003e\n"],["\u003cp\u003eSupported dimensions include user demographics (like city and country), device information, app version, audience data, event details, and user-scoped custom dimensions.\u003c/p\u003e\n"],["\u003cp\u003eYou can use metrics like \u003ccode\u003eactiveUsers\u003c/code\u003e, \u003ccode\u003eeventCount\u003c/code\u003e, \u003ccode\u003escreenPageViews\u003c/code\u003e, and \u003ccode\u003ekeyEvents\u003c/code\u003e to understand real-time user engagement.\u003c/p\u003e\n"],["\u003cp\u003eUnlike Core Reporting methods, the Realtime method uses a different set of dimensions and metrics and doesn't support event-scoped custom dimensions or metrics.\u003c/p\u003e\n"]]],["The Realtime Analytics Data API supports specific dimensions and metrics for querying. Dimensions include `appVersion`, `audienceId/Name/ResourceName`, geographic data (`city/Id`, `country/Id`), `deviceCategory`, `eventName`, `minutesAgo`, `platform`, `streamId/Name`, and `unifiedScreenName`. User-scoped custom dimensions are supported using the `customUser:parameter_name` format. Supported metrics are `activeUsers`, `eventCount`, `keyEvents`, and `screenPageViews`. Event-scoped custom dimensions and metrics are not supported in the Realtime API.\n"],null,["# Realtime Dimensions & Metrics\n\nThe dimensions and metrics supported in queries to the [Realtime method](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runRealtimeReport) of the Analytics Data API. The\nCore Reporting methods ([`RunReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport)\nfor example) accept a different set of [Dimensions \\& Metrics](/analytics/devguides/reporting/data/v1/api-schema)\nthan the Realtime method.\n\nDimensions\n----------\n\nThe following dimensions can be requested in reports for any property. Specify\nthe \"API Name\" in a [`Dimension`](/analytics/devguides/reporting/data/v1/rest/v1beta/Dimension) resource's `name`\nfield for a column of the dimension in the report response.\n\n| API Name | UI Name | Description |\n|------------------------|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `appVersion` | App version | The app's versionName (Android) or short bundle version (iOS). |\n| `audienceId` | Audience ID | The numeric identifier of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports. |\n| `audienceName` | Audience name | The given name of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports. |\n| `audienceResourceName` | Audience resource name | The resource name of this audience. Resource names contain both collection \\& resource identifiers to uniquely identify a resource; to learn more, see [Resource names](//google.aip.dev/122). |\n| `city` | City | The city from which the user activity originated. |\n| `cityId` | City ID | The geographic ID of the city from which the user activity originated, derived from their IP address. |\n| `country` | Country | The country from which the user activity originated. |\n| `countryId` | Country ID | The geographic ID of the country from which the user activity originated, derived from their IP address. Formatted according to ISO 3166-1 alpha-2 standard. |\n| `deviceCategory` | Device category | The type of device: Desktop, Tablet, or Mobile. |\n| `eventName` | Event name | The name of the event. |\n| `minutesAgo` | Realtime minutes ago | The number of minutes ago that an event was collected. 00 is the current minute, and 01 means the previous minute. |\n| `platform` | Platform | The platform on which your app or website ran; for example, web, iOS, or Android. To determine a stream's type in a report, use both platform and streamId. |\n| `streamId` | Stream ID | The numeric data stream identifier for your app or website. |\n| `streamName` | Stream name | The data stream name for your app or website. |\n| `unifiedScreenName` | Page title and screen name | The page title (web) or screen name (app) on which the event was logged. |\n\n### Custom Dimensions\n\nThe Realtime Data API can create reports on User scoped Custom Dimensions. See\n[Custom user properties](//support.google.com/analytics/answer/9269570) to learn\nmore about custom dimensions. Custom dimensions are specified in an API report\nrequest by the dimension's parameter name and scope. For example, include\n`\"customUser:last_level\"` in a Data API request to create a report for the\nUser-scoped Custom Dimension with parameter name `\"last_level\"`. This API\nrequest will fail if the property has not registered this User-scoped Custom\nDimension.\n\nThe following are the general syntax for Custom Dimensions. You can query the\n[Metadata API method](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/getMetadata) to list all\nCustom Dimensions for a Property.\n\n| Generic API Name | Description |\n|-----------------------------|----------------------------------------------------|\n| `customUser:parameter_name` | User-scoped Custom Dimension for `parameter_name`. |\n\nEvent-scoped custom dimensions aren't supported in the Realtime API.\n\nMetrics\n-------\n\nThe following metrics can be requested in reports for any property. Specify the\n\"API Name\" in a [`Metric`](/analytics/devguides/reporting/data/v1/rest/v1beta/Metric) resource's `name` field for\na column of the metric in the report response.\n\n| API Name | UI Name | Description |\n|-------------------|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `activeUsers` | Active users | The number of distinct users who visited your site or app. |\n| `eventCount` | Event count | The count of events. |\n| `keyEvents` | Key events | The count of key events. Marking an event as a key event affects reports from time of creation. It doesn't change historic data. You can mark any event as key in Google Analytics, and some events (such as `first_open` or `purchase`) are marked as key events by default. |\n| `screenPageViews` | Views | The number of app screens or web pages your users viewed. Repeated views of a single page or screen are counted. (screen_view + page_view events). |\n\nEvent-scoped custom metrics aren't supported in the Realtime API."]]
