Ottenere i dati di insightsGet insights data

Utilizzare questo metodo nella finestra di analitica API di Microsoft Store per ottenere i dati di insights relativa a acquisizioni, l'integrità e le metriche di utilizzo per un'app durante un determinato intervallo di date e altri filtri facoltativi.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. Queste informazioni sono anche disponibili nel report di Insights nel centro per i Partner.This information is also available in the Insights report in Partner Center.

PrerequisitiPrerequisites

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

  • Se non lo hai già fatto, completa tutti i prerequisiti per l'API di analisi di 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, hai 60 minuti per usarlo prima che scada.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/insights

Intestazione della richiestaRequest header

IntestazioneHeader TipoType DescrizioneDescription
AuthorizationAuthorization stringastring Obbligatorio.Required. Il token di accesso di Azure AD nel formato Bearer < token>.The Azure AD access token in the form Bearer <token>.

Parametri della richiestaRequest parameters

ParametroParameter TipoType DescrizioneDescription ObbligatorioRequired
applicationIdapplicationId stringastring Il Store ID dell'app per la quale si desidera recuperare i dati di insights.The Store ID of the app for which you want to retrieve insights data. Se non si specifica questo parametro, il corpo della risposta conterrà i dati di insights per tutte le app registrate al proprio account.If you do not specify this parameter, the response body will contain insights data for all apps registered to your account. NoNo
startDatestartDate datedate Data di inizio dell'intervallo di date di dati di insights da recuperare.The start date in the date range of insights data to retrieve. Il valore predefinito è 30 giorni prima della data corrente.The default is 30 days before the current date. NoNo
endDateendDate datedate Data di fine nell'intervallo di dati di insights da recuperare.The end date in the date range of insights data to retrieve. Il valore predefinito è la data corrente.The default is the current date. NoNo
filterfilter stringastring Una o più istruzioni per filtrare le righe nella risposta.One or more statements that filter the rows in the response. Ogni istruzione contiene il nome di un campo proveniente dal corpo della riposta e un valore associati con gli operatori eq o ne e le istruzioni possono essere combinate con and o 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. I valori stringa devono essere racchiusi tra virgolette singole nel parametro filter.String values must be surrounded by single quotes in the filter parameter. Ad esempio, filtro di acquisizione' dataType eq' =.For example, filter=dataType eq 'acquisition'.

È possibile specificare i campi filtro seguenti:You can specify the following filter fields:

  • Acquisizioneacquisition
  • Integritàhealth
  • Utilizzousage
NoNo

Esempio di richiestaRequest example

L'esempio seguente illustra una richiesta per ottenere i dati di insights.The following example demonstrates a request for getting insights data. Sostituisci il valore applicationId con l'ID dello Store per la tua app.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>

RispostaResponse

Contenuto della rispostaResponse body

ValoreValue TipoType DescrizioneDescription
ValoreValue arrayarray Matrice di oggetti che contengono i dati di insights per l'app.An array of objects that contain insights data for the app. Per altre informazioni sui dati in ogni oggetto, vedere la valori Insight sezione riportata di seguito.For more information about the data in each object, see the Insight values section below.
TotalCountTotalCount intint Numero totale di righe nei dati risultanti dalla query.The total number of rows in the data result for the query.

Valori di InsightInsight values

Gli elementi nella matrice Value contengono i valori seguenti.Elements in the Value array contain the following values.

ValoreValue TipoType DescrizioneDescription
applicationIdapplicationId stringastring L'ID di Store dell'app per la quale si recuperano i dati di insights.The Store ID of the app for which you are retrieving insights data.
insightDateinsightDate stringastring La data in cui è stato rilevato la modifica di una metrica specifica.The date on which we identified the change in a specific metric. La data rappresenta la fine della settimana in cui è stato rilevato un aumento significativo o diminuire in una metrica rispetto alla settimana che li precedono.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.
Tipo di datidataType stringastring Una delle seguenti stringhe che specifica l'area di analitica generale che descrive queste informazioni:One of the following strings that specifies the general analytics area that this insight describes:

  • Acquisizioneacquisition
  • Integritàhealth
  • Utilizzousage
insightDetailinsightDetail arrayarray Uno o più InsightDetail valori che rappresentano i dettagli per l'analisi corrente.One or more InsightDetail values that represent the details for current insight.

Valori InsightDetailInsightDetail values

ValoreValue TipoType DescrizioneDescription
FactNameFactName stringastring Uno dei seguenti valori che indica la metrica che descrive le informazioni correnti o una dimensione corrente, in base il dataType valore.One of the following values that indicates the metric that the current insight or current dimension describes, based on the dataType value.
  • Per la health, questo valore è sempre HitCount.For health, this value is always HitCount.
  • Per la acquisizione, questo valore è sempre AcquisitionQuantity.For acquisition, this value is always AcquisitionQuantity.
  • Per la utilizzo, questo valore può essere uno delle seguenti stringhe:For usage, this value can be one of the following strings:
    • dailyActiveUsersDailyActiveUsers
    • engagementDurationMinutesEngagementDurationMinutes
    • dailyActiveDevicesDailyActiveDevices
    • dailyNewUsersDailyNewUsers
    • dailySessionCountDailySessionCount
SubDimensionsSubDimensions arrayarray Uno o più oggetti che descrivono una sola metrica per le informazioni dettagliate.One or more objects that describe a single metric for the insight.
ValoriPercentChange stringastring La percentuale che la metrica modificata tra la base clienti intero.The percentage that the metric changed across your entire customer base.
DimensionNameDimensionName stringastring Il nome della metrica descritto nella dimensione corrente.The name of the metric described in the current dimension. Gli esempi includono EventType, mercato, DeviceType, PackageVersion, AcquisitionType, AgeGroup e sesso.Examples include EventType, Market, DeviceType, PackageVersion, AcquisitionType, AgeGroup and Gender.
DimensionValueDimensionValue stringastring Il valore della metrica è descritta nella dimensione corrente.The value of the metric that is described in the current dimension. Ad esempio, se DimensionName viene EventType, DimensionValue potrebbe essere arresto anomalo del sistema oppure bloccarsi .For example, if DimensionName is EventType, DimensionValue might be crash or hang.
FactValueFactValue stringastring Il valore assoluto della metrica nella data che sono state rilevate le informazioni.The absolute value of the metric on the date the insight was detected.
DirezioneDirection stringastring La direzione della modifica (positivi oppure negativo).The direction of the change (Positive or Negative).
DataDate stringastring La data in cui è stato rilevato la modifica correlata per l'analisi corrente o la dimensione corrente.The date on which we identified the change related to the current insight or the current dimension.

Esempio di rispostaResponse example

L'esempio seguente illustra un esempio di corpo della risposta JSON per questa richiesta.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
}