다음을 통해 공유

추가 기능 획득하기

Microsoft Store 분석 API에서 이 메서드를 사용하여 지정된 날짜 범위와 기타 선택적 필터를 지정하여 앱에 대한 애드온 집계 취득 데이터를 JSON 형식으로 가져옵니다. 이 정보는 파트너 센터의 추가 기능 구입 보고서에서 도 사용할 수 있습니다.

필수 조건

이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.

  • 아직 수행하지 않은 경우 Microsoft Store 분석 API에 대한 모든 필수 구성 요소를 완료합니다.
  • 이 메서드에 대한 요청 헤더에서 사용할 Azure AD 액세스 토큰을 가져옵니다. 액세스 토큰을 받은 후 60분 이내에 사용해야 합니다. 그렇지 않으면 만료됩니다. 토큰이 만료되면 새 토큰을 가져올 수 있습니다.

요청

요청 구문

메서드 URI 요청
가져오기 https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappacquisitions

요청 헤더

헤더 유형 설명
승인 문자열 필수 사항입니다. Azure AD 액세스 토큰은 Bearer<토큰> 형식입니다.

요청 매개 변수

applicationId 또는 inAppProductId 매개 변수가 필요합니다. 앱에 등록된 모든 추가 기능에 대한 취득 데이터를 검색하려면 applicationId 매개 변수를 지정합니다. 단일 추가 기능에 대한 취득 데이터를 검색하려면 inAppProductId 매개 변수를 지정합니다. 둘 다 지정하면 applicationId 매개 변수가 무시됩니다.

매개 변수 유형 설명 필수
애플리케이션 아이디 문자열 추가 기능 획득 데이터를 검색하려는 앱의 스토어 ID 입니다. 예
인앱상품ID 문자열 획득 데이터를 검색하려는 추가 기능의 스토어 ID . 예
시작 날짜 날짜 검색할 추가 기능 획득 데이터의 날짜 범위의 시작 날짜입니다. 기본값은 현재 날짜입니다. 아니오
종료일 날짜 검색하려는 추가 기능 취득 데이터의 날짜 범위 내 종료 날짜입니다. 기본값은 현재 날짜입니다. 아니오
맨 위로 정수 (int) 요청에 반환할 데이터 행 수입니다. 지정하지 않으면 최대값과 기본값은 10000입니다. 쿼리에 행이 더 있는 경우 응답 본문에는 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 포함됩니다. 아니오
건너뛰기 정수 (int) 쿼리에서 건너뛸 행의 수를 지정합니다. 이 매개변수를 사용하여 대량의 데이터 집합을 탐색하십시오. 예를 들어 top=10000 및 skip=0은 처음 10000개의 데이터 행을 검색하고 top=10000 및 skip=10000은 다음 10000개 행의 데이터 등을 검색합니다. 아니오
필터 문자열 응답의 행을 필터링하는 하나 이상의 구문이 있습니다. 자세한 내용은 아래 필터 필드 섹션을 참조하세요. 아니오
집계 수준 문자열 집계 데이터를 검색할 시간 범위를 지정합니다. 일, 주 또는 월 문자열 중 하나일 수 있습니다. 지정되지 않은 경우 기본값은 day입니다. 아니오
오더바이 (orderby) 문자열 각각의 추가 기능 획득에 대한 결과 데이터 값의 순서를 지정하는 구문입니다. 구문은 orderby=field [order], field [order],.... 필드 매개 변수는 다음 문자열 중 하나일 수 있습니다.
  • 날짜
  • 획득유형
  • 연령그룹
  • 스토어클라이언트
  • 성별
  • 시장
  • OSVersion
  • 장치유형
  • 주문 이름

order 매개 변수는 선택 사항이며 각 필드에 대해 오름차순 또는 내림차순을 지정하는 asc 또는 desc일 수 있습니다. 기본값은 asc입니다.

다음은 orderby 문자열의 예입니다. orderby=date,market

 아니오
