Ottenere informazioni dettagliate per l'applicazione desktop
Usare questo metodo nell'API di analisi di Microsoft Store API per ottenere dati analitici relativi alle metriche sull'integrità per un'applicazione desktop aggiunta al programma per applicazioni desktop di Windows. Questi dati sono anche disponibili nel report sull'integrità per le applicazioni desktop nel Centro per i partner.
Prerequisiti
Per usare questo metodo, è necessario prima eseguire le operazioni seguenti:
- Se non lo si è ancora fatto, completare i prerequisiti per l'API di analisi di Microsoft Store.
- Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.
Richiedi
Sintassi della richiesta
| metodo | URI della richiesta |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/insights |
Intestazione della richiesta
| Intestazione | Type | Descrizione |
|---|---|---|
| Autorizzazione | stringa | Obbligatorio. Token di accesso di Azure AD nel formato Token di<connessione>. |
Parametri della richiesta
| Parametro | Tipo | Descrizione | Richiesto |
|---|---|---|---|
| applicationId | string | ID prodotto dell'applicazione desktop per cui si desidera ottenere dati analitici. Per ottenere l'ID prodotto di un'applicazione desktop, aprire qualsiasi report di analisi nel Centro per i partner per l'applicazione desktop (ad esempio il report sull'integrità) e recuperare l'ID prodotto dall'URL. Se non si specifica questo parametro, il corpo della risposta conterrà i dati analitici per tutte le app registrate nel proprio account. | No |
| startDate | data | Data di inizio nell'intervallo di date dei dati analitici da recuperare. Il valore predefinito è 30 giorni prima della data corrente. | No |
| endDate | data | Data di fine nell'intervallo di date dei dati analitici da recuperare. L'impostazione predefinita è la data corrente. | No |
| filter | string | Una o più istruzioni che filtrano le righe nella risposta. Ogni istruzione contiene un nome di campo del corpo della risposta e un valore associati agli operatori eq o ne e le istruzioni possono essere combinate usando and o or. I valori stringa devono essere racchiusi tra virgolette singole nel parametro filter. Ad esempio, filter=dataType eq 'acquisition'. Attualmente questo metodo supporta solo il filtro health. |
No |
Esempio di richiesta
L'esempio seguente illustra una richiesta di recupero dei dati analitici. Sostituire il valore applicationId con il valore appropriato per l'applicazione desktop.
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>
Response
Corpo della risposta
| Valore | Tipo | Descrizione |
|---|---|---|
| valore | matrice | Matrice di oggetti che contengono dati analitici per l'app. Per ulteriori informazioni sui dati in ogni oggetto, vedere la sezione Valori dati analitici seguente. |
| TotalCount | int | Numero totale di righe nei risultati di dati per la query. |
Valori dati analitici
Gli elementi nella matrice Value contengono i valori seguenti.
| Valore | Tipo | Descrizione |
|---|---|---|
| applicationId | string | ID prodotto dell'applicazione desktop per cui si sono recuperati i dati analitici. |
| insightDate | string | Data in cui è stata identificata la modifica in una metrica specifica. Questa data rappresenta la fine della settimana in cui si è rilevato un aumento o una diminuzione significativa in una metrica rispetto alla settimana precedente. |
| dataType | string | Stringa che specifica l'area di analisi generale a cui il dato analitico si riferisce. Attualmente, questo metodo supporta solo health. |
| insightDetail | array | Uno o più valori InsightDetail che rappresenta i dettagli per il dato analitico corrente. |
Valori InsightDetail
| Valore | Tipo | Descrizione |
|---|---|---|
| FactName | string | Stringa che indica la metrica descritta dal dato analitico o dalla dimensione corrente. Attualmente questo metodo supporta solo il valore HitCount. |
| SubDimensions | array | Uno o più oggetti che descrivono una singola metrica per il dato analitico. |
| PercentChange | string | Percentuale di modifica della metrica nell'intera base di clienti. |
| DimensionName | string | Nome della metrica descritta nella dimensione corrente. Gli esempi includono EventType, Market, DeviceType e PackageVersion. |
| DimensionValue | string | Valore della metrica descritta nella dimensione corrente. Ad esempio, se DimensionName è EventType, DimensionValue potrebbe essere crash o hang. |
| FactValue | string | Valore assoluto della metrica nella data in cui è stato rilevato il dato analitico. |
| Direzione | string | Direzione della modifica (Positive o Negative). |
| Data | string | Data in cui è stata identificata la modifica correlata al dato analitico o alla dimensione corrente. |
Risposta di esempio
L'esempio seguente illustra un esempio di corpo della risposta JSON per questa richiesta.
{
"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
}