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: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: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. Gebruikbreakdown_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:
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.
