다음을 통해 공유

앱 취득 깔때기 데이터 가져오기

  • 아티클

Microsoft Store 분석 API에서 이 메서드를 사용하여 지정된 날짜 범위 및 다른 선택 필터 동안 애플리케이션의 취득 깔때기 데이터를 가져옵니다. 이 정보는 파트너 센터의 취득 보고서에서도 볼 수 있습니다.

필수 조건

이 메서드를 사용하려면 먼저 다음 방법대로 해야 합니다.

  • 아직 완료하지 않은 경우 Microsoft Store 분석 API에 대한 모든 필수 조건을 완료합니다.
  • 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져오세요. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.

Request

요청 구문

메서드 요청 URI
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel

요청 헤더

헤더 형식 설명
권한 부여 string 필수. Bearer<토큰> 형식의 Azure AD 액세스 토큰.

요청 매개 변수

매개 변수 형식 설명 필수
applicationId 문자열 취득 깔때기 데이터 검색을 원하는 앱의 Store ID. 예를 들어 Store ID는 9WZDNCRFJ3Q8입니다. 예
startDate date 검색할 취득 깔때기 데이터의 날짜 범위에서 시작 날짜입니다. 기본값은 현재 날짜입니다. 아니요
endDate date 검색할 취득 깔때기 데이터의 날짜 범위에서 종료 날짜입니다. 기본값은 현재 날짜입니다. 아니요
필터 문자열 응답의 행을 필터링하는 하나 이상의 문. 자세한 정보는 아래의 필터 필드 섹션을 참조하세요. 아니요

 

필터 필드

요청의 필터 매개 변수는 응답의 행을 필터링하는 하나 이상의 문을 포함합니다. 각 문에는 eq 또는 ne 연산자와 연결된 필드 및 값이 포함되며 and 또는 or를 사용하여 문을 결합할 수 있습니다.

다음의 필터 필드를 지원합니다. 문자열 값은 필터 매개 변수에서 단일 따옴표로 묶여야 합니다.

필드 설명
campaignId 취득과 연결된 사용자 지정 앱 프로 모션 캠페인의 ID 문자열.
시장 취득이 발생한 시장의 ISO 3166 국가 코드를 포함하는 문자열.
deviceType 다음은 취득이 발생한 디바이스 유형을 나타내는 문자열 중 하나입니다.
  • PC
  • 전화
  • 콘솔-Xbox One
  • 콘솔-Xbox 시리즈 X
  • IoT
  • Holographic
  • 알 수 없음
ageGroup 다음은 취득을 완료한 사용자 연령 그룹을 나타내는 문자열 중 하나입니다.
  • 0 – 17
  • 18 – 24
  • 25 – 34
  • 35 – 49
  • 50 이상
  • 알 수 없음
gender 다음은 취득을 완료한 사용자의 성별을 나타내는 문자열 중 하나입니다.
  • 남성
  • 여성
  • 알 수 없음

요청 예시

다음 예제는 앱에 대한 취득 깔때기 데이터를 가져오는 데 필요한 몇 가지 요청을 보여 줍니다. applicationId 값을 앱의 Store ID로 바꿉니다.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=1/1/2017&endDate=2/1/2017  HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=8/1/2016&endDate=8/31/2016&filter=market eq 'US' and gender eq 'm'  HTTP/1.1
Authorization: Bearer <your access token>

응답

응답 본문

값 형식 설명
값 배열 앱의 취득 깔때기 데이터가 포함된 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 정보는 아래의 깔때기 값 섹션을 참조하세요.
TotalCount int 값 배열의 개체 수 총계.

깔때기 값

값 배열의 개체에는 다음의 값이 포함됩니다.

값 형식 설명
MetricType 문자열 다음은 이 개체에 포함된 깔때기 데이터 형식을 지정한 문자열 중 하나입니다.
  • PageView
  • 취득
  • 설치
  • 사용량
UserCount 문자열 MetricType 값이 지정한 깔때기 단계를 수행할 수 있는 사용자의 수입니다.

요청 및 응답 예제

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

샘플 요청

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

샘플 응답

{
    "Value": [
        {
            "MetricType": "PageView",
            "UserCount": 6214
        },
        {
            "MetricType": "Acquisition",
            "UserCount": 1502
        },
        {
            "MetricType": "Usage",
            "UserCount": 606
        },
        {
            "MetricType": "Install",
            "UserCount": 977
        }
    ],
    "TotalCount": 4
}

샘플 요청

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=12/19/2021&endDate=12/21/2021&filter=market eq 'US' and gender eq 'm'
HTTP/1.1
Authorization: Bearer <your access token>

샘플 응답

{
    "Value": [
        {
            "MetricType": "PageView",
            "UserCount": 10
        },
        {
            "MetricType": "Acquisition",
            "UserCount": 8
        },
        {
            "MetricType": "Usage",
            "UserCount": 5
        },
        {
            "MetricType": "Install",
            "UserCount": 3
        }
    ],
    "TotalCount": 4
}