Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Gebruik deze methode in de Microsoft Store Analytics-API om inzichtengegevens op te halen met betrekking tot metrische gegevens over overnames, status en gebruik voor een app tijdens een bepaald datumbereik en andere optionele filters. Deze informatie is ook beschikbaar in het Insights-rapport in partnercentrum.
Vereiste voorwaarden
Als u deze methode wilt gebruiken, moet u eerst het volgende doen:
- Als u dit nog niet hebt gedaan, moet u alle vereisten voor de Microsoft Store Analytics-API voltooien.
- Haal een Azure AD-toegangstoken op dat moet worden gebruikt in de aanvraagheader voor deze methode. Nadat u een toegangstoken hebt verkregen, hebt u 60 minuten om het te gebruiken voordat het verloopt. Nadat het token is verlopen, kunt u een nieuw token verkrijgen.
Aanvraag
Aanvraagsyntaxis
| Methode | URI-aanvraag |
|---|---|
| ONTVANGEN | https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights |
Header van het verzoek
| Koptekst | Typologie | Beschrijving |
|---|---|---|
| Autorisatie | touw | Verplicht. Het Azure AD-toegangstoken in de vorm Bearer<token>. |
Aanvraagparameters
| Kenmerk | Typologie | Beschrijving | Verplicht |
|---|---|---|---|
| applicationId | touw | De Store-id van de app waarvoor u inzichtengegevens wilt ophalen. Als u deze parameter niet opgeeft, bevat de antwoordtekst inzichtengegevens voor alle apps die zijn geregistreerd bij uw account. | Nee. |
| begindatum | datum | De begindatum in het datumbereik van inzichtengegevens die moeten worden opgehaald. De standaardwaarde is 30 dagen vóór de huidige datum. | Nee. |
| einddatum | datum | De einddatum in het datumbereik van inzichtengegevens die moeten worden opgehaald. De standaardwaarde is de huidige datum. | Nee. |
| filter | touw | Een of meer instructies waarmee de rijen in het antwoord worden gefilterd. Elke instructie bevat een veldnaam uit de hoofdtekst van het antwoord en de waarde die zijn gekoppeld aan de eq- of ne-operators, en instructies kunnen worden gecombineerd met enof. Tekenreekswaarden moeten tussen enkele aanhalingstekens in de filterparameter staan. Bijvoorbeeld filter=dataType eq 'acquisition'.
U kunt de volgende filtervelden opgeven:
|
Ja |
Vraag om voorbeeld
In het volgende voorbeeld ziet u een aanvraag voor het ophalen van inzichtengegevens. Vervang de applicationId-waarde door de Store-id voor uw 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>
Reactie
Antwoordlichaam
| Waarde | Typologie | Beschrijving |
|---|---|---|
| Waarde | gegevensreeks | Een matrix met objecten die inzichtengegevens voor de app bevatten. Zie de sectie Insight-waarden hieronder voor meer informatie over de gegevens in elk object. |
| Totaalaantal | int (integer) | Het totale aantal rijen in het gegevensresultaat voor de query. |
Inzichtwaarden
Elementen in de matrix Waarde bevatten de volgende waarden.
| Waarde | Typologie | Beschrijving |
|---|---|---|
| applicationId | touw | De Store-id van de app waarvoor u inzichtengegevens opzoekt. |
| inzichtdatum | touw | De datum waarop we de wijziging in een specifieke metrische waarde hebben geïdentificeerd. Deze datum vertegenwoordigt het einde van de week waarin we een aanzienlijke toename of afname van een metrische waarde hebben gedetecteerd in vergelijking met de week ervoor. |
| Gegevenstype | touw | Een van de volgende tekenreeksen die het algemene analysegebied specificeert dat in dit inzicht wordt beschreven:
|
| inzichtdetail | gegevensreeks | Een of meer InsightDetail-waarden die de details voor het huidige inzicht vertegenwoordigen. |
InsightDetail-waarden
| Waarde | Typologie | Beschrijving |
|---|---|---|
| Naam | touw | Een van de volgende waarden die de metrische waarde aangeeft die door het huidige inzicht of de huidige dimensie wordt beschreven, op basis van de dataType-waarde .
|
| Subdimensies | gegevensreeks | Een of meer objecten die één metrische waarde beschrijven voor het inzicht. |
| Procentuele Verandering | touw | Het percentage waarmee de metric in uw hele klantenbestand is veranderd. |
| DimensionNaam | touw | De naam van de metrische waarde die wordt beschreven in de huidige dimensie. Voorbeelden hiervan zijn EventType, Market, DeviceType, PackageVersion, AcquisitionType, AgeGroup en Gender. |
| DimensieWaarde | touw | De waarde van de metriek die wordt beschreven in de huidige dimensie. Als DimensionName bijvoorbeeld EventType is, kan DimensionValuecrash of hang zijn. |
| Feitwaarde | touw | De absolute waarde van de metrische waarde op de datum waarop het inzicht is gedetecteerd. |
| Richting | touw | De richting van de verandering (positief of negatief). |
| Datum | touw | De datum waarop we de wijziging hebben geïdentificeerd die betrekking heeft op het huidige inzicht of de huidige dimensie. |
Opmerking
De opgehaalde veranderingen in inzichten zijn alleen voor de gegevens van de laatste 30 dagen over acquisitie, status en/of gebruik.
Voorbeeld van aanvraag en antwoord
In de volgende codefragmenten ziet u een voorbeeld van een aanvraag en een JSON-antwoordtekst voor die aanvraag.
Voorbeeldaanvraag
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights?applicationId=9NBLGGGZ5QDR&startDate=7/12/2022&endDate=7/29/2022&filter=dataType eq 'acquisition' or dataType eq 'health'
HTTP/1.1
Authorization: Bearer <your access token>
Voorbeeldantwoord
{
"Value": [
{
"id": "8cdb672c7893bd33a3dec48ededdc676602a1361f3209ab4f3e0982672fc198f",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-27T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-27 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "DeviceType",
"DimensionValue": "Tablet",
"Date": "2022-07-27 00:00:00",
"Direction": "Positive",
"PercentChange": 16.091954022988507,
"FactName": "AcquisitionQuantity",
"FactQuantity": 28.0
}
]
}
]
},
{
"id": "6b8849ecb043c6e5ecdd1c20040c0a371e9ab176eff77f7312b0489e19379225",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-26T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-26 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "DeviceType",
"DimensionValue": "Tablet",
"Date": "2022-07-26 00:00:00",
"Direction": "Positive",
"PercentChange": 28.048780487804876,
"FactName": "AcquisitionQuantity",
"FactQuantity": 30.0
}
]
}
]
},
{
"id": "93115e855fec507385bab17251f49c33bcbc1b62c603e5c7863e327ba94bf160",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-20T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-20 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "GB",
"Date": "2022-07-20 00:00:00",
"Direction": "Negative",
"PercentChange": 3.3035714285714284,
"FactName": "AcquisitionQuantity",
"FactQuantity": 158.0
}
]
}
]
},
{
"id": "4814abe710042a2798b453d8821909c246c389dde814e6678da7189211410604",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-24T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-24 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "DO",
"Date": "2022-07-24 00:00:00",
"Direction": "Negative",
"PercentChange": 13.533834586466165,
"FactName": "AcquisitionQuantity",
"FactQuantity": 8.0
}
]
}
]
},
{
"id": "7941070bb17904f3ef4e19de9659110cb52e18ecfb637ad724e2da749445a860",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-21T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-21 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "AT",
"Date": "2022-07-21 00:00:00",
"Direction": "Positive",
"PercentChange": 0.0,
"FactName": "AcquisitionQuantity",
"FactQuantity": 17.0
}
]
},
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-21 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "SE",
"Date": "2022-07-21 00:00:00",
"Direction": "Negative",
"PercentChange": 21.686746987951807,
"FactName": "AcquisitionQuantity",
"FactQuantity": 5.0
}
]
}
]
},
{
"id": "55905f5458617b65669eb115cc28ebd7296841bd2ff3f8e2546ade1d5e93f68d",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-13T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-13 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "LK",
"Date": "2022-07-13 00:00:00",
"Direction": "Negative",
"PercentChange": 11.111111111111111,
"FactName": "AcquisitionQuantity",
"FactQuantity": 9.0
}
]
}
]
},
{
"id": "9ce9317bf4d0f903de51a49d00a07cf4b4a8ac4457fd1e2886493bd38ceac0b7",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-19T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "Acquisition",
"DimensionValue": "Free",
"Date": "2022-07-19 00:00:00",
"Direction": "Negative",
"PercentChange": 12.188725230475788,
"FactName": "AcquisitionQuantity",
"FactQuantity": 2470,
"SubDimensions": []
}
]
}
],
"TotalCount": 7
}