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)입니다. 보고서에서 스트림 유형을 확인하려면 platform 및streamId를 모두 사용하세요. |
streamId |
스트림 ID | 앱 또는 웹사이트의 숫자 데이터 스트림 식별자입니다. |
streamName |
스트림 이름 | 앱 또는 웹사이트의 데이터 스트림 이름입니다. |
unifiedScreenName |
페이지 제목 및 화면 이름 | 이벤트가 기록된 페이지 제목 (웹) 또는 화면 이름 (앱)입니다. |
맞춤 측정기준
Realtime Data API를 사용하면 사용자 범위 맞춤 측정기준에 대한 보고서를 만들 수 있습니다. 맞춤 측정기준에 대해 자세히 알아보려면 맞춤 사용자 속성을 참고하세요. 맞춤 측정기준은 API 보고서 요청에서 측정기준의 매개변수 이름과 범위로 지정됩니다. 예를 들어 Data 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에서 지원되지 않습니다.