채널별 추가 기능 변환 가져오기

아티클
07/05/2024

Microsoft Store 분석 API에서 이 메서드를 사용하여 지정된 날짜 범위 및 다른 선택 필터 동안 추가 기능 채널별 집계 변환을 가져옵니다.

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

이 정보는 파트너 센터의 추가 기능 취득 보고서에서도 볼 수 있습니다.

필수 조건

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

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

Request

요청 구문

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

요청 헤더

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

요청 매개 변수

매개 변수	형식	설명	필수
applicationId	문자열	추가 기능 변환 데이터를 검색하고자 하는 앱의 Store ID. 예를 들어 Store ID는 9WZDNCRFJ3Q8입니다.	예
inAppProductId	문자열	변환 데이터를 검색하고자 하는 추가 기능의 Store ID.	예
startDate	date	검색할 변환 데이터 날짜 범위의 시작 날짜입니다. 기본값은 1/1/2016입니다.	아니요
endDate	date	검색할 변환 데이터 날짜 범위의 종료 날짜입니다. 기본값은 현재 날짜입니다.	아니요
top	int	요청에서 반환할 데이터 행의 수. 지정되지 않은 경우 최댓값 및 기본값은 10000입니다. 쿼리에 행이 더 있는 경우, 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 응답 본문에 포함됩니다.	아니요
skip	int	쿼리에서 건너뛸 행 수. 이 매개 변수를 사용하여 큰 데이터 집합을 페이징합니다. 예를 들어 top=10000 및 skip=0은 데이터의 첫 10000행을 검색하고 top=10000 및 skip=10000은 데이터의 그 다음 10000행을 검색하는 식으로 이어집니다.	아니요
필터	문자열	응답 본문을 필터링하는 하나 이상의 문장. 각 문은 eq 또는 ne 연산자를 사용할 수 있으며, 문은 and 또는 or을 사용하여 결합될 수 있습니다. 다음의 문자열을 필터 문에서 지정할 수 있습니다. 설명은 이 문서의 변환 값을 참조하세요. applicationName appType customCampaignId referrerUriDomain channelType storeClient deviceType 시장 다음은 필터 매개 변수의 예시입니다. filter=deviceType eq 'PC'.	아니요
aggregationLevel	문자열	집계 데이터를 검색할 시간 범위를 지정합니다. 일 문자열, 주 문자열 또는 월 문자열 중 하나일 수 있습니다. 지정하지 않으면 기본값이 일이 됩니다.	아니요
orderby	문자열	각 변환에 대한 결과 데이터 값의 순서를 지정하는 문. 구문은 orderby=field [order],field [order],...입니다. 필드 매개 변수는 다음 문자열 중 하나일 수 있습니다. date applicationName inAppProductName appType customCampaignId referrerUriDomain channelType storeClient deviceType 시장 order 매개 변수는 옵션이며 각 필드를 asc 또는 desc로 오름차순 또는 내림차순으로 지정할 수 있습니다. 기본값은 asc입니다. 다음은 orderby 문자열의 예시입니다. orderby=date,market	아니요
groupby	문자열	지정된 필드에만 데이터 집계를 적용하는 문. 다음과 같은 필드를 지정할 수 있습니다. date applicationName inAppProductName appType customCampaignId referrerUriDomain channelType storeClient deviceType 시장 반환된 데이터 행에는 groupby 매개 변수에 지정된 필드와 다음이 포함됩니다. date applicationId inAppProductId inAppProductName conversionCount clickCount groupby 매개 변수는 aggregationLevel 매개 변수와 함께 사용할 수 있습니다. 예시: groupby=ageGroup,market&aggregationLevel=week	아니요

요청 예시

다음 예제는 앱 변환 데이터를 가져오는 데 필요한 몇 가지 요청을 보여 줍니다. applicationId 값을 앱의 Store ID로 바꿉니다.

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

응답

응답 본문

값	형식	설명
값	배열	추가 기능의 변환 데이터가 포함된 개체의 배열. 각 개체의 데이터에 대한 자세한 정보는 아래 변환 값 섹션을 참조하세요.
@nextLink	문자열	추가적인 데이터 페이지가 있는 경우, 다음 데이터 페이지를 요청하는 데 사용할 수 있는 URI가 이 문자열에 포함됩니다. 예를 들어 요청의 top 매개 변수가 10으로 설정되어 있지만 쿼리에 대한 변환 데이터의 행이 10개보다 많은 경우 이 값이 반환됩니다.
TotalCount	int	쿼리에 대한 데이터 결과의 총 행 수.

변환 값

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

