Documentation

Reports and saved views

Updated 17 Nov 2026

Reports group the click log by campaign, offer, geography, device, tokens, and time. Free queries the last 15 days and at most 2 dimensions. Pro and above keep full history and 5 dimensions. Each user can save a view. CSV export uses the same query.

Grouping and metrics

The report engine accepts these dimensions: campaign_id, offer_id, lander_id, flow_id, path_id, country, region, city, isp, device, os, browser, language, is_bot, token1–token10, zone, hour, and day. The report screen’s dimension picker lists token1–token3 only. token4–token10 and is_bot still work through the API and through MCP report_query.

Built-in metrics are clicks, uniques, bot clicks, cost, conversions, pending, rejected, trash, revenue, pending revenue, trash revenue, CR, EPC, ROI, plus profit, CPA, and CPC derived from those. Custom metrics are formulas over the base metrics, up to 12, stored as the custom_metrics setting. That feature is Pro (and Team and Founder). Free does not get it.

Plan limits

Free: report lookback is 15 days, and a query may group by at most 2 dimensions. The pricing FAQ says older data is kept; the entitlement limits the query window, it is not a delete job described in the license package. Pro sets lookback and the campaign cap to unlimited (the stored number is 0) and allows 5 group-by dimensions. Team and Founder use the Pro report limits. Team also keeps the audit log, which is separate from reports.

A tree drill-down in the UI, when you group by two or more dimensions and drilling is on, requests the first dimension for the child rows. The default query limit in the UI is 1000 rows. POST /api/reports/export writes CSV. The UI asks for a BOM with ?bom=1.

Saved views and schedules

report_views stores a name and a JSON config per user. Create and delete them in the report UI or with list_report_views, save_report_view, and delete_report_view. Scheduled email reports need the Pro feature scheduled_reports, and the server needs VELOTRAK_SMTP_* set. The dashboard (GET /api/dashboard) returns totals, a comparison window, a series, top campaigns, and the last backup time.

Cost figures in these reports come from the click’s cost column. How that column is filled is cost allocation.