인사이트 데이터 가져오기

아티클
07/05/2024

Microsoft Store 분석 API에서 이 방법을 사용하여 지정된 날짜 범위 및 기타 선택적 필터링을 하는 동안 앱의 취득, 상태 및 사용량 메트릭과 관련된 인사이트 데이터를 가져옵니다. 이 정보는 파트너 센터의 인사이트 보고서에서도 볼 수 있습니다.

필수 조건

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

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

Request

요청 구문

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

요청 헤더

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

요청 매개 변수

매개 변수	형식	설명	필수
applicationId	문자열	인사이트 데이터를 검색할 앱의 Store ID입니다. 이 매개 변수를 지정하지 않으면 응답 본문에 계정에 등록된 모든 앱에 대한 인사이트 데이터가 포함됩니다.	아니요
startDate	date	검색할 인사이트 데이터 날짜 범위의 시작 날짜입니다. 기본값은 현재 날짜에서 30일 전입니다.	아니요
endDate	date	검색할 인사이트 데이터 날짜 범위의 종료 날짜입니다. 기본값은 현재 날짜입니다.	아니요
필터	문자열	응답의 행을 필터링하는 한 개 이상의 구문입니다. 각 명령문에는 응답 본문의 필드 이름 및 eq 또는 ne 연산자와 연결된 값이 포함되며, 명령문은 and 또는 or을 사용하여 결합될 수 있습니다. 문자열 값은 필터 매개 변수에서 단일 따옴표로 묶여야 합니다. 예시: filter=dataType eq 'acquisition'. 다음의 필터 필드를 지정할 수 있습니다. 취득 Health 사용량	예

요청 예시

다음의 예시는 인사이트 데이터 가져오기 요청을 보여 줍니다. applicationId 값을 앱의 Store ID로 바꿉니다.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights?applicationId=9NBLGGGZ5QDR&startDate=6/1/2018&endDate=6/15/2018&filter=dataType eq 'acquisition' or dataType eq 'health' HTTP/1.1
Authorization: Bearer <your access token>

응답

응답 본문

값	형식	설명
값	배열	앱에 대한 인사이트 데이터가 포함된 개체 배열입니다. 각 개체의 데이터에 대한 자세한 정보는 아래의 인사이트 값 섹션을 참조하세요.
TotalCount	int	쿼리에 대한 데이터 결과의 총 행 수.

인사이트 값

값 배열의 요소에는 다음의 값이 포함됩니다.

값	형식	설명
applicationId	문자열	인사이트 데이터를 검색하는 앱의 Store ID입니다.
insightDate	문자열	특정 메트릭의 변경 내용을 식별한 날짜입니다. 이 날짜는 그 이전 주와 비교하여 메트릭에서 상당한 증가 또는 감소가 검색된 한 주의 마지막 날을 나타냅니다.
dataType	문자열	이 인사이트가 설명하는 일반 분석 영역을 지정하는 다음 문자열 중 하나입니다. 취득 Health 사용량
insightDetail	배열	현재 인사이트에 대한 세부 정보를 나타내는 하나 이상의 InsightDetail values입니다.

InsightDetail values

값	형식	설명
FactName	문자열	dataType 값을 기반으로 현재 인사이트 또는 현재 차원이 설명하는 메트릭을 나타내는 다음의 값 중 하나입니다. health의 경우, 이 값은 항상 HitCount입니다. 취득의 경우, 이 값은 항상 AcquisitionQuantity입니다. 사용량의 경우 이 값은 다음 문자열 중 하나일 수 있습니다. DailyActiveUsers EngagementDurationMinutes DailyActiveDevices DailyNewUsers DailySessionCount
SubDimensions	배열	인사이트에 대한 단일 메트릭을 설명하는 하나 이상의 개체입니다.
PercentChange	문자열	전체 고객 기반에서 메트릭이 변경된 비율입니다.
DimensionName	문자열	현재 차원에 설명된 메트릭의 이름입니다. 예시로는 EventType, Market, DeviceType, PackageVersion, AcquisitionType, AgeGroup 및 Gender가 있습니다.
DimensionValue	문자열	현재 차원에 설명된 메트릭 값입니다. 예를 들어 DimensionName이 EventType인 경우, DimensionValue는 crash 또는 hang일 수 있습니다.
FactValue	문자열	인사이트가 검색된 날짜의 메트릭 절대값입니다.
방향	문자열	변경 방향(Positive 또는 Negative)입니다.
날짜	문자열	현재 인사이트 또는 현재 차원과 관련된 변경 내용을 식별한 날짜입니다.