그룹바이 문자열 지정된 필드에만 데이터 집계를 적용하는 문입니다. 다음 필드를 지정할 수 있습니다.
  • 날짜
  • 애플리케이션 이름
  • inApp제품 이름
  • 획득유형
  • 연령그룹
  • 스토어클라이언트
  • 성별
  • 시장
  • OSVersion
  • 장치유형
  • 주문 이름

반환된 데이터 행에는 groupby 매개 변수에 지정된 필드와 다음이 포함됩니다.

  • 날짜
  • 애플리케이션 ID
  • inAppProductId
  • 취득수량

groupby 매개 변수는 aggregationLevel 매개 변수와 함께 사용할 수 있습니다. 예: &groupby=ageGroup,market&aggregationLevel=week

 아니오

필터 필드

요청의 필터 매개 변수에는 응답의 행을 필터링하는 하나 이상의 문이 포함되어 있습니다. 각 문에는 eq 또는 ne 연산자와 연결된 필드와 값이 포함되며, 그리고 또는 또는을 사용하여 결합할 수 있습니다. 다음은 필터 매개변수의 예입니다.

  • 필터=시장 eq 'US' 및 성별 eq 'm'
  • filter=(market != 'US') and (gender != 'Unknown') and (gender != 'm') and (market != 'NO') and (나이대 != '55세 이상' or 나이대 != '13세 이하')

지원되는 필드 목록은 다음 표를 참조하세요. 문자열 값은 필터 매개 변수에서 작은따옴표로 묶어야 합니다.

분야 설명
취득 유형 다음 문자열 중 하나입니다.
  • 무료
  • 재판
  • 지불
  • 홍보 코드
  • IAP
연령 그룹 다음 문자열 중 하나입니다.
  • 13 미만
  • 13-17
  • 18-24
  • 25-34
  • 35-44
  • 44-55
  • 55보다 큼
  • 알려지지 않은
스토어 클라이언트 다음 문자열 중 하나입니다.
  • Windows Phone 스토어(클라이언트)
  • Microsoft Store(클라이언트)
  • Microsoft Store(웹)
  • 조직에서 대량 구매
  • 다른
성별 다음 문자열 중 하나입니다.
  • m
  • f
  • 알려지지 않은
시장 인수가 발생한 시장의 ISO 3166 국가 코드를 포함하는 문자열입니다.
운영체제 버전 다음 문자열 중 하나입니다.
  • 윈도우 폰 7.5
  • 윈도우 폰 8
  • 윈도우 폰 8.1
  • 윈도우 폰 10
  • 윈도우 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • 알려지지 않은
