Skip to main content
Gebruik de Stats API om beschikbare metrics te ontdekken en haal daarna een tijdreeks op voor een account. De Stats-referentie legt elke metric uit, met de eenheden en ondersteunde filters.
Voor omzetquery’s van een account is de permissie stats:read vereist. Zie Permissies om permissies voor je app aan te vragen.

Metrics ontdekken

Geef tijdreeksmetrics weer om hun keys, namen, eenheden, beschrijvingen en filterbare eigenschappen op te halen:
Gebruik de key van een metric, zoals gross_revenue, in het volgende verzoek. De array properties bevat de eigenschappen waarop je kunt filteren of uitsplitsen.

Een tijdreeks ophalen

Geef je account-ID en een datumbereik door aan Retrieve metric time series:
De array data.points in het antwoord bevat voor elke periode een Unix-timestamp in seconden en een value. Lees de waarde in de eenheid uit de catalogus: count is een aantal, currency is een decimaal bedrag en percent staat al in procentpunten (1.6 betekent 1,6%). Sommige metrics geven ook data.totals terug voor het hele bereik. Gebruik die totalen wanneer ze beschikbaar zijn: het middelen van dagelijkse percentages of het optellen van dagelijkse unieke aantallen levert niet het resultaat voor het hele bereik op.

Resultaten filteren en uitsplitsen

Geef een eigenschap rechtstreeks door als queryparameter om erop te filteren. Gebruik breakdown_by om elk punt op één eigenschap uit te splitsen. Dit voorbeeld filtert de bruto-omzet op kaartbetalingen en splitst die uit naar de oorspronkelijke transactievaluta:
Elk punt bevat een array breakdown met { name, value }-items. Wanneer je transactiemetrics filtert of uitsplitst op currency, worden de bedragen in hun oorspronkelijke valuta gerapporteerd, zonder omrekening. Gebruik alleen eigenschappen die voor de metric worden vermeld. Een niet-ondersteunde eigenschap geeft 400 terug. Een onbekende metric-key geeft 404 terug. Zie de queryparameters en de metricreferentie voor tijdzones, intervallen, snapshotvensters en metricspecifieke opties.