Recuperare i dati sull'utilizzo simultaneo di Xbox LiveGet Xbox Live concurrent usage data

Usare questo metodo nell'API Microsoft Store Analytics per ottenere i dati di utilizzo quasi in tempo reale (con latenza di 5-15 minuti) circa il numero medio di clienti che svolgono il gioco abilitato per Xbox Live ogni minuto, ora o giorno nell'intervallo di tempo specificato.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. Queste informazioni sono disponibili anche nel report di Xbox Analytics nel centro per i partner.This information is also available in the Xbox analytics report in Partner Center.

Importante

Questo metodo supporta solo giochi per Xbox o giochi che usano i servizi Xbox Live.This method only supports games for Xbox or games that use Xbox Live services. Questi giochi devono seguire il processo di approvazione del concetto, che include giochi pubblicati da partner e giochi Microsoft inviati tramite il ID@Xbox programma.These games must go through the concept approval process, which includes games published by Microsoft partners and games submitted via the ID@Xbox program. Questo metodo attualmente non supporta i giochi pubblicati tramite il programma Creators di Xbox Live.This method does not currently support games published via the Xbox Live Creators Program.

PrerequisitiPrerequisites

Per usare questo metodo, devi prima eseguire le operazioni seguenti:To use this method, you need to first do the following:

  • Se non è già stato fatto, completare tutti i prerequisiti per l'API di analisi del Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • Ottieni un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo.Obtain an Azure AD access token to use in the request header for this method. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza.After you obtain an access token, you have 60 minutes to use it before it expires. Dopo la scadenza del token, puoi ottenerne uno nuovo.After the token expires, you can obtain a new one.

RichiestaRequest

Sintassi della richiestaRequest syntax

MetodoMethod URI richiestaRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/analytics/gameanalytics

Intestazione della richiestaRequest header

IntestazioneHeader TipoType DescrizioneDescription
AutorizzazioneAuthorization stringstring Obbligatorio.Required. Il token di accesso Azure ad nel token di connessione del modulo < token > .The Azure AD access token in the form Bearer <token>.

Parametri della richiestaRequest parameters

ParametroParameter TipoType DescrizioneDescription ObbligatorioRequired
applicationIdapplicationId stringstring ID dello Store del gioco per il quale si desidera recuperare i dati di utilizzo simultanei di Xbox Live.The Store ID of the game for which you want to retrieve Xbox Live concurrent usage data. Yes
metricTypemetricType stringstring Stringa che specifica il tipo di dati di analisi di Xbox Live da recuperare.A string that specifies the type of Xbox Live analytics data to retrieve. Per questo metodo, specificare la concorrenzadei valori.For this method, specify the value concurrency. Yes
startDatestartDate Datadate Data di inizio nell'intervallo di date dei dati di utilizzo simultanei da recuperare.The start date in the date range of concurrent usage data to retrieve. Per un comportamento predefinito, vedere la descrizione di aggregationLevel .See the aggregationLevel description for default behavior. NoNo
endDateendDate Datadate Data di fine nell'intervallo di date dei dati di utilizzo simultanei da recuperare.The end date in the date range of concurrent usage data to retrieve. Per un comportamento predefinito, vedere la descrizione di aggregationLevel .See the aggregationLevel description for default behavior. NoNo
aggregationLevelaggregationLevel stringstring Specifica l'intervallo di tempo per cui recuperare dati aggregati.Specifies the time range for which to retrieve aggregate data. Può essere una delle seguenti stringhe: minuto, orao giorno.Can be one of the following strings: minute, hour, or day. Se non viene specificato, il valore predefinito è day.If unspecified, the default is day.

Se non si specifica StartDate o EndDate, per impostazione predefinita il corpo della risposta è il seguente:If you do not specify startDate or endDate, the response body defaults to the following:

  • minuto: ultimi 60 record dei dati disponibili.minute: The last 60 records of available data.
  • hour: gli ultimi 24 record dei dati disponibili.hour: The last 24 records of available data.
  • Day: ultimi 7 record dei dati disponibili.day: The last 7 records of available data.

I livelli di aggregazione seguenti presentano limiti di dimensione per il numero di record che possono essere restituiti.The following aggregation levels have size limits on the number of records that can be returned. I record verranno troncati se l'intervallo di tempo richiesto è troppo grande.The records will be truncated if the requested time span is too large.

  • minuto: fino a 1440 record (24 ore di dati).minute: Up to 1440 records (24 hours of data).
  • ora: fino a 720 record (30 giorni di dati).hour: Up to 720 records (30 days of data).
  • giorno: fino a 60 record (60 giorni di dati).day: Up to 60 records (60 days of data).
NoNo

Esempio di richiestaRequest example

Nell'esempio seguente viene illustrata una richiesta per ottenere i dati di utilizzo simultanei per il gioco abilitato per Xbox Live.The following example demonstrates a request for getting concurrent usage data for your Xbox Live-enabled game. Questa richiesta recupera i dati ogni minuto tra il 1 2018 febbraio e il 2 2018 febbraio.This request retrieves data for every minute between February 1 2018 and February 2 2018. Sostituire il valore di ApplicationID con l'ID dello Store per il gioco.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>

RispostaResponse

Il corpo della risposta contiene una matrice di oggetti ognuno dei quali contiene un set di dati di utilizzo simultanei per un minuto, un'ora o un giorno specificato.The response body contains an array of objects that each contain one set of concurrent usage data for a specified minute, hour, or day. Ogni oggetto contiene i valori seguenti.Each object contains the following values.

ValoreValue TipoType DescrizioneDescription
ConteggioCount d'acquistonumber Il numero medio di clienti che svolgono la funzionalità Xbox Live abilitata per il minuto, l'ora o il giorno specificato.The average number of customers playing your Xbox Live-enabled for the specified minute, hour, or day.

Note   Nota   Il valore 0 indica che non sono presenti utenti simultanei nell'intervallo specificato o che si è verificato un errore durante la raccolta di dati utente simultanei per il gioco durante l'intervallo specificato.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.

DataDate stringstring Data e ora che specificano il minuto, l'ora o il giorno in cui si sono verificati i dati di utilizzo simultanei.The date and time that specifies the minute, hour or day during which the concurrent usage data occurred.
SeriesNameSeriesName stringstring Il valore è sempre UserConcurrency.This always has the value UserConcurrency.

Esempio di rispostaResponse example

Nell'esempio seguente viene illustrato un corpo della risposta JSON di esempio per questa richiesta con aggregazione dati per minuto.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"
    }
]