Delen via

Maandelijkse app-gebruiksgegevens verzamelen

Gebruik deze methode in de Microsoft Store Analytics-API om geaggregeerde gebruiksgegevens op te halen (niet inclusief Xbox multiplayer) in JSON-indeling voor een toepassing gedurende een bepaald datumbereik (alleen afgelopen 90 dagen) en andere optionele filters. Deze informatie is ook beschikbaar in het gebruiksrapport in het Partnercentrum.

Telemetrie voor op Anaheim gebaseerde PWA-apps wordt verzameld op apparaatniveau. Metrische gegevens met betrekking tot gebruikers zijn dus niet beschikbaar voor dergelijke producten. Raadpleeg de onderstaande sectie Gebruikswaarden voor meer informatie over de geldigheid van velden.

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/usagemonthly

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 beoordelingsgegevens wilt ophalen. Ja
begindatum datum De begindatum in het datumbereik van controlegegevens die moeten worden opgehaald. De standaardwaarde is de huidige datum. Nee.
einddatum datum De einddatum in het datumbereik van controlegegevens 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 uitdrukking bevat een veldnaam uit het antwoordbericht en waarden die zijn gekoppeld aan de eq- of ne-operators , en uitdrukkingen kunnen worden gecombineerd met en of of. Tekenreekswaarden moeten tussen enkele aanhalingstekens in de filterparameter staan. U kunt de volgende velden opgeven in de hoofdtekst van het antwoord:
  • markt
  • apparaatstype
  • pakket Versie
 Nee.
volgorde touw Een verklaring die de resultaatgegevenswaarden ordent. De syntaxis is orderby=field [order],field [order],.... De veldparameter kan een van de volgende tekenreeksen zijn:
  • datum
  • applicationId
  • applicatie Naam
  • markt
  • pakket Versie
  • apparaatstype
  • abonnement Naam
  • maandelijkseSessieAantal
  • betrokkenheidsduurInMinuten
  • maandelijks actieve gebruikers
  • maandelijks actieve apparaten
  • maandelijkseNieuweGebruikers
  • gemiddeldeDagelijkseActieveGebruikers
  • gemiddeldeDagelijkseActieveApparaten
  • maandelijkseNieuweApparaten

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 in de hoofdtekst van het antwoord:
  • applicatie Naam
  • abonnement Naam
  • apparaatstype
  • pakket Versie
  • markt
  • datum

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

  • applicationId
  • abonnement Naam
  • maandelijkseSessieAantal
  • betrokkenheidsduurInMinuten
  • maandelijks actieve gebruikers
  • maandelijks actieve apparaten
  • maandelijkseNieuweGebruikers
  • gemiddeldeDagelijkseActieveGebruikers
  • gemiddeldeDagelijkseActieveApparaten
  • maandelijkseNieuweApparaten

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 een aanvraag voor het ophalen van maandelijkse app-gebruiksgegevens. Vervang de applicationId-waarde door de Store-id voor uw app.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/usagemonthly?applicationId=XXXXXXXXXXXX&startDate=2018-06-01&endDate=2018-07-01 HTTP/1.1  
Authorization: Bearer <your access token>

Reactie

Antwoordlichaam

Waarde Typologie Beschrijving
Waarde gegevensreeks Een matrix met objecten die statistische gebruiksgegevens 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 100000, maar er meer dan 10000 rijen met beoordelingsgegevens voor de query zijn.
Totaalaantal int (integer) Het totale aantal rijen in het gegevensresultaat voor de query.

 

Gebruikswaarden

Elementen in de matrix Waarde bevatten de volgende waarden.

Waarde Typologie Beschrijving Beschikbaarheid van UWP Beschikbaarheid van PWA vanuit Anaheim Beschikbaarheid van Xbox
datum touw De eerste datum in het datumbereik voor de gebruiksgegevens. 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. Ja Ja Ja
applicationId touw De Store-id van de app waarvoor u gebruiksgegevens opvragen. Ja Ja Ja
naam van de applicatie touw De weergavenaam van de app. Ja Ja Ja
markt touw De ISO 3166-landcode van de markt waar de klant uw app heeft gebruikt. Ja Ja Ja
pakketversie touw De versie van het pakket waar het gebruik heeft plaatsgevonden. Ja Ja Nee.
apparaatstype touw Een van de volgende tekenreeksen waarmee het type apparaat wordt opgegeven waarop het gebruik is opgetreden:
  • PC
  • Telefoon
  • Console-Xbox een
  • Console-Xbox Serie X
  • Tablet
  • Goddelijke Revolutie
  • Server
  • Holografisch
  • Onbekend
 Ja Ja Ja
abonnementsnaam touw Geeft aan of het gebruik via Xbox Game Pass is. Ja Nee. Nee.
maandelijkseSessieTelling lang Het aantal gebruikerssessies gedurende die maand. Ja Ja Ja
betrokkenheidsduurInMinuten dubbel De minuten waarin gebruikers uw app actief gebruiken, gemeten door een bepaalde periode, beginnend wanneer de app wordt gestart (proces starten) en eindigt wanneer deze wordt beëindigd (proceseinde) of na een periode van inactiviteit. Ja Ja Ja
maandelijksActieveGebruikers lang Het aantal klanten dat de app die maand gebruikt. Ja Nee. Ja
maandelijks actieve apparaten lang Het aantal apparaten waarop uw app gedurende een bepaalde periode wordt uitgevoerd, te beginnen wanneer de app wordt gestart (proces starten) en eindigt wanneer de app wordt beëindigd (proceseinde) of na een periode van inactiviteit. Ja Ja Ja
maandelijkseNieuweGebruikers lang Het aantal klanten dat uw app voor de eerste keer van die maand heeft gebruikt. Ja Nee. Ja
gemiddelde dagelijkse actieve gebruikers dubbel Het gemiddelde aantal klanten dat de app dagelijks gebruikt. Ja Nee. Ja
gemiddeldDagelijksActieveApparaten dubbel Het gemiddelde aantal apparaten dat wordt gebruikt om dagelijks met uw app te communiceren door alle gebruikers. Ja Ja Ja
maandelijksNieuweApparaten lang Het aantal apparaten dat de app voor het eerst in die maand heeft gebruikt. Nee. Ja Nee.

