Delen via


App-installaties ophalen

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
}