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 cumulatieve installatiegegevens op te halen in JSON-indeling voor een toepassing tijdens een bepaald datumbereik en andere optionele filters. Deze informatie is ook beschikbaar in het rapport Overnames 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 |
---|---|
TOEVOEGEN | https://manage.devcenter.microsoft.com/v1.0/my/analytics/installs |
Header van het verzoek
Koptekst | Typologie | Beschrijving |
---|---|---|
Autorisatie | touw | Verplicht. Het Azure AD-toegangstoken in de vorm van Bearer<token>. |
Aanvraagparameters
Kenmerk | Typologie | Beschrijving | Verplicht |
---|---|---|---|
applicationId | touw | De Store-id van de app waarvoor u installatiegegevens wilt ophalen. | Ja |
begindatum | datum | De begindatum in het datumbereik van installatiegegevens die moeten worden opgehaald. De standaardwaarde is de huidige datum. | Nee. |
einddatum | datum | De einddatum in het datumbereik van installatiegegevens die moeten worden opgehaald. De standaardwaarde is de huidige datum. | Nee. |
Bovenaan | int (integer) | Het aantal rijen met gegevens dat moet worden geretourneerd in de aanvraag. De maximumwaarde en de standaardwaarde als deze niet zijn opgegeven, is 10000. Als er meer rijen in de query staan, bevat de hoofdtekst van het antwoord een volgende koppeling die u kunt gebruiken om de volgende pagina met gegevens aan te vragen. | Nee. |
overslaan | int (integer) | Het aantal rijen dat moet worden overgeslagen in de query. Gebruik deze parameter om door grote gegevenssets te bladeren. Met top=10000 en skip=0 worden bijvoorbeeld de eerste 10000 rijen met gegevens opgehaald, top=10000 en skip=10000 worden de volgende 10000 rijen met gegevens opgehaald, enzovoort. | Nee. |
filter | touw | Een of meer instructies waarmee de rijen in het antwoord worden gefilterd. Elke instructie bevat een veldnaam uit de antwoordtekst en waarde die zijn gekoppeld aan de operatoren eq of ne en instructies kunnen worden gecombineerd met behulp van en of of. Tekenreekswaarden moeten tussen enkele aanhalingstekens staan in parameter van het filter. U kunt de volgende velden opgeven in de hoofdtekst van het antwoord:
|
Nee. |
aggregatieniveau | touw | Hiermee geeft u het tijdsbereik op waarvoor geaggregeerde gegevens moeten worden opgehaald. Dit kan een van de volgende tekenreeksen zijn: dag, week of maand. Als dit niet is opgegeven, is de standaardwaarde dag. | Nee. |
volgorde | touw | Een opdracht die de resultaatgegevenswaarden voor elke installatie sorteert. De syntaxis is orderby=field [order],field [order],.... Het veld parameter kan een van de volgende velden uit de antwoordtekst zijn:
De orderparameter is optioneel en kan asc of desc zijn om oplopende of aflopende volgorde voor elk veld op te geven. De standaardwaarde is asc. Hier is een voorbeeld van een orderby reeks: orderby=date,market |
Nee. |
groeperen met groupby | touw | Een instructie die alleen gegevensaggregatie toepast op de opgegeven velden. U kunt de volgende velden opgeven in de hoofdtekst van het antwoord:
De geretourneerde gegevensrijen bevatten de velden die zijn opgegeven in de groupby-parameter en het volgende:
De groupby-parameter kan worden gebruikt met de parameter aggregationLevel . Bijvoorbeeld: &groupby=ageGroup,market&aggregationLevel=week |
Nee. |
Vraag om voorbeeld
In het volgende voorbeeld ziet u verschillende aanvragen voor het ophalen van app-installatiegegevens. Vervang de applicationId-waarde door de Store-id voor uw app.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/installs?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/installs?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>
Reactie
Antwoordlichaam
Waarde | Typologie | Beschrijving |
---|---|---|
Waarde | gegevensreeks | Een matrix met objecten die cumulatieve installatiegegevens bevatten. Zie de volgende tabel voor meer informatie over de gegevens in elk object. |
@nextLink | touw | Als er extra pagina's met gegevens zijn, bevat deze tekenreeks een URI die u kunt gebruiken om de volgende pagina met gegevens aan te vragen. Deze waarde wordt bijvoorbeeld geretourneerd als de bovenste parameter van de aanvraag is ingesteld op 10000, maar er meer dan 10000 rijen met installatiegegevens voor de query zijn. |
Totaalaantal | int (integer) | Het totale aantal rijen in het gegevensresultaat voor de query. |
Elementen in de matrix Waarde bevatten de volgende waarden.
Waarde | Typologie | Beschrijving |
---|---|---|
datum | touw | De eerste datum in het datumbereik voor de installatiegegevens. Als de aanvraag één dag heeft opgegeven, is deze waarde die datum. Als de aanvraag een week, maand of ander datumbereik heeft opgegeven, is deze waarde de eerste datum in dat datumbereik. |
applicationId | touw | De Store-id van de app waarvoor u installatiegegevens opzoekt. |
naam van de applicatie | touw | De weergavenaam van de app. |
apparaatstype | touw | Een van de volgende tekenreeksen waarmee het type apparaat wordt opgegeven dat de installatie heeft voltooid:
|
pakketversie | touw | De versie van het pakket dat is geïnstalleerd. |
osVersie | touw | Een van de volgende tekenreeksen waarmee de versie van het besturingssysteem wordt opgegeven waarop de installatie heeft plaatsgevonden:
|
markt | touw | De ISO 3166-landcode van de markt waar de installatie plaatsvond. |
aantalSuccesvolleInstallaties | nummer | Het aantal geslaagde installaties dat heeft plaatsgevonden op het opgegeven aggregatieniveau. |
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/installs?applicationId=9WZDNCRFJB4P
HTTP/1.1
Authorization: Bearer <your access token>
Voorbeeldantwoord
{
"Value": [
{
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"successfulInstallCount": 100053
}
],
"TotalCount": 1
}
Voorbeeldaanvraag
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/installs?applicationId=9NBLGGGZ5QDR&aggregationLevel=day&startDate=06/19/2022&endDate=07/21/2022&top=10&skip=0&groupby=applicationName,date,deviceType,market,osVersion,packageVersion&orderby=date desc
HTTP/1.1
Authorization: Bearer <your access token>
Voorbeeldantwoord
{
"Value": [
{
"date": "2022-07-22",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"packageVersion": "2013.1206.10.2936",
"deviceType": "PC",
"market": "AR",
"osVersion": "Windows 10",
"successfulInstallCount": 1
},
{
"date": "2022-07-22",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"packageVersion": "2013.1206.10.2936",
"deviceType": "PC",
"market": "AU",
"osVersion": "Windows 10",
"successfulInstallCount": 1
},
{
"date": "2022-07-22",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"packageVersion": "2013.1206.10.2936",
"deviceType": "PC",
"market": "BD",
"osVersion": "Windows 10",
"successfulInstallCount": 1
},
{
"date": "2022-07-22",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"packageVersion": "2013.1206.10.2936",
"deviceType": "PC",
"market": "BG",
"osVersion": "Windows 11",
"successfulInstallCount": 1
},
{
"date": "2022-07-22",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"packageVersion": "2013.1206.10.2936",
"deviceType": "PC",
"market": "BO",
"osVersion": "Windows 10",
"successfulInstallCount": 1
},
{
"date": "2022-07-22",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"packageVersion": "2013.1206.10.2936",
"deviceType": "PC",
"market": "BR",
"osVersion": "Windows 10",
"successfulInstallCount": 6
},
{
"date": "2022-07-22",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"packageVersion": "2013.1206.10.2936",
"deviceType": "PC",
"market": "BR",
"osVersion": "Windows 11",
"successfulInstallCount": 3
},
{
"date": "2022-07-22",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"packageVersion": "2013.1206.10.2936",
"deviceType": "PC",
"market": "CA",
"osVersion": "Windows 11",
"successfulInstallCount": 1
},
{
"date": "2022-07-22",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"packageVersion": "2013.1206.10.2936",
"deviceType": "PC",
"market": "CN",
"osVersion": "Windows 11",
"successfulInstallCount": 1
},
{
"date": "2022-07-22",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"packageVersion": "2013.1206.10.2936",
"deviceType": "PC",
"market": "MX",
"osVersion": "Windows 10",
"successfulInstallCount": 1
}
],
"TotalCount": 10
}
Verwante onderwerpen
- Installs rapport
- Toegang tot analysegegevens met behulp van Microsoft Store-services