앱 취득 가져오기
Microsoft Store 분석 API에서 이 메서드를 사용하여 지정된 날짜 범위 및 다른 선택 필터 동안 애플리케이션의 집계 취득 데이터를 JSON 형식으로 가져옵니다. 이 정보는 파트너 센터의 취득 보고서에서도 볼 수 있습니다.
필수 조건
이 메서드를 사용하려면 먼저 다음 방법대로 해야 합니다.
- 아직 완료하지 않은 경우 Microsoft Store 분석 API에 대한 모든 필수 조건을 완료합니다.
- 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져오세요. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.
Request
요청 구문
| 메서드 | 요청 URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions |
요청 헤더
| 헤더 | 형식 | 설명 |
|---|---|---|
| 권한 부여 | string | 필수. Bearer<토큰> 형식의 Azure AD 액세스 토큰. |
요청 매개 변수
| 매개 변수 | 형식 | 설명 | 필수 |
|---|---|---|---|
| applicationId | 문자열 | 구입 데이터를 검색할 앱의 Store ID. | 예 |
| startDate | date | 검색할 획득 데이터의 날짜 범위 중 시작 날짜입니다. 기본값은 현재 날짜입니다. | 아니요 |
| endDate | date | 검색할 획득 데이터의 날짜 범위 중 종료 날짜입니다. 기본값은 현재 날짜입니다. | 아니요 |
| top | int | 요청에서 반환할 데이터 행의 수. 지정되지 않은 경우 최댓값 및 기본값은 10000입니다. 쿼리에 행이 더 있는 경우, 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 응답 본문에 포함됩니다. | 아니요 |
| skip | int | 쿼리에서 건너뛸 행 수. 이 매개 변수를 사용하여 큰 데이터 집합을 페이징합니다. 예를 들어 top=10000 및 skip=0은 데이터의 첫 10000행을 검색하고 top=10000 및 skip=10000은 데이터의 그 다음 10000행을 검색하는 식으로 이어집니다. | 아니요 |
| 필터 | 문자열 | 응답의 행을 필터링하는 한 개 이상의 구문입니다. 각 명령문에는 응답 본문의 필드 이름 및 eq 또는 ne 연산자와 연결된 값이 포함되며, 명령문은 and 또는 or을 사용하여 결합될 수 있습니다. 문자열 값은 필터 매개 변수에서 단일 따옴표로 묶여야 합니다. 예시: filter=market eq 'US' and gender eq 'm'. 응답 본문에서 지정할 수 있는 필드는 다음과 같습니다.
|
아니요 |
| aggregationLevel | 문자열 | 집계 데이터를 검색할 시간 범위를 지정합니다. 일 문자열, 주 문자열 또는 월 문자열 중 하나일 수 있습니다. 지정하지 않으면 기본값이 일이 됩니다. | 아니요 |
| orderby | 문자열 | 각 취득에 대한 결과 데이터 값의 순서를 지정하는 문. 구문은 orderby=field [order],field [order],...입니다. 필드 매개 변수는 다음 문자열 중 하나일 수 있습니다.
order 매개 변수는 옵션이며 각 필드를 asc 또는 desc로 오름차순 또는 내림차순으로 지정할 수 있습니다. 기본값은 asc입니다. 다음은 orderby 문자열의 예시입니다. orderby=date,market |
아니요 |
| groupby | 문자열 | 지정된 필드에만 데이터 집계를 적용하는 문. 다음과 같은 필드를 지정할 수 있습니다.
반환된 데이터 행에는 groupby 매개 변수에 지정된 필드와 다음이 포함됩니다.
groupby 매개 변수는 aggregationLevel 매개 변수와 함께 사용할 수 있습니다. 예시: &groupby=ageGroup,market&aggregationLevel=week |
아니요 |
요청 예시
다음 예제는 앱 취득 데이터를 가져오는 데 필요한 몇 가지 요청을 보여 줍니다. applicationId 값을 앱의 Store ID로 바꿉니다.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?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/appacquisitions?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=market eq 'US' and gender eq 'm' HTTP/1.1
Authorization: Bearer <your access token>
응답
응답 본문
| 값 | 형식 | 설명 |
|---|---|---|
| 값 | 배열 | 앱의 집계 취득 데이터가 포함된 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 정보는 아래의 취득 값 섹션을 참조하세요. |
| @nextLink | 문자열 | 추가적인 데이터 페이지가 있는 경우, 다음 데이터 페이지를 요청하는 데 사용할 수 있는 URI가 이 문자열에 포함됩니다. 예를 들어 요청의 top 매개 변수가 10000으로 설정되어 있지만 쿼리에 대한 취득 데이터의 행이 10000 보다 많은 경우 이 값이 반환됩니다. |
| TotalCount | int | 쿼리에 대한 데이터 결과의 총 행 수. |
획득 값
값 배열의 요소에는 다음 값이 포함됩니다.
| 값 | 형식 | 설명 |
|---|---|---|
| date | 문자열 | 획득 데이터의 날짜 범위 중 첫 날짜입니다. 요청에서 하루를 지정한 경우, 이 값은 해당 날짜입니다. 요청에서 주, 월 또는 기타 날짜 범위를 지정한 경우, 이 값은 해당 날짜 범위 중 첫 날짜입니다. |
| applicationId | 문자열 | 취득 데이터를 검색할 앱의 Store ID. |
| applicationName | 문자열 | 앱의 표시 이름. |
| deviceType | 문자열 | 취득이 발생한 디바이스 유형을 나타내는 다음 문자열 중 하나입니다.
|
| orderName | 문자열 | 주문의 이름입니다. |
| storeClient | 문자열 | 취득이 발생한 Microsoft Store의 버전을 나타내는 다음 문자열 중 하나입니다.
|
| osVersion | 문자열 | 취득이 발생한 OS 버전을 나타내는 다음 문자열 중 하나입니다.
|
| 시장 | 문자열 | 획득이 발생한 시장의 ISO 3166 국가 번호입니다. |
| gender | 문자열 | 취득한 사용자의 성별을 지정하는 다음 문자열 중 하나입니다.
|
| ageGroup | 문자열 | 취득한 사용자의 연령 그룹을 나타내는 다음 문자열 중 하나입니다.
|
| acquisitionType | 문자열 | 취득 유형을 나타내는 다음 문자열 중 하나입니다.
|
| acquisitionQuantity | 수 | 지정된 집계 수준 동안 발생한 획득 수입니다. |
요청 및 응답 예제
다음 코드 조각은 해당 요청에 대한 몇 가지 예제 요청 및 JSON 응답 본문을 보여 줍니다.
샘플 요청
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?applicationId=9NBLGGGZ5QDR HTTP/1.1
Authorization: Bearer <your access token>
샘플 응답
{
"Value": [
{
"applicationId": "9NBLGGGZ5QDR",
"date": "2022-07-29",
"acquisitionQuantity": 7,
"purchasePriceUSDAmount": 0.0,
"purchasePriceLocalAmount": 0.0,
"purchaseTaxUSDAmount": 0.0,
"purchaseTaxLocalAmount": 0.0
},
],
"TotalCount": 1,
"DataFreshnessTimestamp": "2022-07-29T08:42:00"
}
샘플 요청
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?applicationId=9NBLGGGZ5QDR&startDate=8/1/2021&endDate=12/21/2021&skip=0&filter=market&groupby=date,applicationName,acquisitionType,ageGroup,storeClient,gender,market,osVersion,deviceType HTTP/1.1
Authorization: Bearer <your access token>
샘플 응답
{
"Value": [
{
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"acquisitionType": "Free",
"storeClient": "Microsoft Store (client)",
"gender": "f",
"market": "TW",
"osVersion": "Windows 10",
"deviceType": "PC",
"date": "2021-08-01",
"acquisitionQuantity": 1,
"purchasePriceUSDAmount": 0.0,
"purchasePriceLocalAmount": 0.0,
"purchaseTaxUSDAmount": 0.0,
"purchaseTaxLocalAmount": 0.0
},
{
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"acquisitionType": "Free",
"storeClient": "Microsoft Store (client)",
"gender": "Unknown",
"market": "BR",
"osVersion": "Windows 10",
"deviceType": "PC",
"date": "2021-08-01",
"acquisitionQuantity": 1,
"purchasePriceUSDAmount": 0.0,
"purchasePriceLocalAmount": 0.0,
"purchaseTaxUSDAmount": 0.0,
"purchaseTaxLocalAmount": 0.0
},
],
"TotalCount": 2,
"DataFreshnessTimestamp": "2022-07-29T08:42:00"
}