Microsoft Store 분석 API에서 이 메서드를 사용하여 지정된 날짜 범위 및 기타 선택적 필터를 통해 앱의 획득, 상태, 사용 통계와 관련된 인사이트 데이터를 얻습니다. 이 정보는 파트너 센터의 Insights 보고서에서 도 사용할 수 있습니다.
필수 조건
이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.
- 아직 수행하지 않은 경우 Microsoft Store 분석 API에 대한 모든 필수 구성 요소를 완료합니다.
- 이 메서드에 대한 요청 헤더에서 사용할 Azure AD 액세스 토큰을 가져옵니다. 액세스 토큰을 받은 후 60분 이내에 사용해야 합니다. 그렇지 않으면 만료됩니다. 토큰이 만료되면 새 토큰을 가져올 수 있습니다.
요청
요청 구문
| 메서드 | URI 요청 |
|---|---|
| 가져오기 | https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights |
요청 헤더
| 헤더 | 유형 | 설명 |
|---|---|---|
| 승인 | 문자열 | 필수 사항입니다. Azure AD 액세스 토큰은 Bearer< 형식의 토큰>입니다. |
요청 매개 변수
| 매개 변수 | 유형 | 설명 | 필수 |
|---|---|---|---|
| 애플리케이션 아이디 | 문자열 | 인사이트 데이터를 검색하려는 앱의 스토어 ID 입니다. 이 매개 변수를 지정하지 않으면 응답 본문에 계정에 등록된 모든 앱에 대한 인사이트 데이터가 포함됩니다. | 아니오 |
| 시작 날짜 | 날짜 | 검색할 인사이트 데이터의 날짜 범위의 시작 날짜입니다. 기본값은 현재 날짜 30일 전입니다. | 아니오 |
| 종료일 | 날짜 | 검색할 인사이트 데이터의 날짜 범위의 종료 날짜입니다. 기본값은 현재 날짜입니다. | 아니오 |
| 필터 | 문자열 | 응답의 행을 필터링하는 하나 이상의 구문이 있습니다. 각 문에는 응답 본문의 필드 이름과 eq 또는 ne 연산자와 연결된 값이 포함되며, 문은 및 또는 또는을 사용하여 결합할 수 있습니다. 문자열 값은 필터 매개 변수에서 작은따옴표로 묶어야 합니다. 예를 들어 filter=dataType eq 'acquisition'입니다.
다음 필터 필드를 지정할 수 있습니다.
|
예 |
예제 요청
다음 예제에서는 인사이트 데이터를 가져오기 위한 요청을 보여 줍니다. applicationId 값을 앱의 스토어 ID로 바꿉니다.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights?applicationId=9NBLGGGZ5QDR&startDate=6/1/2018&endDate=6/15/2018&filter=dataType eq 'acquisition' or dataType eq 'health' HTTP/1.1
Authorization: Bearer <your access token>
응답
응답 메시지 본문
| 가치 | 유형 | 설명 |
|---|---|---|
| 가치 | 배열 | 앱에 대한 인사이트 데이터를 포함하는 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 내용은 아래 인사이트 값 섹션을 참조하세요. |
| 총개수 | 정수 (int) | 쿼리의 데이터 결과에 포함된 행의 총 개수입니다. |
인사이트 가치
값 배열의 요소는 다음 값을 포함합니다.
| 가치 | 유형 | 설명 |
|---|---|---|
| 애플리케이션 아이디 | 문자열 | 인사이트 데이터를 검색하는 앱의 스토어 ID입니다. |
| 통찰날짜 | 문자열 | 특정 메트릭의 변경 사항을 식별한 날짜입니다. 이 날짜는 메트릭이 이전 주에 비해 크게 증가하거나 감소한 것을 감지한 주의 끝을 나타냅니다. |
| 데이터 타입 | 문자열 | 이 인사이트에서 설명하는 일반 분석 영역을 지정하는 다음 문자열 중 하나입니다.
|
| 통찰 세부사항 | 배열 | 현재 인사이트에 대한 세부 정보를 나타내는 하나 이상의 InsightDetail 값 입니다. |
InsightDetail 값
| 가치 | 유형 | 설명 |
|---|---|---|
| 팩트네임 | 문자열 |
dataType 값에 따라 현재 인사이트 또는 현재 차원이 설명하는 메트릭을 나타내는 다음 값 중 하나입니다.
|
| 하위 차원 | 배열 | 인사이트에 대한 단일 메트릭을 설명하는 하나 이상의 개체입니다. |
| 백분율 변화 | 문자열 | 전체 고객 기반에서 지표가 변경된 비율입니다. |
| 차원 이름 | 문자열 | 현재 차원에 설명된 메트릭의 이름입니다. EventType, Market, DeviceType, PackageVersion, AcquisitionType, AgeGroup 및 Gender을 예로 들 수 있습니다. |
| 차원값 | 문자열 | 현재 차원에 설명된 메트릭의 값입니다. 예를 들어 DimensionName 이 EventType인 경우 DimensionValue 가 충돌 하거나 중단될 수 있습니다. |
| 사실가치 | 문자열 | 인사이트가 검색된 날짜에 대한 메트릭의 절대값입니다. |
| 방향 | 문자열 | 변경 방향(양수 또는 음수)입니다. |
| 날짜 | 문자열 | 현재 인사이트 또는 현재 차원과 관련된 변경 사항을 식별한 날짜입니다. |
비고
검색된 Insights 변경 내용은 최근 30일간의 취득, 상태 및/또는 사용량 현황 데이터에만 적용됩니다.
요청 및 응답 예제
다음 코드 조각은 해당 요청에 대한 몇 가지 예제 요청 및 JSON 응답 본문을 보여 줍니다.
샘플 요청
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights?applicationId=9NBLGGGZ5QDR&startDate=7/12/2022&endDate=7/29/2022&filter=dataType eq 'acquisition' or dataType eq 'health'
HTTP/1.1
Authorization: Bearer <your access token>
예시 응답
{
"Value": [
{
"id": "8cdb672c7893bd33a3dec48ededdc676602a1361f3209ab4f3e0982672fc198f",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-27T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-27 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "DeviceType",
"DimensionValue": "Tablet",
"Date": "2022-07-27 00:00:00",
"Direction": "Positive",
"PercentChange": 16.091954022988507,
"FactName": "AcquisitionQuantity",
"FactQuantity": 28.0
}
]
}
]
},
{
"id": "6b8849ecb043c6e5ecdd1c20040c0a371e9ab176eff77f7312b0489e19379225",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-26T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-26 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "DeviceType",
"DimensionValue": "Tablet",
"Date": "2022-07-26 00:00:00",
"Direction": "Positive",
"PercentChange": 28.048780487804876,
"FactName": "AcquisitionQuantity",
"FactQuantity": 30.0
}
]
}
]
},
{
"id": "93115e855fec507385bab17251f49c33bcbc1b62c603e5c7863e327ba94bf160",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-20T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-20 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "GB",
"Date": "2022-07-20 00:00:00",
"Direction": "Negative",
"PercentChange": 3.3035714285714284,
"FactName": "AcquisitionQuantity",
"FactQuantity": 158.0
}
]
}
]
},
{
"id": "4814abe710042a2798b453d8821909c246c389dde814e6678da7189211410604",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-24T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-24 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "DO",
"Date": "2022-07-24 00:00:00",
"Direction": "Negative",
"PercentChange": 13.533834586466165,
"FactName": "AcquisitionQuantity",
"FactQuantity": 8.0
}
]
}
]
},
{
"id": "7941070bb17904f3ef4e19de9659110cb52e18ecfb637ad724e2da749445a860",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-21T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-21 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "AT",
"Date": "2022-07-21 00:00:00",
"Direction": "Positive",
"PercentChange": 0.0,
"FactName": "AcquisitionQuantity",
"FactQuantity": 17.0
}
]
},
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-21 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "SE",
"Date": "2022-07-21 00:00:00",
"Direction": "Negative",
"PercentChange": 21.686746987951807,
"FactName": "AcquisitionQuantity",
"FactQuantity": 5.0
}
]
}
]
},
{
"id": "55905f5458617b65669eb115cc28ebd7296841bd2ff3f8e2546ade1d5e93f68d",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-13T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-13 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "LK",
"Date": "2022-07-13 00:00:00",
"Direction": "Negative",
"PercentChange": 11.111111111111111,
"FactName": "AcquisitionQuantity",
"FactQuantity": 9.0
}
]
}
]
},
{
"id": "9ce9317bf4d0f903de51a49d00a07cf4b4a8ac4457fd1e2886493bd38ceac0b7",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-19T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "Acquisition",
"DimensionValue": "Free",
"Date": "2022-07-19 00:00:00",
"Direction": "Negative",
"PercentChange": 12.188725230475788,
"FactName": "AcquisitionQuantity",
"FactQuantity": 2470,
"SubDimensions": []
}
]
}
],
"TotalCount": 7
}