Skip to content
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:

  1. Campaign Reports

    1. Total campaign and daily breakdown performance reports, including campaign metrics such as ROAS, CTR and CPC.
    2. Reports with aggregated metrics by product can also be obtained.
    3. Campaigns KPIs: list of campaign level KPIs, with optional filtering by vendor, ad formats and other fields.
  2. Vendor Reports

    1. Total vendor and daily breakdown performance reports, including total impressions, clicks, purchases, ad spend and ROAS.
    2. Vendor level KPIs: list of vendor level KPIs.
  3. Marketplace Reports

    1. Aggregated report on the marketplace level.
    2. Also available with daily breakdown.
  4. Interaction Reports

    1. Allows exporting engagement (impressions, clicks, purchases) grouped by campaigns, products or vendors.
    2. Can optionally be aggregated by days or hours.
  5. Attribution Files

    1. Topsort provides scored attribution files.
    2. The files include impressions, clicks and purchases associated with campaign IDs, along with the attribution data.
    3. The files are available in parquet format, downloaded via pre-signed URLs.