Obter dados de insights do seu aplicativo da área de trabalho
Use esse método na API de análise da Microsoft Store para obter dados de insights relacionados às métricas de integridade de um aplicativo da área de trabalho que você adicionou ao programa de Aplicativo da Área de Trabalho do Windows. Esses dados também estão disponíveis no Relatório de integridade para aplicativos da área de trabalho no Partner Center.
Pré-requisitos
Para usar este método, primeiro você precisa do seguinte:
- Se você não tiver feito isso, conclua todos os pré-requisitos para a API de análise da Microsoft Store.
- Obtenha um token de acesso do Azure AD a ser usado no cabeçalho da solicitação para este método. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar. Depois que o token expirar, você poderá obter um novo.
Solicitação
Sintaxe da solicitação
Método | URI da solicitação |
---|---|
GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/insights |
Cabeçalho da solicitação
parâmetro | Tipo | Descrição |
---|---|---|
Autorização | string | Obrigatórios. O token de acesso Azure AD notoken> de portador< do formulário. |
Parâmetros da solicitação
Parâmetro | Type | Descrição | Obrigatório |
---|---|---|---|
applicationId | string | A ID do produto do aplicativo da área de trabalho para o qual você deseja obter dados de insights. Para obter a ID do produto de um aplicativo da área de trabalho, abra qualquer relatório de análise para seu aplicativo da área de trabalho no Partner Center (como o relatório de integridade) e recupere a ID do produto da URL. Se você não especificar esse parâmetro, o corpo da resposta conterá dados de insights para todos os aplicativos registrados em sua conta. | Não |
startDate | date | A data de início no intervalo de datas dos dados de insights a serem recuperados. O padrão é 30 dias antes da data atual. | Não |
endDate | date | A data de término no intervalo de datas dos dados de insights a serem recuperados. O padrão é a data atual. | Não |
filter | string | Uma ou mais instruções que filtram as linhas na resposta. Cada instrução contém um nome de campo do corpo de resposta e um valor que estão associados aos operadores eq ou ne, e as instruções podem ser combinadas usando-se and ou or. Os valores de sequência devem estar entre aspas simples no parâmetro filter. Por exemplo, filter=dataType eq 'acquisition'. Atualmente, esse método dá suporte apenas à integridade do filtro. |
Não |
Exemplo de solicitação
O exemplo a seguir demonstra uma solicitação para obter dados de insights. Substitua o valor applicationId pelo valor apropriado para seu aplicativo da área de trabalho.
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>
Resposta
Corpo da resposta
Valor | Type | Descrição |
---|---|---|
Valor | array | Uma matriz de objetos que contêm dados de insights para o aplicativo. Para obter mais informações sobre os dados em cada objeto, consulte a seção Valores do Insight abaixo. |
TotalCount | INT | O número total de linhas no resultado dos dados da consulta. |
Valores de insight
Os elementos na matriz Value contêm os valores a seguir.
Valor | Type | Descrição |
---|---|---|
applicationId | string | A ID do produto do aplicativo da área de trabalho para o qual você recuperou dados de insights. |
insightDate | string | A data em que identificamos a alteração em uma métrica específica. Essa data representa o final da semana em que detectamos um aumento significativo ou uma diminuição em uma métrica em comparação com a semana anterior a essa. |
dataType | string | Uma cadeia de caracteres que especifica a área de análise geral que esse insight informa. Atualmente, esse método dá suporte apenas à integridade. |
insightDetail | array | Um ou mais valores InsightDetail que representam os detalhes do insight atual. |
Valores de InsightDetail
Valor | Type | Descrição |
---|---|---|
FactName | string | Uma cadeia de caracteres que indica a métrica que o insight atual ou a dimensão atual descreve. Atualmente, esse método dá suporte apenas ao valor HitCount. |
SubDimensões | array | Um ou mais objetos que descrevem uma única métrica para o insight. |
PercentChange | string | O percentual que a métrica alterou em toda a sua base de clientes. |
DimensionName | string | O nome da métrica descrita na dimensão atual. Os exemplos incluem EventType, Market, DeviceType e PackageVersion. |
DimensionValue | string | O valor da métrica descrita na dimensão atual. Por exemplo, se DimensionName for EventType, DimensionValue poderá estar travando ou travando. |
FactValue | string | O valor absoluto da métrica na data em que o insight foi detectado. |
Direção | string | A direção da alteração (Positivo ou Negativo). |
Data | string | A data em que identificamos a alteração relacionada ao insight atual ou à dimensão atual. |
Exemplo de resposta
O código a seguir demonstra um exemplo de corpo de resposta JSON para essa solicitação.
{
"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
}
Tópicos relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de