참고

검색된 인사이트 변경 내용은 최근 30일간의 취득, health 및/또는 사용량 데이터에만 적용됩니다.

요청 및 응답 예제

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

샘플 요청

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights?applicationId=9NBLGGGZ5QDR&startDate=7/12/2022&endDate=7/29/2022&filter=dataType eq 'acquisition' or dataType eq 'health'
HTTP/1.1
Authorization: Bearer <your access token>

샘플 응답

{
    "Value": [
        {
            "id": "8cdb672c7893bd33a3dec48ededdc676602a1361f3209ab4f3e0982672fc198f",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-27T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-27 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "DeviceType",
                            "DimensionValue": "Tablet",
                            "Date": "2022-07-27 00:00:00",
                            "Direction": "Positive",
                            "PercentChange": 16.091954022988507,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 28.0
                        }
                    ]
                }
            ]
        },
        {
            "id": "6b8849ecb043c6e5ecdd1c20040c0a371e9ab176eff77f7312b0489e19379225",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-26T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-26 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "DeviceType",
                            "DimensionValue": "Tablet",
                            "Date": "2022-07-26 00:00:00",
                            "Direction": "Positive",
                            "PercentChange": 28.048780487804876,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 30.0
                        }
                    ]
                }
            ]
        },
        {
            "id": "93115e855fec507385bab17251f49c33bcbc1b62c603e5c7863e327ba94bf160",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-20T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-20 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "Market",
                            "DimensionValue": "GB",
                            "Date": "2022-07-20 00:00:00",
                            "Direction": "Negative",
                            "PercentChange": 3.3035714285714284,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 158.0
                        }
                    ]
                }
            ]
        },
        {
            "id": "4814abe710042a2798b453d8821909c246c389dde814e6678da7189211410604",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-24T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-24 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "Market",
                            "DimensionValue": "DO",
                            "Date": "2022-07-24 00:00:00",
                            "Direction": "Negative",
                            "PercentChange": 13.533834586466165,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 8.0
                        }
                    ]
                }
            ]
        },
        {
            "id": "7941070bb17904f3ef4e19de9659110cb52e18ecfb637ad724e2da749445a860",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-21T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-21 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "Market",
                            "DimensionValue": "AT",
                            "Date": "2022-07-21 00:00:00",
                            "Direction": "Positive",
                            "PercentChange": 0.0,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 17.0
                        }
                    ]
                },
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-21 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "Market",
                            "DimensionValue": "SE",
                            "Date": "2022-07-21 00:00:00",
                            "Direction": "Negative",
                            "PercentChange": 21.686746987951807,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 5.0
                        }
                    ]
                }
            ]
        },
        {
            "id": "55905f5458617b65669eb115cc28ebd7296841bd2ff3f8e2546ade1d5e93f68d",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-13T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-13 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "Market",
                            "DimensionValue": "LK",
                            "Date": "2022-07-13 00:00:00",
                            "Direction": "Negative",
                            "PercentChange": 11.111111111111111,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 9.0
                        }
                    ]
                }
            ]
        },
        {
            "id": "9ce9317bf4d0f903de51a49d00a07cf4b4a8ac4457fd1e2886493bd38ceac0b7",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-19T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "Acquisition",
                    "DimensionValue": "Free",
                    "Date": "2022-07-19 00:00:00",
                    "Direction": "Negative",
                    "PercentChange": 12.188725230475788,
                    "FactName": "AcquisitionQuantity",
                    "FactQuantity": 2470,
                    "SubDimensions": []
                }
            ]
        }
    ],
    "TotalCount": 7
}

다음을 통해 공유

인사이트 데이터 가져오기

필수 조건

Request

요청 구문

요청 헤더

요청 매개 변수

요청 예시

응답

응답 본문

인사이트 값

InsightDetail values

요청 및 응답 예제

샘플 요청

샘플 응답

피드백

추가 리소스

다음을 통해 공유

인사이트 데이터 가져오기

필수 조건

Request

요청 구문

요청 헤더

요청 매개 변수

요청 예시

응답

응답 본문

인사이트 값

InsightDetail values

요청 및 응답 예제

샘플 요청

샘플 응답

관련 항목

피드백

추가 리소스