Insights 데이터 가져오기Get insights data

사용 하 여 지정된 된 날짜 범위 및 다른 선택적 필터 중 획득, 상태 및 앱에 대 한 사용 메트릭을 관련 insights 데이터를 가져올 수 있도록 Microsoft Store 분석 API에서에서이 메서드.Use this method in the Microsoft Store analytics API to get insights data related to acquisitions, health, and usage metrics for an app during a given date range and other optional filters. 이 정보를 사용할 수 있습니다 합니다 Insights 보고서 파트너 센터에서.This information is also available in the Insights report in Partner Center.

필수 구성 요소Prerequisites

이 메서드를 사용하려면 다음을 먼저 수행해야 합니다.To use this method, you need to first do the following:

  • 아직 완료하지 않은 경우 Microsoft Store 분석 API에 대한 모든 필수 조건을 완료합니다.If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져옵니다.Obtain an Azure AD access token to use in the request header for this method. 액세스 토큰을 얻은 후 만료되기 전에 60분 동안 사용할 수 있습니다.After you obtain an access token, you have 60 minutes to use it before it expires. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.After the token expires, you can obtain a new one.

요청Request

요청 구문Request syntax

메서드Method 요청 URIRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights

요청 헤더Request header

헤더Header 형식Type 설명Description
권한 부여Authorization 문자열string 필수.Required. 폼에서 Azure AD 액세스 토큰 전달자 < 토큰>합니다.The Azure AD access token in the form Bearer <token>.

요청 매개 변수Request parameters

매개 변수Parameter 형식Type 설명Description 필수Required
applicationIdapplicationId 문자열string 합니다 Store ID insights 데이터를 검색 하려는 앱입니다.The Store ID of the app for which you want to retrieve insights data. 이 매개 변수를 지정 하지 않으면 하는 경우 응답 본문에는 계정에 등록 된 모든 앱에 대 한 정보 데이터가 포함 됩니다.If you do not specify this parameter, the response body will contain insights data for all apps registered to your account. 아니오No
startDatestartDate datedate 검색할 insights 데이터의 날짜 범위의 시작 날짜입니다.The start date in the date range of insights data to retrieve. 기본값은 현재 날짜보다 30일 전입니다.The default is 30 days before the current date. 아니오No
endDateendDate datedate 검색할 insights 데이터의 날짜 범위의 종료 날짜입니다.The end date in the date range of insights data to retrieve. 기본값은 현재 날짜입니다.The default is the current date. 아니오No
filterfilter 문자열string 응답에서 행을 필터링하는 하나 이상의 문입니다.One or more statements that filter the rows in the response. 각 문에는 응답 본문의 필드 이름 및 eq 또는 ne 연산자와 연결된 값이 포함되어 있으며 문은 and 또는 or를 사용하여 결합될 수 있습니다.Each statement contains a field name from the response body and value that are associated with the eq or ne operators, and statements can be combined using and or or. 문자열 값은 filter 매개 변수에서 단일 따옴표로 묶여야 합니다.String values must be surrounded by single quotes in the filter parameter. 예를 들어 필터 dataType eq '구입' = 합니다.For example, filter=dataType eq 'acquisition'.

다음 필터 필드를 지정할 수 있습니다.You can specify the following filter fields:

  • 취득acquisition
  • 상태health
  • 사용 현황usage
아니오No

요청 예제Request example

다음 예제에서는 insights 데이터를 가져오기 위한 요청을 보여 줍니다.The following example demonstrates a request for getting insights data. applicationId 값을 앱의 스토어 ID로 바꿉니다.Replace the applicationId value with the Store ID for your app.

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>

응답Response

응답 본문Response body

Value 형식Type 설명Description
Value 배열array 앱에 대 한 insights 데이터를 포함 하는 개체의 배열입니다.An array of objects that contain insights data for the app. 각 개체의 데이터에 대 한 자세한 내용은 참조는 Insight 값 섹션 아래.For more information about the data in each object, see the Insight values section below.
TotalCountTotalCount intint 쿼리에 대한 데이터 결과에 있는 행의 총 수입니다.The total number of rows in the data result for the query.

