This guide will teach you how to generate reports for auction-based setups using the Programmatic Reports sub-section of the Statistics section. If you're already familiar with the Statistics Reports sub-section, you'll be able to generate programmatic reports as well because their interfaces are the same.

Note: Unlike Statistics Reports for manual setups, we currently do not have the option to save reports and to send automatically generated scheduled reports via email for the Programmatic Reports sub-section.

Types of Programmatic Reports

  • Auction Placement Statistics: this report contains statistics for auction-based placements.
  • S2S Statistics: this report contains statistics for server-to-server ad items.
  • Demand Source Statistics: this report contains statistics for all programmatic demand sources and demand endpoints.
  • Supply/Demand Breakdown: this report is a more detailed version of Demand Source Statistics, showing a breakdown of demand endpoints statistics per publisher and zone.
  • Bidder Zones: this report contains statistics for header bidders.

How to Create a Custom Programmatic Report

You cannot customize the information in Supply/Demand Breakdown, so you only need to select a period from the dropdown then click Generate Report to create this report.

The following instructions apply to Auction Placement Statistics, S2S Statistics, Demand Source Statistics, and Bidder Reports.

  1. Click on Statistics near the bottom of the left-hand navigation menu, then click on Programmatic Reports to expand the submenu.
  2. Click on the report you wish to create.
  3. Set your filters:
    • Report: this is where you choose the subject of the report. The subjects that you can select may vary depending on the report.
    • Gear icon: this is where you choose which metrics or information to include in the report. Simply check or uncheck the options to include or exclude them.
    • Filters: this is where you can further narrow down the included subjects of the report.
    • Date dropdown menu: this is where you specify the period that will be covered in the report. You can select from the various presets or enter start and end dates.
  4. After you have selected your filters, click Generate Report. Your custom report will load shortly at the bottom of the page. If you are not satisfied with the generated report, simply make your changes then click Generate Report again.

Information and Metrics in a Custom Programmatic Report

These are the possible details that you can include in a custom programmatic report.

Note: The rows in a custom report are arranged chronologically by default. You can rearrange the order of the rows by clicking on the name of a column. For example, clicking on Requests will sort the rows by descending order of that metric. Clicking on Requests again will sort the rows by ascending order.

  • Date: this is a mandatory column. It's the default way by which the report is organized, and easily lets you pinpoint trends if there are any.
  • Parent: this is a mandatory column. This identifies the entity that owns the subject of the report. For example, if you chose zones to be the subject of your report, then each row in the Parent column will show the publisher to which the listed zone belongs. If you chose demand endpoints to be the subject of your report, the Parent column will show the demand sources for the listed demand endpoints.
  • Requests (Bid Requests): the number of times that Indie Ads Manager sent a Bid Request to the Demand Endpoint within the chosen period.
  • Responses: the number of times that Demand Endpoints responded to Bid Requests within the chosen period.
  • Empty (Empty Responses): the number of times when there was no bid for the request within the chosen period.
  • Filled (Filled Responses): the number of times when the response contained a bid for the impression within the chosen period.
  • Fill %: the percentage of filled requests for the chosen period. Its formula is Filled/Requests.
  • Auction Wins or Wins: the number of times when the bid from the endpoint was the highest and the winning bid within the chosen period.
  • Win %: the percentage of winning bids for the chosen period. Its formula is Wins/Filled.
  • View %: the percentage of impressions from the winning bids for the chosen period. Its formula is Views/Wins.
  • Gross Earnings: the amount paid by the advertiser(s) through the Endpoint for the chosen period.
  • Pub. Earnings (Publisher Earnings): the portion of the gross earnings for the chosen period that goes to the publisher(s).
  • Company Earnings: your gross earnings for the chosen period.