ad-server
Reporting API
Topsort’s Reporting API offers access to performance data across campaigns, vendors and marketplaces. You can download campaign and marketplace performance metrics such as:
- Daily or total reports for campaigns, vendors, products, or the entire marketplace.
- Scored attribution reports (via S3 links).
- Interaction reports: impressions, clicks, purchases by time granularity.
Reports are available at different contexts and levels of granularity:
-
Campaign Reports
- Total campaign and daily breakdown performance reports, including campaign metrics such as ROAS, CTR and CPC.
- Reports with aggregated metrics by product can also be obtained.
- Campaigns KPIs: list of campaign level KPIs, with optional filtering by vendor, ad formats and other fields.
-
Vendor Reports
- Total vendor and daily breakdown performance reports, including total impressions, clicks, purchases, ad spend and ROAS.
- Vendor level KPIs: list of vendor level KPIs.
-
Marketplace Reports
- Aggregated report on the marketplace level.
- Also available with daily breakdown.
-
Interaction Reports
- Allows exporting engagement (impressions, clicks, purchases) grouped by campaigns, products or vendors.
- Can optionally be aggregated by days or hours.
-
Attribution Files
- Topsort provides scored attribution files.
- The files include impressions, clicks and purchases associated with campaign IDs, along with the attribution data.
- The files are available in parquet format, downloaded via pre-signed URLs.