다음을 통해 공유

데스크톱 애플리케이션에 대한 인사이트 데이터 가져오기

  • 아티클

Microsoft Store 분석 API에서 이 방법을 사용하여 Windows 데스크톱 애플리케이션 프로그램에 추가한 데스크톱 애플리케이션의 health 메트릭과 관련된 인사이트 데이터를 가져옵니다. 이 데이터는 파트너 센터의 데스크톱 애플리케이션에 대한 Health 보고서에서도 볼 수 있습니다.

필수 조건

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

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

Request

요청 구문

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

요청 헤더

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

요청 매개 변수

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

현재 이 메서드는 health 필터만 지원합니다.

 아니요

요청 예시

다음 예시는 인사이트 데이터 가져오기 요청을 보여 줍니다. applicationId 값을 데스크톱 애플리케이션에 적절한 값으로 바꿉니다.

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

응답

응답 본문

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

인사이트 값

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

값 형식 설명
applicationId 문자열 인사이트 데이터를 검색한 데스크톱 애플리케이션의 제품 ID입니다.
insightDate 문자열 특정 메트릭의 변경 내용을 식별한 날짜입니다. 이 날짜는 그 이전 주와 비교하여 메트릭에서 상당한 증가 또는 감소가 검색된 한 주의 마지막 날을 나타냅니다.
dataType 문자열 이 인사이트가 알려주는 일반 분석 영역을 지정하는 문자열입니다. 현재 이 메서드는 health만 지원합니다.
insightDetail 배열 현재 인사이트에 대한 세부 정보를 나타내는 하나 이상의 InsightDetail values입니다.

InsightDetail values

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

응답 예시

다음의 예시는 이 요청의 JSON 응답 본문 예시를 보여 줍니다.

{
  "Value": [
    {
      "applicationId": "9NBLGGGZ5QDR",
      "insightDate": "2018-06-03T00:00:00",
      "dataType": "health",
      "insightDetail": [
        {
          "FactName": "HitCount",
          "SubDimensions": [
            {
              "FactName:": "HitCount",
              "PercentChange": "21",
              "DimensionValue:": "DE",
              "FactValue": "109",
              "Direction": "Positive",
              "Date": "6/3/2018 12:00:00 AM",
              "DimensionName": "Market"
            }
          ],
          "DimensionValue": "crash",
          "Date": "6/3/2018 12:00:00 AM",
          "DimensionName": "EventType"
        },
        {
          "FactName": "HitCount",
          "SubDimensions": [
            {
              "FactName:": "HitCount",
              "PercentChange": "71",
              "DimensionValue:": "JP",
              "FactValue": "112",
              "Direction": "Positive",
              "Date": "6/3/2018 12:00:00 AM",
              "DimensionName": "Market"
            }
          ],
          "DimensionValue": "hang",
          "Date": "6/3/2018 12:00:00 AM",
          "DimensionName": "EventType"
        },
      ],
      "insightId": "9CY0F3VBT1AS942AFQaeyO0k2zUKfyOhrOHc0036Iwc="
    }
  ],
  "@nextLink": null,
  "TotalCount": 2
}