Delen via

App-acquisities ophalen

Gebruik deze methode in de Microsoft Store Analytics-API om geaggregeerde overnamegegevens 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/appacquisitions

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 overnamegegevens wilt ophalen. Ja
begindatum datum De begindatum in het datumbereik van de overnamegegevens die moeten worden opgehaald. De standaardwaarde is de huidige datum. Nee.
einddatum datum De einddatum in het datumbereik van de overnamegegevens 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 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=market eq 'US' en gender eq 'm'.

U kunt de volgende velden opgeven uit de hoofdtekst van het antwoord:

  • type van acquisitie
  • leeftijdsgroep
  • winkel Klant
  • geslacht
  • markt
  • osVersie
  • apparaatstype
  • bestelnaam
 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 instructie die de resultaatgegevenswaarden voor elke acquisitie rangschikt. De syntaxis is orderby=field [order],field [order],.... De veldparameter kan een van de volgende tekenreeksen zijn:
  • datum
  • type van acquisitie
  • leeftijdsgroep
  • winkel Klant
  • geslacht
  • markt
  • osVersie
  • apparaatstype
  • bestelnaam

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 volgt een voorbeeld van een orderby-tekenreeks : orderby=date,market

 Nee.
groeperen met groupby touw Een instructie die alleen gegevensaggregatie toepast op de opgegeven velden. U kunt de volgende velden opgeven:
  • datum
  • applicatie Naam
  • type van acquisitie
  • leeftijdsgroep
  • winkel Klant
  • geslacht
  • markt
  • osVersie
  • apparaatstype
  • bestelnaam

De geretourneerde gegevensrijen bevatten de velden die zijn opgegeven in de groupby-parameter en het volgende:

  • datum
  • applicationId
  • aankoophoeveelheid

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-overnamegegevens. Vervang de applicationId-waarde door de Store-id voor uw app.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?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/appacquisitions?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=market eq 'US' and gender eq 'm'  HTTP/1.1
Authorization: Bearer <your access token>

Reactie

Antwoordlichaam

Waarde Typologie Beschrijving
Waarde gegevensreeks Een array van objecten die geaggregeerde acquisitiegegevens voor de app bevatten. Zie de sectie met overnamewaarden hieronder 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 100000, maar er meer dan 10000 rijen met overnamegegevens voor de query zijn.
Totaalaantal int (integer) Het totale aantal rijen in het gegevensresultaat voor de query.

Overnamewaarden

Elementen in de matrix Waarde bevatten de volgende waarden.

Waarde Typologie Beschrijving
datum touw De eerste datum in het datumbereik voor de overnamegegevens. 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 acquisitiegegevens opzoekt.
naam van de applicatie touw De weergavenaam van de app.
apparaatstype touw Een van de volgende tekenreeksen waarmee het type apparaat wordt opgegeven waarop de overname heeft plaatsgevonden:
  • PC
  • Telefoon
  • Console-Xbox een
  • Console-Xbox Serie X
  • Goddelijke Revolutie
  • Holografisch
  • Onbekend
naam van de bestelling touw De naam van de bestelling.
winkel Klant touw Een van de volgende tekenreeksen die de versie van de Store aangeeft waar de overname heeft plaatsgevonden:
  • Windows Phone Store (client)
  • Microsoft Store (client) ( of Windows Store (client) bij het opvragen van gegevens vóór 23 maart 2018)
  • Microsoft Store (web) ( of Windows Store (web) als er vóór 23 maart 2018 een query wordt uitgevoerd op gegevens
  • Volumeaankoop door organisaties
  • Ander
osVersie touw Een van de volgende tekenreeksen die de versie van het besturingssysteem opgeeft waarop de overname 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 overname plaatsvond.
geslacht touw Een van de volgende tekenreeksen die het geslacht aangeeft van de gebruiker die de overname heeft gedaan:
  • m
  • f
  • Onbekend
leeftijdsgroep touw Een van de volgende tekenreeksen die de leeftijdsgroep aangeeft van de gebruiker die de overname heeft gedaan:
  • kleiner dan 13
  • 13-17
  • 18-24
  • 25-34
  • 35-44
  • 44-55
  • groter dan 55
  • Onbekend
acquisitietype touw Een van de volgende tekenreeksen die het type overname aangeeft:
  • Vrij
  • Proef
  • Betaald
  • Promotiecode
  • Iap
  • Abonnement Iap
  • Privédoelgroep
  • vooraf bestellen
  • Xbox Game Pass (of Game Pass als u gegevens opvraagt vóór 23 maart 2018)
  • Schijf
  • Prepaidcode
aankoophoeveelheid nummer Het aantal overnames dat plaatsvond tijdens 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/appacquisitions?applicationId=9NBLGGGZ5QDR  HTTP/1.1
Authorization: Bearer <your access token>

Voorbeeldantwoord

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "date": "2022-07-29",
            "acquisitionQuantity": 7,
            "purchasePriceUSDAmount": 0.0,
            "purchasePriceLocalAmount": 0.0,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
  ],
  "TotalCount": 1,
  "DataFreshnessTimestamp": "2022-07-29T08:42:00"
}

Voorbeeldaanvraag

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?applicationId=9NBLGGGZ5QDR&startDate=8/1/2021&endDate=12/21/2021&skip=0&filter=market&groupby=date,applicationName,acquisitionType,ageGroup,storeClient,gender,market,osVersion,deviceType  HTTP/1.1
Authorization: Bearer <your access token>

Voorbeeldantwoord

	{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "acquisitionType": "Free",
            "storeClient": "Microsoft Store (client)",
            "gender": "f",
            "market": "TW",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "date": "2021-08-01",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 0.0,
            "purchasePriceLocalAmount": 0.0,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "acquisitionType": "Free",
            "storeClient": "Microsoft Store (client)",
            "gender": "Unknown",
            "market": "BR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "date": "2021-08-01",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 0.0,
            "purchasePriceLocalAmount": 0.0,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
      ],  
  "TotalCount": 2,
  "DataFreshnessTimestamp": "2022-07-29T08:42:00"
 }
  • Last updated on