디바이스 유형 다음 문자열 중 하나입니다.
  • 개인용 컴퓨터
  • 전화
  • Console-Xbox 하나
  • Console-Xbox 시리즈 X
  • 사물 인터넷(IoT
  • 홀로그램
  • 알려지지 않은
주문 이름 추가 기능을 획득하는 데 사용된 홍보 코드의 주문 이름을 지정하는 문자열입니다(사용자가 홍보 코드를 사용하여 추가 기능을 획득한 경우에만 적용됨).

예제 요청

다음 예제에서는 추가 기능 획득 데이터를 가져오기 위한 여러 가지 요청을 보여줍니다. inAppProductId 및 applicationId 값을 추가 기능 또는 앱의 적절한 스토어 ID로 교체합니다.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappacquisitions?inAppProductId=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/inappacquisitions?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/inappacquisitions?inAppProductId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=7/3/2015&top=100&skip=0&filter=market ne 'US' and gender ne 'Unknown' and gender ne 'm' and market ne 'NO' and ageGroup ne '>55' HTTP/1.1
Authorization: Bearer <your access token>

응답

응답 메시지 본문

가치 유형 설명
가치 배열 추가 기능 획득 집계 데이터가 들어 있는 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 내용은 아래 의 추가 기능 획득 값 섹션을 참조하세요.
@nextLink 문자열 추가 데이터 페이지가 있는 경우 이 문자열에는 다음 데이터 페이지를 요청하는 데 사용할 수 있는 URI가 포함됩니다. 예를 들어 요청의 최상위 매개 변수가 10000으로 설정되어 있지만 쿼리에 대해 10000개 이상의 추가 기능 획득 데이터가 있는 경우 이 값이 반환됩니다.
총개수 정수 (int) 쿼리의 데이터 결과에 포함된 행의 총 개수입니다.

추가 기능 취득 가치

값 배열의 요소는 다음 값을 포함합니다.

가치 유형 설명
날짜 문자열 취득 데이터의 날짜 범위에서 첫 번째 날짜입니다. 요청이 1일을 지정한 경우 이 값은 해당 날짜입니다. 요청이 주, 월 또는 기타 날짜 범위를 지정한 경우 이 값은 해당 날짜 범위의 첫 번째 날짜입니다.
인앱상품ID 문자열 취득 데이터를 검색할 추가 기능의 스토어 ID입니다.
인앱상품이름 문자열 추가 기능의 표시 이름입니다. 이 값은 groupby 매개 변수에서 inAppProductName 필드를 지정하지 않는 한 aggregationLevel 매개 변수가일로 설정된 경우에만 응답 데이터에 나타납니다.
애플리케이션 아이디 문자열 추가 기능 획득 데이터를 검색하려는 앱의 스토어 ID입니다.
응용 프로그램 이름 문자열 앱의 표시 이름입니다.
디바이스 유형 문자열 취득을 완료한 디바이스의 유형입니다. 지원되는 문자열 목록은 위의 필터 필드 섹션을 참조하세요.
주문 이름 문자열 주문의 이름입니다.
스토어 클라이언트 문자열 구입이 발생한 스토어의 버전입니다. 지원되는 문자열 목록은 위의 필터 필드 섹션을 참조하세요.
운영체제 버전 문자열 획득이 발생한 OS 버전입니다. 지원되는 문자열 목록은 위의 필터 필드 섹션을 참조하세요.
시장 문자열 인수가 발생한 시장의 ISO 3166 국가 코드입니다.
성별 문자열 취득을 한 사용자의 성별입니다. 지원되는 문자열 목록은 위의 필터 필드 섹션을 참조하세요.
연령 그룹 문자열 취득을 한 사용자의 연령 그룹입니다. 지원되는 문자열 목록은 위의 필터 필드 섹션을 참조하세요.
취득 유형 문자열 취득 유형(무료, 유료 등)입니다. 지원되는 문자열 목록은 위의 필터 필드 섹션을 참조하세요.
획득 수량 정수 발생한 취득 건수입니다.

요청 및 응답 예제

다음 코드 조각은 해당 요청에 대한 예제 요청 및 JSON 응답 본문을 보여 줍니다.

샘플 요청

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappacquisitions?applicationId=9NBLGGGZ5QDR
HTTP/1.1
Authorization: Bearer <your access token>

예시 응답

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Deluxe Collector's Edition",
            "addonProductId": "9NBLGGAAGZDQ",
            "date": "2022-07-29",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 18.12,
            "purchasePriceLocalAmount": 18.12,
            "purchaseTaxUSDAmount": 1.13,
            "purchaseTaxLocalAmount": 1.13
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Episode 4",
            "addonProductId": "9NAAAAAAAAAQ",
            "date": "2017-01-07",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 4.147206,
            "purchasePriceLocalAmount": 3.99,
            "purchaseTaxUSDAmount": 0.686004,
            "purchaseTaxLocalAmount": 0.66
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Deluxe Collector's Edition",
            "addonProductId": "9NALGGGZ5QDQ",
            "date": "2018-04-01",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 1.99,
            "purchasePriceLocalAmount": 1.99,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Strategy Guide Episode 4",
            "addonProductId": "9NBLGGGZ5QDQ",
            "date": "2021-11-25",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 1.31902922876179,
            "purchasePriceLocalAmount": 150.0,
            "purchaseTaxUSDAmount": 0.114315866492689,
            "purchaseTaxLocalAmount": 13.0
        },
    ],
    "TotalCount": 4,
    "DataFreshnessTimestamp": "2022-07-29T05:54:00"
}

 

 

  • Last updated on