Delen via

Trechtergegevens voor app-overname ophalen

Gebruik deze methode in de Microsoft Store analytics-API om trechtergegevens voor een toepassing op te halen 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/funnel

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 gegevens van de overnametrechter wilt ophalen. Een voorbeeld van store-id is 9WZDNCRFJ3Q8. Ja
begindatum datum De startdatum in het datumbereik van acquisitiekanaalgegevens die moeten worden opgehaald. De standaardwaarde is de huidige datum. Nee.
einddatum datum De einddatum binnen het datumbereik van gegevens uit de acquisitietrechter die moeten worden opgehaald. De standaardwaarde is de huidige datum. Nee.
filter touw Een of meer instructies waarmee de rijen in het antwoord worden gefilterd. Zie de sectie filtervelden hieronder voor meer informatie. Nee.

 

Filtervelden

De filterparameter van de aanvraag bevat een of meer instructies waarmee de rijen in het antwoord worden gefilterd. Elke instructie bevat een veld en waarde die zijn gekoppeld aan de eq- of ne-operators, en instructies kunnen worden gecombineerd met enof.

De volgende filtervelden worden ondersteund. Tekenreekswaarden moeten tussen enkele aanhalingstekens staan in parameter van het filter.

Velden Beschrijving
campagne-ID De ID-string voor een aangepaste app-promotiecampagne die verbonden is met de acquisitie.
markt Een tekenreeks die de ISO 3166-landcode van de markt bevat waar de overname heeft plaatsgevonden.
apparaatstype Een van de volgende tekenreeksen waarmee het apparaattype wordt opgegeven waarop de overname heeft plaatsgevonden:
  • PC
  • Telefoon
  • Console-Xbox One
  • Console-Xbox Serie X
  • Goddelijke Revolutie
  • Holografisch
  • Onbekend
leeftijdsgroep Een van de volgende tekenreeksen die de leeftijdsgroep aangeeft van de gebruiker die de overname heeft voltooid:
  • 0 - 17
  • 18 – 24
  • 25 – 34
  • 35 – 49
  • 50 of meer
  • Onbekend
geslacht Een van de volgende tekenreeksen die het geslacht aangeeft van de gebruiker die de overname heeft voltooid:
  • M
  • F
  • Onbekend

Vraag om voorbeeld

In het volgende voorbeeld ziet u verschillende verzoeken voor het verkrijgen van acquisitiefunnelgegevens van een app. Vervang de applicationId-waarde door de Store-id voor uw app.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=1/1/2017&endDate=2/1/2017  HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=8/1/2016&endDate=8/31/2016&filter=market eq 'US' and gender eq 'm'  HTTP/1.1
Authorization: Bearer <your access token>

Reactie

Antwoordlichaam

Waarde Typologie Beschrijving
Waarde gegevensreeks Een reeks objecten die acquisitietrechtergegevens voor de app bevatten. Voor meer informatie over de gegevens in elk object, zie de sectie trechterwaarden hieronder.
Totaalaantal int (integer) Het totale aantal objecten in de matrix Waarde .

Trechterwaarden

Objecten in de waarde matrix bevatten de volgende waarden.

Waarde Typologie Beschrijving
Type van Meting touw Een van de volgende tekenreeksen die het -type van trechtergegevens aangeeft dat in dit object is opgenomen:
  • PageView
  • overname
  • Installeren
  • Gebruik
AantalGebruikers touw Het aantal gebruikers dat de opgegeven funnelstap heeft uitgevoerd, zoals gespecificeerd door de MetricType waarde.

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

Voorbeeldantwoord

{
    "Value": [
        {
            "MetricType": "PageView",
            "UserCount": 6214
        },
        {
            "MetricType": "Acquisition",
            "UserCount": 1502
        },
        {
            "MetricType": "Usage",
            "UserCount": 606
        },
        {
            "MetricType": "Install",
            "UserCount": 977
        }
    ],
    "TotalCount": 4
}

Voorbeeldaanvraag

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=12/19/2021&endDate=12/21/2021&filter=market eq 'US' and gender eq 'm'
HTTP/1.1
Authorization: Bearer <your access token>

Voorbeeldantwoord

{
    "Value": [
        {
            "MetricType": "PageView",
            "UserCount": 10
        },
        {
            "MetricType": "Acquisition",
            "UserCount": 8
        },
        {
            "MetricType": "Usage",
            "UserCount": 5
        },
        {
            "MetricType": "Install",
            "UserCount": 3
        }
    ],
    "TotalCount": 4
}
  • Last updated on