Google Play Developer Reporting API를 사용하면 앱에 관한 측정항목, 보고서, 타임라인 정보에 액세스할 수 있습니다. API 사용을 최대한 간단하게 만들기 위해 측정항목 세트는 측정항목 액세스를 표준화합니다. 측정항목 세트는 공통 속성(예: 업데이트 빈도 및 세부사항)을 공유하고 함께 쿼리할 수 있는 관련 측정항목의 논리적 그룹입니다. 측정항목 세트에는 필터링하거나 분류를 생성하는 데 사용할 수 있는 여러 측정기준도 포함되어 있습니다. 달리 명시되지 않는 한 모든 측정항목은 사용 가능한 모든 측정기준으로 분류하거나 필터링할 수 있습니다.
최신 상태
각 측정항목 세트 리소스는 최신 사용 가능한 데이터 포인트의 날짜와 시간을 가져오는 표준 GET 메서드를 제공합니다. 이를 새로고침이라고 합니다. 측정항목 세트는 여러 세부사항 (일별, 시간별)을 지원할 수 있으므로 작업은 지원되는 세부사항당 하나의 최신성 값을 반환합니다.
새로고침 값을 쿼리 시간 범위의 엔드포인트로 직접 사용할 수 있습니다.
데이터 쿼리
측정항목 세트의 데이터에 액세스하려면 맞춤 QUERY 메서드를 사용하여 쿼리를 실행해야 합니다.
각 쿼리는 세부사항과 기간을 지정해야 합니다. 액세스하려는 측정항목과 함께 집계를 분류하는 데 사용해야 하는 측정기준을 지정해야 합니다.
타임라인을 요청할 때는 날짜 범위를 요청하여 시간 범위의 크기가 앱의 크기 및 분류 수에 반비례하도록 주의해야 합니다. 예를 들어 대규모 앱은 너무 많은 데이터를 읽어 쿼리 시간 초과가 발생하는 것을 방지하기 위해 단일 쿼리 요청에서 더 적은 일수를 선택해야 합니다.
사용 가능한 측정항목 세트
아래 색인에는 요청할 수 있는 모든 엔드포인트와 연결된 데이터가 나열되어 있습니다.
| 측정항목 세트 | 설명 | 지원되는 측정항목 |
|---|---|---|
vitals.anrrate |
사용자 수와 관계없이 정규화된 측정항목을 생성하기 위해 사용 데이터와 결합된 ANR 데이터를 포함합니다. |
anrRate (google.type.Decimal): 집계 기간에 ANR을 한 번 이상 경험한 순 사용자의 비율입니다. anrRate7dUserWeighted (google.type.Decimal): 날짜를 포함하여 최대 7일 동안의 anrRate 측정항목의 사용자 가중 평균입니다. anrRate28dUserWeighted (google.type.Decimal): 날짜를 포함하여 최대 28일 동안의 anrRate 측정항목의 사용자 가중 평균입니다. userPerceivedAnrRate (google.type.Decimal): 집계 기간에 사용자 인식 ANR을 한 번 이상 경험한 순 사용자의 비율입니다. 현재 '입력 전달' ANR만 계산됩니다. userPerceivedAnrRate7dUserWeighted (google.type.Decimal): 날짜를 포함한 최대 7일 동안의 userPerceivedAnrRate 측정항목의 사용자 가중 평균입니다. userPerceivedAnrRate28dUserWeighted (google.type.Decimal): 날짜까지의 28일 동안의 userPerceivedAnrRate 측정항목의 사용자 가중 평균입니다. distinctUsers (google.type.Decimal): 집계 기간에 데이터를 사용할 수 있는 대략적인 사용자 수입니다. |
vitals.crashrate |
사용자 수와 관계없이 정규화된 측정항목을 생성하기 위해 사용 데이터와 결합된 비정상 종료 데이터가 포함됩니다. |
crashRate (google.type.Decimal): 집계 기간에 비정상 종료를 한 번 이상 경험한 순 사용자의 비율입니다. crashRate7dUserWeighted (google.type.Decimal): 날짜를 포함한 이전 7일 동안의 crashRate 측정항목의 사용자 가중 평균입니다. crashRate28dUserWeighted (google.type.Decimal): 날짜까지의 28일 동안의 crashRate 측정항목의 사용자 가중 평균입니다. userPerceivedCrashRate (google.type.Decimal): 앱이 활성 상태로 사용되는 동안 비정상 종료를 한 번 이상 경험한 집계 기간의 순 사용자의 비율입니다. userPerceivedCrashRate7dUserWeighted (google.type.Decimal): 날짜까지의 7일 동안의 userPerceivedCrashRate 측정항목의 사용자 가중 평균입니다. userPerceivedCrashRate28dUserWeighted (google.type.Decimal): 날짜까지의 28일 동안의 userPerceivedCrashRate 측정항목의 사용자 가중 평균입니다. distinctUsers (google.type.Decimal): 집계 기간에 데이터를 사용할 수 있는 대략적인 사용자 수입니다. |
vitals.lmkrate
|
사용자 수와 관계없이 정규화된 측정항목을 생성하기 위해 사용 데이터와 결합된 LMK (메모리 부족 종료) 데이터를 포함합니다. |
userPerceivedLmkRate (google.type.Decimal): 집계 기간에 앱을 활발히 사용하는 동안 LMK (메모리 부족 종료)를 한 번 이상 경험한 순 사용자의 비율입니다. 활동을 표시하거나 포그라운드 서비스를 실행하는 경우 앱이 활성 상태인 것으로 간주됩니다. userPerceivedLmkRate7dUserWeighted (google.type.Decimal): 날짜를 포함한 이전 7일간의 userPerceivedLmkRate 측정항목의 사용자 가중 평균입니다. userPerceivedLmkRate28dUserWeighted (google.type.Decimal): 날짜까지의 28일 동안의 userPerceivedLmkRate 측정항목의 사용자 가중 평균입니다. distinctUsers (google.type.Decimal): 집계 기간에 데이터를 사용할 수 있는 대략적인 사용자 수입니다. |
vitals.excessivewakeuprate |
사용자 수와 관계없이 정규화된 측정항목을 생성하기 위해 프로세스 상태 데이터와 결합된 AlarmManager 절전 모드 해제 횟수 데이터를 포함합니다. |
excessiveWakeupRate (google.type.Decimal): 집계 기간에 시간당 10회 이상 wakeup이 발생한 순 사용자의 비율입니다.
excessiveWakeupRate7dUserWeighted (google.type.Decimal): 날짜를 포함하여 최대 7일 동안의 excessiveWakeupRate 측정항목의 사용자 가중 평균입니다. excessiveWakeupRate28dUserWeighted (google.type.Decimal): 날짜까지의 28일 동안의 excessiveWakeupRate 측정항목의 사용자 가중 평균입니다. distinctUsers (google.type.Decimal): 집계 기간에 데이터를 사용할 수 있는 대략적인 사용자 수입니다. |
vitals.stuckbackgroundwakelockrate |
사용자 수와 관계없이 정규화된 측정항목을 생성하기 위해 프로세스 상태 데이터와 결합된 PowerManager 절전 모드 해제 시간 데이터를 포함합니다. |
stuckBgWakelockRate (google.type.Decimal): 집계 기간에 백그라운드에서 1시간 이상 wakelock이 유지된 순 사용자의 비율입니다.
stuckBgWakelockRate7dUserWeighted (google.type.Decimal): 날짜까지의 7일 동안 stuckBgWakelockRate 측정항목의 사용자 가중 평균입니다. stuckBgWakelockRate28dUserWeighted (google.type.Decimal): 날짜를 포함한 이전 28일 동안의 stuckBgWakelockRate 측정항목의 사용자 가중 평균입니다. distinctUsers (google.type.Decimal): 집계 기간에 데이터를 사용할 수 있는 대략적인 사용자 수입니다. |
vitals.slowstartuprate |
앱 시작 유형 (콜드, 웜, 핫)별로 분류된 느린 앱 시작 데이터를 포함합니다. |
slowStartRate (google.type.Decimal): 집계 기간에 느린 시작 이벤트가 발생한 순 사용자의 비율입니다.
slowStartRate7dUserWeighted (google.type.Decimal): 날짜까지의 7일 동안의 slowStartRate 측정항목의 사용자 가중 평균입니다. slowStartRate28dUserWeighted (google.type.Decimal): 날짜까지의 28일 동안의 slowStartRate 측정항목의 사용자 가중 평균입니다. distinctUsers (google.type.Decimal): 집계 기간에 데이터를 사용할 수 있는 대략적인 사용자 수입니다. |
vitals.errors.counts |
정규화되지 않은 오류 보고서 수를 포함합니다. |
참고: 이 리소스는 현재 API의 v1 알파 버전에서만 사용할 수 있습니다. errorReportCount (google.type.Decimal): 앱에 대해 수신된 개별 오류 보고서의 절대 수입니다. |
측정기준
각 측정항목 세트는 필터링 및 분석을 위한 고유한 측정기준 세트를 지원합니다. API에서 사용할 수 있는 측정기준 목록은 아래의 측정기준 색인을 참고하세요.
| 측정기준 | 설명 |
|---|---|
versionCode |
데이터가 캡처될 때 사용자 기기에서 실행 중이던 앱의 버전 코드입니다. 이 측정기준의 문자열 값은 정수로 파싱할 수 있습니다. Android에서 앱 버전 관리가 작동하는 방식에 관한 자세한 내용은 여기를 참고하세요. |
countryCode |
IP 주소를 기반으로 한 사용자의 국가 또는 지역 식별자입니다. 2자리 ISO-3166 코드(예: 미국은 US)로 표시됩니다. |
기기 측정기준
기기 및 기기의 소프트웨어와 하드웨어 특성에 해당하는 측정기준입니다.
| 측정기준 | 설명 |
|---|---|
apiLevel |
데이터가 캡처될 때 사용자 기기에서 실행된 Android의 API 수준입니다. 이 측정기준의 문자열 값은 정수로 파싱할 수 있습니다. Android 출시 목록과 API 수준 매핑 방법은 여기를 참고하세요. |
deviceModel |
Play Console 기기 카탈로그에 정의된 특정 기기 모델의 식별자입니다. |
deviceType |
Play Console 기기 카탈로그에서 사용되는 특정 기기 폼 팩터의 식별자입니다. |
deviceRamBucket |
기기의 RAM(MB)입니다(버킷: 3GB, 4GB 등). |
deviceSocMake |
기기의 기본 시스템 온 칩의 제조업체입니다(예: Samsung. 여기를 참고하세요. |
deviceSocModel |
기기의 기본 시스템 온 칩 모델 이름입니다(예: 'Exynos 2100' 여기를 참고하세요. |
deviceCpuMake |
기기 CPU의 제조사입니다(예: Qualcomm |
deviceCpuModel |
기기 CPU 모델입니다(예: 'Kryo 240' |
deviceGpuMake |
기기 GPU의 제조사입니다(예: ARM |
deviceGpuModel |
기기 GPU 모델입니다(예: 말리 |
deviceGpuVersion |
기기의 GPU 버전입니다(예: T750 |
deviceVulkanVersion |
기기의 Vulkan 버전입니다(예: '4198400' |
deviceGlEsVersion |
기기의 OpenGL ES 버전입니다(예: '196610' |
deviceScreenSize |
기기의 화면 크기입니다(예: 보통, 대형 |
deviceScreenDpi |
기기의 화면 밀도입니다(예: mdpi, hdpi). |