채널별 앱 변환 가져오기

Microsoft Store 분석 API에서 이 메서드를 사용하여 지정된 날짜 범위 및 기타 선택적 필터 동안 애플리케이션에 대한 채널별 집계 변환을 가져옵니다.

• 변환 고객(Microsoft 계정으로 로그인)이 앱에 대한 라이선스를 새로 획득했음을 의미합니다(요금을 청구했거나 무료로 제공했는지 여부).
• 고객이 앱의 목록 페이지에 도달한 방법은 채널을 통해서입니다(예: 스토어 또는 사용자 지정 앱 프로모션 캠페인).

이 정보는 파트너 센터의 인수 보고서에서도 확인할 수 있습니다.

필수 조건

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

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

요청

요청 구문

요청 헤더

요청 매개 변수

예제 요청

다음 예제에서는 앱 변환 데이터를 가져오기 위한 몇 가지 요청을 보여 줍니다. applicationId 값을 앱의 스토어 ID로 바꿉니다.

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

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appchannelconversions?applicationId=9NBLGGGZ5QDR&startDate=1/1/2017&endDate=4/31/2017&skip=0&filter=market eq 'US'  HTTP/1.1
Authorization: Bearer <your access token>

응답

응답 메시지 본문

변환 값

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

요청 및 응답 예제

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

샘플 요청

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appchannelconversions?applicationId=9NBLGGGZ5QDR&startDate=06/23/2022&endDate=07/21/2022&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

예시 응답

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "clickCount": 3089,
            "conversionCount": 14
        }
    ],
    "@nextLink": "",
    "TotalCount": 1
}

샘플 요청

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appchannelconversions?applicationId=9NBLGGGZ5QDR&startDate=06/19/2022&endDate=07/21/2022&skip=0&groupby=date,applicationName,customCampaignId,referrerUriDomain,channelType,storeClient,deviceType,market&filter=market eq 'US'
HTTP/1.1
Authorization: Bearer <your access token>

예시 응답

{
    "Value": [
        {
            "date": "2022-06-19",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "",
            "referrerUriDomain": "Universal Client Store",
            "channelType": "Store Traffic",
            "storeClient": "SFC",
            "deviceType": "PC",
            "market": "US",
            "clickCount": 13,
            "conversionCount": 0
        },
        {
            "date": "2022-06-20",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "",
            "referrerUriDomain": "Universal Client Store",
            "channelType": "Store Traffic",
            "storeClient": "SFC",
            "deviceType": "PC",
            "market": "US",
            "clickCount": 6,
            "conversionCount": 0
        },
        {
            "date": "2022-06-21",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "",
            "referrerUriDomain": "Universal Client Store",
            "channelType": "Store Traffic",
            "storeClient": "SFC",
            "deviceType": "PC",
            "market": "US",
            "clickCount": 4,
            "conversionCount": 0
        },
        {
            "date": "2022-06-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "",
            "referrerUriDomain": "Universal Client Store",
            "channelType": "Store Traffic",
            "storeClient": "SFC",
            "deviceType": "PC",
            "market": "US",
            "clickCount": 4,
            "conversionCount": 0
        },
    ],
    "@nextLink": "",
    "TotalCount": 4
}

관련 항목

• 인수 보고서
• Microsoft Store 서비스를 사용하여 분석 데이터에 액세스
• 앱 인수하기