Google Play Developer Reporting API를 사용하면 앱의 측정항목, 보고서, 타임라인 정보에 액세스할 수 있습니다. API 측정항목을 최대한 간단하게 사용하기 위해 측정항목 세트는 측정항목 액세스를 표준화합니다. 측정항목 집합은 공통 속성(예: 최신성 및 세부사항)을 공유하고 함께 쿼리할 수 있는 관련 측정항목의 논리적 그룹입니다. 측정항목 집합에는 분석을 필터링하거나 생성하는 데 사용할 수 있는 다양한 측정기준도 포함됩니다. 달리 명시되지 않는 한 모든 측정항목은 사용 가능한 모든 측정기준에 의해 분류되거나 필터링될 수 있습니다.
최신 상태
각 측정항목 세트 리소스는 사용 가능한 최신 데이터 포인트의 날짜와 시간을 가져오는 표준 GET 메서드를 제공합니다. 측정항목 집합은 여러 세분화 단위 (일별, 시간별)를 지원할 수 있으므로 이 작업은 지원되는 세부사항마다 최신 값 하나를 반환합니다.
새로고침 시간 값을 쿼리 기간의 엔드포인트로 직접 사용할 수 있습니다.
데이터 쿼리
측정항목 세트의 데이터에 액세스하려면 커스텀 QUERY 메서드를 사용하여 쿼리를 실행해야 합니다.
각 쿼리는 세부사항 및 기간을 지정해야 합니다. 액세스하려는 측정항목과 함께 집계를 분할하는 데 사용할 측정기준을 지정해야 합니다.
기간을 요청하는 타임라인을 요청할 때 주의를 기울여야 합니다. 그래야 기간 크기가 앱 크기 및 분석 횟수와 반비례합니다. 예를 들어 대량의 데이터를 읽어서 쿼리 시간이 초과되지 않도록 하려면 대규모 앱에서 단일 쿼리 요청으로 일수를 선택해야 합니다.
사용 가능한 측정항목 집합
아래 색인에는 요청할 수 있는 모든 엔드포인트와 관련 데이터가 나와 있습니다.
| 측정항목 세트 | 설명 | 지원되는 측정항목 |
|---|---|---|
vitals.anrrate |
사용자 데이터와 무관하게 정규화된 측정항목을 생성하기 위해 사용 데이터와 결합된 ANR 데이터가 포함됩니다. |
anrRate (google.type.Decimal): ANR이 하나 이상 발생한 집계 기간에 고유한 사용자의 비율입니다. anrRate7dUserWeighted (google.type.Decimal): 7일 이내의 날짜별 inrRate 측정항목의 가중치가 적용된 평균값입니다. anrRate28dUserWeighted (google.type.Decimal): 날짜를 포함한 28일의 userr 가중치 평균입니다. userPerceivedAnrRate (google.type.Decimal): 집계 기간 중 사용자 인식 ANR을 1회 이상 경험한 개별 사용자의 비율입니다. 현재 '입력 디스패치'의 ANR이 집계됩니다. userPerceivedAnrRate7dUserWeighted (google.type.Decimal): 최대 7일 이내의 userPerceivedAnrRate 측정항목의 사용자 가중 평균. userPerceivedAnrRate28dUserWeighted (google.type.Decimal): 날짜를 포함한 28일의 userPerceivedAnrRate 측정항목의 사용자 가중 평균입니다. distinctUsers (google.type.Decimal): 집계 기간에 데이터를 사용할 수 있는 대략적인 사용자 수입니다. |
vitals.crashrate |
사용자 데이터와 무관하게 정규화된 측정항목을 생성하기 위해 사용 데이터와 결합된 비정상 종료 데이터를 포함합니다. |
crashRate (google.type.Decimal): 집계 기간 동안 비정상 종료를 1회 이상 경험한 개별 사용자의 비율입니다. crashRate7dUserWeighted (google.type.Decimal): 날짜를 포함한 최근 7일 동안의 비정상 종료 측정항목 중 사용자 가중치가 적용된 평균입니다. crashRate28dUserWeighted (google.type.Decimal): 날짜를 포함한 28일간의 비정상 종료 측정항목 중 사용자 가중치가 적용된 평균입니다. userPerceivedCrashRate (google.type.Decimal): 앱을 사용하는 동안 비정상 종료가 1회 이상 발생한 집계 기간의 개별 사용자 비율입니다. userPerceivedCrashRate7dUserWeighted (google.type.Decimal): 날짜를 포함한 7일 동안의 userPerceivedCrashRate 측정항목의 사용자 가중 평균입니다. userPerceivedCrashRate28dUserWeighted (google.type.Decimal): 날짜를 포함한 28일의 userPerceivedCrashRate 측정항목의 사용자 가중 평균입니다. distinctUsers (google.type.Decimal): 집계 기간에 데이터를 사용할 수 있는 대략적인 사용자 수입니다. |
vitals.excessivewakeuprate |
사용자 수와 관계없이 정규화된 측정항목을 생성하기 위해 프로세스 상태 데이터와 결합된 AlarmManager wakeup 수 데이터를 포함합니다. |
exceiveWakeupRate (google.type.Decimal): 집계 기간에 시간당 10회가 넘는 wakeup이 발생한 개별 사용자의 비율입니다.
exceiveWakeupRate7dUserWeighted (google.type.Decimal): 최대 7일 이내의 사용자 가중치 적용 평균값(날짜 포함)입니다. exceiveWakeupRate28dUserWeighted (google.type.Decimal): 최대 28일간의 날짜 중 사용자가 설정한 WakeupRate 측정항목의 평균값입니다. distinctUsers (google.type.Decimal): 집계 기간에 데이터를 사용할 수 있는 대략적인 사용자 수입니다. |
vitals.stuckbackgroundwakelockrate |
사용자 수와 관계없이 정규화된 측정항목을 생성하기 위해 프로세스 상태 데이터와 결합된 PowerManager wakelock 시간 데이터를 포함합니다. |
stuckBgWakelockRate (google.type.Decimal): wakelock이 백그라운드에서 1시간 넘게 유지된 개별 사용자의 비율입니다.
stuckBgWakelockRate7dUserWeighted (google.type.Decimal): 최대 7일까지의 사용자 가중치가 적용된 BD WakelockRate 측정항목의 평균입니다. stuckBgWakelockRate28dUserWeighted (google.type.Decimal): 최대 28일 중 하루 동안 걸러진 BgWakelockRate 측정항목의 사용자 가중 평균. distinctUsers (google.type.Decimal): 집계 기간에 데이터를 사용할 수 있는 대략적인 사용자 수입니다. |
vitals.slowstartuprate |
앱 시작 유형 (콜드, 웜, 핫)을 기준으로 분류된 느린 앱 시작 데이터를 포함합니다. |
slowStartRate (google.type.Decimal): 집계 이벤트가 시작 시간이 느린 이벤트가 발생한 순 사용자의 비율입니다.
slowStartRate7dUserWeighted (google.type.Decimal): 날짜를 포함한 최근 7일 동안의 사용자 가중치가 적용된 느린 시작 비율 측정항목의 값입니다. slowStartRate28dUserWeighted (google.type.Decimal): 날짜를 포함한 최근 28일의 사용자 가중치가 적용된 느린 시작 비율 측정항목입니다. 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 |
버킷(3GB, 4GB 등)에 있는 기기의 RAM(MB) |
deviceSocMake |
기기의 기본 단일 칩 시스템(예: 삼성 여기를 참고하세요. |
deviceSocModel |
기기 기본 칩 시스템 모델명(예: 'Exynos 2100'. 여기를 참고하세요. |
deviceCpuMake |
기기의 CPU(예: Qualcomm |
deviceCpuModel |
기기 CPU의 모델입니다(예: 'Kryo 240'. |
deviceGpuMake |
기기의 GPU(예: 팔 |
deviceGpuModel |
기기 GPU의 모델입니다(예: 말리 |
deviceGpuVersion |
기기 GPU의 버전(예: T750입니다. |
deviceVulkanVersion |
기기의 Vulkan 버전. 예: '4198400' |
deviceGlEsVersion |
기기의 OpenGL ES 버전. 예: '196610'. |
deviceScreenSize |
기기의 화면 크기(예: 노멀, 커다란. |
deviceScreenDpi |
기기의 화면 밀도입니다(예: mdpi, hdpi). |