다음을 통해 공유

앱 획득 전환 경로 데이터 확인하기

Microsoft Store 분석 API에서 이 메서드를 사용하여 지정된 날짜 범위와 선택적 필터로 애플리케이션에 대한 획득 퍼널 데이터를 가져옵니다. 이 정보는 파트너 센터의 인수 보고서에서도 확인할 수 있습니다.

필수 조건

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

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

요청

요청 구문

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

요청 헤더

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

요청 매개 변수

매개 변수 유형 설명 필수
애플리케이션 아이디 문자열 데이터 획득 경로를 검색하려는 앱의 스토어 ID 은입니다. 예를 들어 스토어 ID는 9WZDNCRFJ3Q8입니다. 예
시작 날짜 날짜 조회할 획득 깔때기 데이터의 날짜 범위의 시작일입니다. 기본값은 현재 날짜입니다. 아니오
종료일 날짜 검색하려는 취득 깔때기 데이터의 날짜 범위 중 종료 날짜입니다. 기본값은 현재 날짜입니다. 아니오
필터 문자열 응답의 행을 필터링하는 하나 이상의 구문이 있습니다. 자세한 내용은 아래 필터 필드 섹션을 참조하세요. 아니오

 

필터 필드

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

다음 필터 필드가 지원됩니다. 문자열 값은 필터 매개 변수에서 작은따옴표로 묶어야 합니다.

분야 설명
캠페인ID 사용자 지정 앱 승격 캠페인의 ID 문자열은 구입과 관련된.
시장 인수가 발생한 시장의 ISO 3166 국가 코드를 포함하는 문자열입니다.
디바이스 유형 취득이 발생한 디바이스 유형을 지정하는 다음 문자열 중 하나입니다.
  • 개인용 컴퓨터
  • 전화
  • Console-Xbox One
  • 콘솔-Xbox 시리즈 X
  • 사물 인터넷(IoT
  • 홀로그램
  • 알 수 없음
연령 그룹 취득을 완료한 사용자의 연령 그룹을 지정하는 다음 문자열 중 하나입니다.
  • 0 - 17
  • 18 – 24
  • 25 - 34
  • 35 - 49
  • 50 이상
  • 알 수 없음
성별 취득을 완료한 사용자의 성별을 지정하는 다음 문자열 중 하나입니다.
  • M
  • F
  • 알 수 없음

예제 요청

다음 예제에서는 앱에 대한 획득 퍼널 데이터를 가져오기 위한 몇 가지 요청을 설명합니다. applicationId 값을 앱의 스토어 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>

응답

응답 메시지 본문

가치 유형 설명
가치 배열 앱의 유입 경로 데이터를 포함하는 객체 배열입니다. 각 개체의 데이터에 대한 자세한 내용은 아래 깔때기형 값 섹션을 참조하세요.
총개수 정수 (int) 값 배열의 총 개체 수입니다.

단계 값

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

가치 유형 설명
측정 유형 문자열 이 개체에 포함된 깔때기 데이터 형식을 지정하는 다음 문자열 중 하나입니다.
  • PageView
  • 취득
  • 설치
  • 사용법
사용자 수 문자열 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
}
  • Last updated on