App-installaties ophalen

2025-05-04

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: markt besturingssysteemversie apparaatstype pakket Versie	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: applicatie Naam datum apparaatstype markt besturingssysteemversie pakket Versie aantal succesvolle installaties 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: applicatie Naam datum apparaatstype markt besturingssysteemversie pakket Versie De geretourneerde gegevensrijen bevatten de velden die zijn opgegeven in de groupby-parameter en het volgende: datum applicationId aantal succesvolle installaties 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: PC Telefoon Console-Xbox een Console-Xbox Serie X Goddelijke Revolutie Holografisch Onbekend
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: Windows Phone 7.5 Windows Phone 8 Windows Phone 8.1 Windows Phone 10 Vensters 8 Windows 8.1 Windows 10 Windows 11 Onbekend
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
}

Installs rapport
Toegang tot analysegegevens met behulp van Microsoft Store-services

Delen via

App-installaties ophalen

Vereiste voorwaarden

Aanvraag

Aanvraagsyntaxis

Header van het verzoek

Aanvraagparameters

Vraag om voorbeeld

Reactie

Antwoordlichaam

Voorbeeld van aanvraag en antwoord

Voorbeeldaanvraag

Voorbeeldantwoord

Voorbeeldaanvraag

Voorbeeldantwoord

Verwante onderwerpen

Feedback

Aanvullende resources