Opmerking

Als een veld niet geldig is voor een specifiek product, wordt de waarde naar deze velden verzonden als 0 of null in het antwoord. De berekening van nieuwe gebruikers en nieuwe apparaten wordt uitgevoerd met het doorlopende venster van 3 jaar, d.w.w.: als een gebruiker/apparaat de toepassing gedurende 3 jaar en hoger niet gebruikt, worden ze na 3 jaar behandeld als nieuw gebruiker/apparaat.

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/usagemonthly?applicationId=9NBLGGGZ5QDR
HTTP/1.1
Authorization: Bearer <your access token>

Voorbeeldantwoord

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "deviceType": "All",
            "packageVersion": "All",
            "market": "All",
            "engagementDurationMinutes": 2828568.3,
            "monthlyActiveUsers": 165249,
            "monthlyActiveDevices": 165753,
            "monthlyNewUsers": 95787,
            "monthlySessionCount": 314263,
            "averageDailyActiveUsers": 192.506111111111,
            "averageDailyActiveDevices": 191.199722222222,
            "monthlyNewDevices": 0
        }
    ],
    "TotalCount": 1
}

Voorbeeldaanvraag

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/usagemonthly?applicationId=9NBLGGGZ5QDR&startDate=2022-06-01&endDate=2022-07-01&groupby=applicationName,subscriptionName,deviceType,packageVersion,market,date&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

Voorbeeldantwoord

{
    "Value": [
        {
            "date": "2022-06-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "1.0.0.4957",
            "market": "JP",
            "engagementDurationMinutes": 0.3,
            "monthlyActiveUsers": 1,
            "monthlyActiveDevices": 1,
            "monthlyNewUsers": 0,
            "monthlySessionCount": 1,
            "averageDailyActiveUsers": 0.03,
            "averageDailyActiveDevices": 0.03,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "1.0.0.4957",
            "market": "MX",
            "engagementDurationMinutes": 2.7,
            "monthlyActiveUsers": 1,
            "monthlyActiveDevices": 1,
            "monthlyNewUsers": 0,
            "monthlySessionCount": 1,
            "averageDailyActiveUsers": 0.03,
            "averageDailyActiveDevices": 0.03,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "1.0.0.4957",
            "market": "Unknown",
            "engagementDurationMinutes": 0.1,
            "monthlyActiveUsers": 1,
            "monthlyActiveDevices": 1,
            "monthlyNewUsers": 0,
            "monthlySessionCount": 1,
            "averageDailyActiveUsers": 0.03,
            "averageDailyActiveDevices": 0.03,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "1.0.0.4957",
            "market": "US",
            "engagementDurationMinutes": 0.2,
            "monthlyActiveUsers": 1,
            "monthlyActiveDevices": 1,
            "monthlyNewUsers": 0,
            "monthlySessionCount": 1,
            "averageDailyActiveUsers": 0.03,
            "averageDailyActiveDevices": 0.03,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AE",
            "engagementDurationMinutes": 3.2,
            "monthlyActiveUsers": 2,
            "monthlyActiveDevices": 2,
            "monthlyNewUsers": 0,
            "monthlySessionCount": 3,
            "averageDailyActiveUsers": 0.07,
            "averageDailyActiveDevices": 0.07,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AO",
            "engagementDurationMinutes": 1.2,
            "monthlyActiveUsers": 1,
            "monthlyActiveDevices": 1,
            "monthlyNewUsers": 0,
            "monthlySessionCount": 1,
            "averageDailyActiveUsers": 0.03,
            "averageDailyActiveDevices": 0.03,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AR",
            "engagementDurationMinutes": 574.7,
            "monthlyActiveUsers": 39,
            "monthlyActiveDevices": 39,
            "monthlyNewUsers": 0,
            "monthlySessionCount": 53,
            "averageDailyActiveUsers": 1.43,
            "averageDailyActiveDevices": 1.43,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AT",
            "engagementDurationMinutes": 5.3,
            "monthlyActiveUsers": 4,
            "monthlyActiveDevices": 4,
            "monthlyNewUsers": 0,
            "monthlySessionCount": 9,
            "averageDailyActiveUsers": 0.17,
            "averageDailyActiveDevices": 0.17,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AU",
            "engagementDurationMinutes": 434.7,
            "monthlyActiveUsers": 22,
            "monthlyActiveDevices": 22,
            "monthlyNewUsers": 0,
            "monthlySessionCount": 36,
            "averageDailyActiveUsers": 0.9,
            "averageDailyActiveDevices": 0.9,
            "monthlyNewDevices": 0
        },
        {
            "date": "2022-06-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "subscriptionName": "null",
            "deviceType": "PC",
            "packageVersion": "2.5.2.34894",
            "market": "AZ",
            "engagementDurationMinutes": 13.5,
            "monthlyActiveUsers": 1,
            "monthlyActiveDevices": 1,
            "monthlyNewUsers": 0,
            "monthlySessionCount": 1,
            "averageDailyActiveUsers": 0.03,
            "averageDailyActiveDevices": 0.03,
            "monthlyNewDevices": 0
        }
    ],
    "TotalCount": 10
}
  • Last updated on