값	형식	설명
date	문자열	변환 데이터에 대한 날짜 범위의 시작 날짜. 요청에서 하루를 지정한 경우 이 값은 해당 날짜입니다. 요청에서 주, 월 또는 다른 날짜 범위를 지정한 경우 이 값은 해당 날짜 범위의 첫 번째 날짜입니다.
inAppProductId	문자열	변환 데이터를 검색할 추가 기능의 Store ID.
inAppProductName	문자열	변환 데이터를 검색한 추가 기능의 표시 이름.
applicationId	문자열	변환 데이터를 검색할 앱의 Store ID.
applicationName	문자열	변환 데이터를 검색할 앱의 표시 이름.
appType	문자열	변환 데이터를 검색할 앱의 제품 유형. 이 메서드는 추가 기능 값만 지원합니다.
customCampaignId	문자열	앱과 연결된 사용자 지정 앱 프로모션 캠페인의 ID 문자열.
referrerUriDomain	문자열	사용자 지정 앱 프로모션 캠페인 ID를 가진 앱 목록이 활성화되어 있는 도메인을 지정합니다.
channelType	문자열	변환 채널을 지정하는 문자열은 다음 중 하나입니다. CustomCampaignId Store Traffic 기타
storeClient	문자열	변환이 발생한 Store의 버전. 현재는 SFC 값만 지원합니다.
deviceType	문자열	다음의 문자열 중 하나입니다. PC 전화 콘솔-Xbox One 콘솔-Xbox 시리즈 X IoT Holographic 알 수 없음
시장	문자열	변환이 발생한 시장의 ISO 3166 국가 번호.
clickCount	수	앱 목록 링크를 클릭한 고객의 수.
conversionCount	수	고객 변환 수.

요청 및 응답 예제

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

샘플 요청

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappchannelconversions?applicationId=9NBLGGGZ5QDR&startDate=12/19/2019&endDate=12/20/2021&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

샘플 응답

{
    "Value": [
        {
            "inAppProductId": "9NN2HW33ZB2G",
            "applicationId": "9NBLGGGZ5QDR",
            "clickCount": 220636,
            "conversionCount": 154
        },
        {
            "inAppProductId": "9PN07J0WC18B",
            "applicationId": "9NBLGGGZ5QDR",
            "clickCount": 277061,
            "conversionCount": 187
        }
    ],
    "@nextLink": "",
    "TotalCount": 2
}

샘플 요청

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappchannelconversions?applicationId=9NBLGGGZ5QDR&startDate=12/19/2021&endDate=12/20/2021&top=10&skip=0&groupby=date,applicationName,inAppProductName,appType,customCampaignId,referrerUriDomain,channelType,storeClient,deviceType,market
HTTP/1.1
Authorization: Bearer <your access token>

샘플 응답

{
    "Value": [
        {
            "inAppProductId": "9WZDNCRCWW61",
            "inAppProductName": "SeasonPass0",
            "appType": "Add-On",
            "date": "2022-06-21",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "mcg_mahjong_othergames",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "BR",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW5H",
            "inAppProductName": "OEMFreePurchase",
            "appType": "Add-On",
            "date": "2022-07-06",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "mcg_solitaire_othergames",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "AT",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW5Z",
            "inAppProductName": "Episode1Combo",
            "appType": "Add-On",
            "date": "2022-07-09",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "vungle",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "CZ",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW5H",
            "inAppProductName": "OEMFreePurchase",
            "appType": "Add-On",
            "date": "2022-07-09",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "vungle",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "CZ",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW4Z",
            "inAppProductName": "Episode1Grandfathered",
            "appType": "Add-On",
            "date": "2022-07-11",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "|autosuggest",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "ES",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW5W",
            "inAppProductName": "Episode2Combo",
            "appType": "Add-On",
            "date": "2022-07-11",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "vungle",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "CZ",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW4P",
            "inAppProductName": "SeasonPass24",
            "appType": "Add-On",
            "date": "2022-07-12",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "vungle",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "CZ",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW5H",
            "inAppProductName": "OEMFreePurchase",
            "appType": "Add-On",
            "date": "2022-07-13",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "9wzdncrfjbd8",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "CA",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW61",
            "inAppProductName": "SeasonPass0",
            "appType": "Add-On",
            "date": "2022-07-17",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "scom-web-store",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "US",
            "clickCount": 1,
            "conversionCount": 1
        }
    ],
    "@nextLink": "",
    "TotalCount": 9
}

다음을 통해 공유

채널별 추가 기능 변환 가져오기

필수 조건

Request

요청 구문

요청 헤더

요청 매개 변수

요청 예시

응답

응답 본문

변환 값

요청 및 응답 예제

샘플 요청

샘플 응답

샘플 요청

샘플 응답

피드백

추가 리소스

다음을 통해 공유

채널별 추가 기능 변환 가져오기

필수 조건

Request

요청 구문

요청 헤더

요청 매개 변수

요청 예시

응답

응답 본문

변환 값

요청 및 응답 예제

샘플 요청

샘플 응답

샘플 요청

샘플 응답

관련 항목

피드백

추가 리소스