정보 값Insight values

배열의 요소에는 다음 값이 포함됩니다.Elements in the Value array contain the following values.

Value 형식Type 설명Description
applicationIdapplicationId 문자열string Insights 데이터를 검색 하는 앱의 Store ID입니다.The Store ID of the app for which you are retrieving insights data.
insightDateinsightDate 문자열string 특정 메트릭이 변경을 식별 하는 날짜입니다.The date on which we identified the change in a specific metric. 이 날짜는 상당한 증가 감지 하는 주 끝을 나타내는 또는 이전 주에 비해 메트릭이 감소 합니다.This date represents the end of the week in which we detected a significant increase or decrease in a metric compared to the week before that.
데이터 형식dataType 문자열string 이 정보를 설명 하는 일반 분석 영역을 지정 하는 다음 문자열 중 하나입니다.One of the following strings that specifies the general analytics area that this insight describes:

  • 취득acquisition
  • 상태health
  • 사용 현황usage
insightDetailinsightDetail 배열array 하나 이상의 InsightDetail 값 현재 정보에 대 한 세부 정보를 나타냅니다.One or more InsightDetail values that represent the details for current insight.

InsightDetail 값InsightDetail values

Value 형식Type 설명Description
FactNameFactName 문자열string 에 따라 현재 정보 또는 현재 차원에 설명 하는 메트릭을 표시 하는 다음 값 중 하나는 dataType 값입니다.One of the following values that indicates the metric that the current insight or current dimension describes, based on the dataType value.
  • 에 대 한 health,이 값은 항상 히트 카운트합니다.For health, this value is always HitCount.
  • 에 대 한 취득,이 값은 항상 구매 수량합니다.For acquisition, this value is always AcquisitionQuantity.
  • 에 대 한 사용량,이 값 다음 문자열 중 하나일 수 있습니다.For usage, this value can be one of the following strings:
    • dailyActiveUsersDailyActiveUsers
    • engagementDurationMinutesEngagementDurationMinutes
    • dailyActiveDevicesDailyActiveDevices
    • dailyNewUsersDailyNewUsers
    • dailySessionCountDailySessionCount
SubDimensionsSubDimensions 배열array 해당 정보에 대 한 단일 메트릭을 설명 하는 하나 이상의 개체입니다.One or more objects that describe a single metric for the insight.
PercentChangePercentChange 문자열string 전체 고객 기반에서 메트릭을 변경 비율입니다.The percentage that the metric changed across your entire customer base.
DimensionNameDimensionName 문자열string 현재 차원에 설명 된 메트릭의 이름입니다.The name of the metric described in the current dimension. 예를 들면 EventType, 시장DeviceTypePackageVersion, AcquisitionType하십시오 연령대 하 고 성별합니다.Examples include EventType, Market, DeviceType, PackageVersion, AcquisitionType, AgeGroup and Gender.
DimensionValueDimensionValue 문자열string 현재 차원에 설명 된 메트릭 값입니다.The value of the metric that is described in the current dimension. 예를 들어 경우 DimensionNameEventType, DimensionValue 않을 크래시 또는 중단 .For example, if DimensionName is EventType, DimensionValue might be crash or hang.
FactValueFactValue 문자열string 정보가 검색 된 날짜에서 메트릭의 절대 값입니다.The absolute value of the metric on the date the insight was detected.
방향Direction 문자열string 변경의 방향 (양의 하거나 음수).The direction of the change (Positive or Negative).
날짜Date 문자열string 현재 정보 또는 현재 차원과 관련 된 변경 내용을 식별 하는 날짜입니다.The date on which we identified the change related to the current insight or the current dimension.

응답 예제Response example

다음 예제에서는 이 요청에 대한 예제 JSON 응답 본문을 보여 줍니다.The following example demonstrates an example JSON response body for this request.

{
  "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
}