앱에 대한 오류 보고 데이터 가져오기
Microsoft Store 분석 API에서 이 메서드를 사용하여 지정된 날짜 범위 및 기타 선택적 필터에 대한 JSON 형식으로 앱에 대한 집계 오류 보고 데이터를 가져옵니다. 이 메서드는 지난 30일 동안 발생한 오류만 검색할 수 있습니다. 이 정보는 파트너 센터의 상태 보고서의 Failures 섹션에서도 확인할 수 있습니다.
필수 구성 요소
이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.
- 이미 수행하지 않으셨다면 Microsoft Store 분석 API에 필요한 모든 필수 구성 요소를 완료하세요.
- 이 메서드의 요청 헤더에 사용할 Azure AD 액세스 토큰 가져옵니다. 액세스 토큰을 발급받으면 만료되기 전까지 60분 동안 사용할 수 있습니다. 토큰이 만료되면 새 토큰을 가져올 수 있습니다.
요청
요청 구문
메서드 | 요청 URI |
---|---|
가져오기 | https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits |
요청 헤더
머리글 | 유형 | 묘사 |
---|---|---|
권한 부여 | 문자열 | 필수. Azure AD 액세스 토큰은 형식의 Bearer<토큰>입니다. |
요청 매개 변수
매개 변수 | 유형 | 묘사 | 필수 |
---|---|---|---|
applicationId | 문자열 | 오류 보고 데이터를 검색하려는 앱의 스토어 ID. 파트너 센터의 앱 식별 페이지에서 스토어 ID를 확인할 수 있습니다. 예를 들어 스토어 ID는 9WZDNCRFJ3Q8입니다. | 예 |
시작 날짜 | 날짜 | 검색할 오류 보고 데이터의 날짜 범위의 시작 날짜입니다. 기본값은 현재 날짜입니다.
aggregationLevel이 일, 주, 또는 월인 경우, 이 매개변수는 mm/dd/yyyy 형식으로 날짜를 지정해야 합니다.
aggregationLevel이 시간경우, 이 매개변수는 날짜를 mm/dd/yyyy 형식으로 지정하거나, 날짜와 시간을 yyyy-mm-dd hh:mm:ss 형식으로 지정할 수 있습니다.
참고: 이 메서드는 지난 30일 동안 발생한 오류만 검색할 수 있습니다. |
아니요 |
종료일 | 날짜 | 검색할 오류 보고 데이터의 날짜 범위의 종료 날짜입니다. 기본값은 현재 날짜입니다.
aggregationLevel이 일, 주또는 월인 경우, 이 매개 변수는 mm/dd/yyyy 형식으로 날짜를 지정해야 합니다. |
아니요 |
맨 위로 | 정수형 (int) | 요청에 반환할 데이터 행 수입니다. 지정하지 않으면 최대값과 기본값은 10000입니다. 쿼리에 행이 더 있는 경우 응답 본문에는 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 포함됩니다. | 아니요 |
거르다 | 정수형 (int) | 쿼리에서 건너뛸 행 수입니다. 이 매개변수를 사용하여 큰 데이터 집합을 탐색합니다. 예를 들어 top=10000 및 skip=0은 처음 10000개의 데이터 행을 검색하고 top=10000 및 skip=10000은 다음 10000개 행의 데이터 등을 검색합니다. | 아니요 |
필터 | 문자열 | 응답의 행을 필터링하는 하나 이상의 명령문입니다. 각 문에는 응답 본문의 필드 이름과 eq 또는 ne 연산자와 연결된 값이 포함되며, 및 사용하거나 또는사용하여 문을 결합할 수 있습니다. 문자열 값은 필터 매개 변수에서 작은따옴표로 묶어야 합니다. 응답 본문에서 다음 필드를 지정할 수 있습니다.
|
아니요 |
집계 수준 | 문자열 | 집계 데이터를 검색할 시간 범위를 지정합니다. 시간, 일, 주또는 월중 하나일 수 있습니다. 지정하지 않으면 기본값은 일. 주 또는 월지정하는 경우 failureName 및 failureHash 값은 1000개의 버킷으로 제한됩니다. 참고:시간지정하는 경우 이전 72시간에서만 오류 데이터를 검색할 수 있습니다. 72시간보다 오래된 오류 데이터를 검색하려면 일 또는 다른 집계 수준 중 하나를 지정합니다. | 아니요 |
정렬 기준 | 문자열 | 결과 데이터 값을 정렬하는 문입니다. 구문은 *orderby=field [order]입니다.
필드 매개 변수는 다음 문자열 중 하나일 수 있습니다.
순서 매개 변수는 선택 사항이며, 각 필드에 대한 오름차순 또는 내림차순 순서를 지정할 수 있도록 asc 또는 desc로 설정할 수 있습니다. 기본값은 asc. 여기 예시 orderby 문자열: orderby=date 참고: 모든 매개 변수는 groupby지원되는 목록에 있어야 합니다. |
아니요 |
그룹바이 | 문자열 | 지정된 필드에만 데이터 집계를 적용하는 문입니다. 다음 필드를 지정할 수 있습니다.
반환된 데이터 행에는 groupby 매개 변수에 지정된 필드와 다음이 포함됩니다.
groupby 매개 변수는 aggregationLevel 매개 변수와 함께 사용할 수 있습니다. 예: &그룹별=failureName,market&집계수준=week 참고: 매개 변수에는 중복 항목이 포함될 수 없습니다. |
아니요 |
요청 예제
다음 예제에서는 오류 보고 데이터를 가져오기 위한 몇 가지 요청을 보여 줍니다. applicationId 값을 앱의 스토어 ID로 바꿉니다.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=market eq 'US' and deviceType eq 'phone' HTTP/1.1
Authorization: Bearer <your access token>
응답
응답 본문
값 | 형 | 묘사 |
---|---|---|
값 | 배열 | 집계 오류 보고 데이터를 포함하는 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 내용은 아래 오류 값 섹션을 참조하십시오. |
@nextLink | 문자열 | 추가 데이터 페이지가 있는 경우 이 문자열에는 다음 데이터 페이지를 요청하는 데 사용할 수 있는 URI가 포함됩니다. 예를 들어 요청의 상위 매개 변수가 10000으로 설정되어 있지만 쿼리에 대해 10000개 이상의 오류 행이 있는 경우 이 값이 반환됩니다. |
총계 | 정수 | 쿼리에 대한 데이터 결과의 총 행 수입니다. |
오류 값
Value 배열의 요소는 다음 값을 포함합니다.
가치 | 유형 | 묘사 |
---|---|---|
날짜 | 문자열 | 오류 데이터의 날짜 범위에서 yyyy-mm-dd 형식의 첫 번째 날짜입니다. 요청이 1일을 지정하는 경우 이 값은 해당 날짜입니다. 요청이 더 긴 날짜 범위를 지정하는 경우 이 값은 해당 날짜 범위의 첫 번째 날짜입니다.
aggregationLevel 값을 시간으로 지정한 요청의 경우, 이 값에는 시간 값이 hh:mm:ss 형식으로 포함됩니다. |
applicationId | 문자열 | 오류 데이터를 검색하려는 앱의 스토어 ID입니다. |
애플리케이션 이름 | 문자열 | 앱의 표시 이름입니다. |
실패명 | 문자열 | 하나 이상의 문제 클래스, 예외/버그 검사 코드, 오류가 발생한 이미지의 이름 및 연결된 함수 이름 등 네 부분으로 구성된 오류의 이름입니다. |
failureHash (실패 해시) | 문자열 | 오류의 고유 식별자입니다. |
상징 | 문자열 | 이 오류에 할당된 기호입니다. |
운영체제 버전 | 문자열 | 오류가 발생한 OS 버전을 지정하는 다음 문자열 중 하나입니다.
|
osRelease | 문자열 | 오류가 발생한 OS 릴리스 또는 OS 버전 내의 하위 집단을 나타내는 플라이팅 링을 지정하는 다음 문자열 중 하나입니다. Windows 11의 경우: 버전 2110 Windows 10의 경우:
Windows Server 1709의 경우:
Windows Server 2016의 경우:
Windows 8.1의 경우:
Windows 7의 경우:
OS 릴리스 또는 플라이팅 링을 알 수 없는 경우, 이 필드의 값은 알 수 없음입니다. |
이벤트 유형 | 문자열 | 다음 문자열 중 하나입니다.
|
시장 | 문자열 | 디바이스 시장의 ISO 3166 국가 코드입니다. |
디바이스 유형 | 문자열 | 오류가 발생한 디바이스의 유형을 나타내는 다음 문자열 중 하나입니다.
|
패키지이름 | 문자열 | 이 오류와 연결된 앱 패키지의 고유 이름입니다. |
패키지버전 | 문자열 | 이 오류와 연결된 앱 패키지의 버전입니다. |
디바이스 개수 | 수 | 지정된 집계 수준에 대해 이 오류에 해당하는 고유 디바이스의 수입니다. |
이벤트 수 | 수 | 지정된 집계 수준에 대해 이 오류에 기인하는 이벤트 수입니다. |
메모
이 메서드는 지난 30일 동안 발생한 오류만 검색할 수 있습니다.
요청 및 응답 예제
다음 코드 조각은 해당 요청에 대한 예제 요청 및 JSON 응답 본문을 보여 줍니다.
샘플 요청
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?applicationId=9NBLGGGZ5QDR&startDate=07/02/2022&endDate=07/20/2022&top=10&skip=0&filter=market eq 'US'&groupby=failureName,failureHash,symbol,osVersion,eventType,market,deviceType,packageName,packageVersion,osRelease&orderby=date
HTTP/1.1
Authorization: Bearer <your access token>
예시 응답
{
"Value": [
{
"date": "2022-07-21",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"failureName": "APPLICATION_HANG_BlockedOn_FileIO_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_Microsoft.Contoso Demo!unknown_error_in_application",
"failureHash": "c21da75f-ea4d-538b-cfec-73654ef810b9",
"symbol": "Microsoft.Contoso Demo!unknown_error_in_application",
"osVersion": "6.3.9600",
"osRelease": "RTM",
"osArchitecture": null,
"eventType": "hang",
"market": "US",
"deviceType": "PC",
"praid": null,
"packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
"packageVersion": "2.5.2.34894",
"ram": null,
"massStorage": null,
"cpu": null,
"cpuManufacturer": null,
"cpuFamilyName": null,
"sandboxId": null,
"deviceCount": 6.0,
"eventCount": 1.05263157894737
},
{
"date": "2022-07-21",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"failureName": "APPLICATION_HANG_BlockedOn_FileIO_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_Microsoft.Contoso Demo!unknown_error_in_application",
"failureHash": "c21da75f-ea4d-538b-cfec-73654ef810b9",
"symbol": "Microsoft.Contoso Demo!unknown_error_in_application",
"osVersion": "6.3.9600",
"osRelease": "RTM",
"osArchitecture": null,
"eventType": "hang",
"market": "US",
"deviceType": "Unknown",
"praid": null,
"packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
"packageVersion": "2.5.2.34894",
"ram": null,
"massStorage": null,
"cpu": null,
"cpuManufacturer": null,
"cpuFamilyName": null,
"sandboxId": null,
"deviceCount": 7.14285714285714,
"eventCount": 1.05263157894737
},
{
"date": "2022-07-21",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"failureName": "APPLICATION_HANG_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_twinapi.appcore.dll!WaitCoalesced",
"failureHash": "233e04bb-7a3d-eb28-c316-1120aa9defc0",
"symbol": "twinapi.appcore.dll!WaitCoalesced",
"osVersion": "6.3.9600",
"osRelease": "RTM",
"osArchitecture": null,
"eventType": "hang",
"market": "US",
"deviceType": "PC",
"praid": null,
"packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
"packageVersion": "2.5.2.34894",
"ram": null,
"massStorage": null,
"cpu": null,
"cpuManufacturer": null,
"cpuFamilyName": null,
"sandboxId": null,
"deviceCount": 6.0,
"eventCount": 8.94736842105263
}
],
"@nextLink": "failurehits?applicationId=9NBLGGGZ5QDR&aggregationLevel=day&startDate=2022/07/02&endDate=2022/07/21&top=10&skip=10&groupby=failureName,failureHash,symbol,osVersion,eventType,market,deviceType,packageName,packageVersion,osRelease&filter=market eq 'US'&orderby=date",
"TotalCount": 443
}
관련 항목
- 상태 보고서
- 앱 오류의 세부 정보 확인하기
- 앱에서 오류의 스택 추적을 가져오기
- 앱 오류에 대한 CAB 파일을 다운로드하세요
- Microsoft Store 서비스를 사용하여 분석 데이터에 액세스
- 앱 획득
- 추가 기능 획득 가져오기
- 앱 등급 가져오기
- 앱 검토 가져오기