Xbox Live 동시 사용량 현황 데이터 가져오기Get Xbox Live concurrent usage data

Microsoft Store analytics API에서이 메서드를 사용 하 여 지정 된 시간 범위 동안 분, 시간 또는 일 마다 Xbox Live 사용 가능 게임 을 재생 하는 평균 고객 수에 대 한 실시간 사용 데이터 (5-15 분 대기 시간)를 거의 실시간으로 가져올 수 있습니다.Use this method in the Microsoft Store analytics API to get near real-time usage data (with 5-15 minutes latency) about the average number of customers playing your Xbox Live-enabled game every minute, hour, or day during a specified time range. 이 정보는 파트너 센터의 Xbox analytics 보고서 에서도 사용할 수 있습니다.This information is also available in the Xbox analytics report in Partner Center.

중요

이 방법은 xbox Live 서비스를 사용 하는 Xbox 또는 게임의 게임만 지원 합니다.This method only supports games for Xbox or games that use Xbox Live services. 이러한 게임은 Microsoft 파트너 에서 게시 한 게임과 ID@Xbox 프로그램을 통해 제출 된 게임을 포함 하는 개념 승인 프로세스를 통과 해야 합니다.These games must go through the concept approval process, which includes games published by Microsoft partners and games submitted via the ID@Xbox program. 이 메서드는 현재 Xbox Live 크리에이터 프로그램을 통해 게시 된 게임을 지원 하지 않습니다.This method does not currently support games published via the Xbox Live Creators Program.

필수 조건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/gameanalytics

요청 헤더Request header

헤더Header 유형Type DescriptionDescription
권한 부여Authorization 문자열string 필수 요소.Required. Bearer <token> 형식의 Azure AD 액세스 토큰입니다.The Azure AD access token in the form Bearer <token>.

요청 매개 변수Request parameters

매개 변수Parameter 형식Type 설명Description 필수Required
applicationIdapplicationId 문자열string Xbox Live 동시 사용 데이터를 검색 하려는 게임의 상점 ID 입니다.The Store ID of the game for which you want to retrieve Xbox Live concurrent usage data. Yes
metricTypemetricType 문자열string 검색할 Xbox Live 분석 데이터의 유형을 지정 하는 문자열입니다.A string that specifies the type of Xbox Live analytics data to retrieve. 이 메서드의 경우 값 동시성을 지정 합니다.For this method, specify the value concurrency. Yes
startDatestartDate datedate 동시 사용 데이터를 검색할 날짜 범위의 시작 날짜입니다.The start date in the date range of concurrent usage data to retrieve. 기본 동작에 대 한 aggregationLevel 설명을 참조 하세요.See the aggregationLevel description for default behavior. 아니요No
endDateendDate datedate 검색할 동시 사용 데이터의 날짜 범위에 있는 종료 날짜입니다.The end date in the date range of concurrent usage data to retrieve. 기본 동작에 대 한 aggregationLevel 설명을 참조 하세요.See the aggregationLevel description for default behavior. 아니요No
aggregationLevelaggregationLevel 문자열string 집계 데이터를 검색 하는 시간 범위를 지정 합니다.Specifies the time range for which to retrieve aggregate data. 다음 문자열 중 하나일 수 있습니다. , 시간또는 Can be one of the following strings: minute, hour, or day. 지정 하지 않으면 기본값은 day입니다.If unspecified, the default is day.

날짜/ endDate을 지정 startDate 하지 않으면 응답 본문은 다음과 같이 설정 됩니다.If you do not specify startDate or endDate, the response body defaults to the following:

  • minute: 사용 가능한 데이터의 마지막 60 레코드입니다.minute: The last 60 records of available data.
  • hour: 사용 가능한 데이터의 마지막 24 레코드입니다.hour: The last 24 records of available data.
  • day: 사용 가능한 데이터의 마지막 7 레코드입니다.day: The last 7 records of available data.

다음 집계 수준에는 반환 될 수 있는 레코드 수에 대 한 크기 제한이 있습니다.The following aggregation levels have size limits on the number of records that can be returned. 요청한 시간 범위가 너무 크면 레코드가 잘립니다.The records will be truncated if the requested time span is too large.

  • : 최대 1440 레코드 (24 시간 데이터)minute: Up to 1440 records (24 hours of data).
  • hour: 최대 720 레코드 (데이터 30 일)hour: Up to 720 records (30 days of data).
  • : 최대 60 레코드 (60 일 데이터)day: Up to 60 records (60 days of data).
아니요No

요청 예제Request example

다음 예제에서는 Xbox Live 사용 게임의 동시 사용 현황 데이터를 가져오는 요청을 보여 줍니다.The following example demonstrates a request for getting concurrent usage data for your Xbox Live-enabled game. 이 요청은 1 2018 년 2 월 사이 2 2018에서 1 분 마다 데이터를 검색 합니다.This request retrieves data for every minute between February 1 2018 and February 2 2018. ApplicationId 값을 게임의 상점 ID로 바꿉니다.Replace the applicationId value with the Store ID for your game.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/gameanalytics?applicationId=9NBLGGGZ5QDR&metrictype=concurrency&aggregationLevel=hour&startDate=2018-02-01&endData=2018-02-02 HTTP/1.1
Authorization: Bearer <your access token>

응답Response

응답 본문에는 지정 된 분, 시간 또는 일에 대 한 동시 사용 현황 데이터 집합이 각각 하나씩 포함 된 개체 배열이 포함 되어 있습니다.The response body contains an array of objects that each contain one set of concurrent usage data for a specified minute, hour, or day. 각 개체에는 다음 값이 포함 됩니다.Each object contains the following values.

Value 형식Type 설명Description
개수Count numbernumber Xbox Live를 사용 하 여 지정 된 분, 시간 또는 일 동안 Xbox Live를 재생 하는 평균 고객 수입니다.The average number of customers playing your Xbox Live-enabled for the specified minute, hour, or day.

Note   참고   값이 0 이면 지정 된 간격 동안 동시 사용자가 없거나 지정 된 간격 동안 게임에 대 한 동시 사용자 데이터를 수집 하는 동안 오류가 발생 했음을 나타냅니다.Note  A value of 0 indicates either that there were no concurrent users during the specified interval, or that there was a failure while collecting concurrent user data for the game during the specified interval.

날짜Date 문자열string 동시 사용 데이터가 발생 한 분, 시간 또는 일을 지정 하는 날짜와 시간입니다.The date and time that specifies the minute, hour or day during which the concurrent usage data occurred.
SeriesNameSeriesName 문자열string 이 값에는 항상 Userconcurrency값이 있습니다.This always has the value UserConcurrency.

응답 예제Response example

다음 예제에서는 데이터 집계가 분당이 요청에 대 한 예제 JSON 응답 본문을 보여 줍니다.The following example demonstrates an example JSON response body for this request with data aggregation by minute.

[   {
        "Count": 418.0,
        "Date": "2018-02-02T04:42:13.65Z",
        "SeriesName": "UserConcurrency"
    }, {
        "Count": 418.0,
        "Date": "2018-02-02T04:43:13.65Z",
        "SeriesName": "UserConcurrency"
    }, {
        "Count": 415.0,
        "Date": "2018-02-02T04:44:13.65Z",
        "SeriesName": "UserConcurrency"
    }, {
        "Count": 412.0,
        "Date": "2018-02-02T04:45:13.65Z",
        "SeriesName": "UserConcurrency"
    }, {
        "Count": 414.0,
        "Date": "2018-02-02T04:46:13.65Z",
        "SeriesName": "UserConcurrency"
    }
]