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.anonrssandswapmemoryusage |
사용 데이터와 결합된 익명 RSS 및 스왑 메모리 사용량 데이터가 포함됩니다. |
anonRssAndSwapMemoryUsageP50 (google.type.Decimal): 익명 RSS 및 스왑 메모리 사용량의 50번째 백분위수입니다. anonRssAndSwapMemoryUsageP75 (google.type.Decimal): 익명 RSS 및 스왑 메모리 사용량의 75번째 백분위수입니다. anonRssAndSwapMemoryUsageP90 (google.type.Decimal): 익명 RSS 및 스왑 메모리 사용량의 90번째 백분위수입니다. anonRssAndSwapMemoryUsageP95 (google.type.Decimal): 익명 RSS 및 스왑 메모리 사용량의 95번째 백분위수입니다. anonRssAndSwapMemoryUsageP99 (google.type.Decimal): 익명 RSS 및 스왑 메모리 사용량의 99번째 백분위수입니다. distinctUsers (google.type.Decimal): 집계 기간 동안 메모리 측정항목이 보고된 순 사용자 수입니다. 사용자가 여러 번 집계될 수 있으므로 이 수를 더 집계하지 않도록 주의해야 합니다. 값의 크기에 따라 10, 100, 1,000 또는 1,000,000의 가장 가까운 배수로 반올림됩니다. |
vitals.bitmapmemoryusage |
사용 데이터와 결합된 비트맵 메모리 사용량 데이터를 포함합니다. |
bitmapMemoryUsageP50 (google.type.Decimal): 비트맵 메모리 사용량의 50번째 백분위수입니다. bitmapMemoryUsageP75 (google.type.Decimal): 비트맵 메모리 사용량의 75번째 백분위수입니다. bitmapMemoryUsageP90 (google.type.Decimal): 비트맵 메모리 사용량의 90번째 백분위수입니다. bitmapMemoryUsageP95 (google.type.Decimal): 비트맵 메모리 사용량의 95번째 백분위수입니다. bitmapMemoryUsageP99 (google.type.Decimal): 비트맵 메모리 사용량의 99번째 백분위수입니다. distinctUsers (google.type.Decimal): 집계 기간 동안 메모리 측정항목이 보고된 순 사용자 수입니다. 사용자가 여러 번 집계될 수 있으므로 이 수를 더 집계하지 않도록 주의해야 합니다. 값의 크기에 따라 10, 100, 1,000 또는 1,000,000의 가장 가까운 배수로 반올림됩니다. |
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.slowstartrate |
앱 시작 유형 (콜드, 웜, 핫)별로 분류된 느린 앱 시작 데이터를 포함합니다. |
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 모델입니다(예: Mali). |
deviceGpuVersion |
기기의 GPU 버전입니다(예: T750). |
deviceVulkanVersion |
기기의 Vulkan 버전입니다(예: '4198400'). |
deviceGlEsVersion |
기기의 OpenGL ES 버전입니다(예: '196610'). |
deviceScreenSize |
기기의 화면 크기입니다(예: NORMAL, LARGE). |
deviceScreenDpi |
기기의 화면 밀도입니다(예: mdpi, hdpi). |