There are two primary approaches to reporting:

• RTB Object Reporting: Retrieve performance metrics alongside Advertisers, Campaigns, Lines, and other RTB objects.
• Custom Reports: Generate a report using selected dimensions, metrics, date ranges, and reporting intervals.

Scheduled reporting can also be used when the same report needs to be generated and delivered on a recurring basis.

RTB Object Reporting

RTB object endpoints can be used to retrieve object information together with performance metrics.

This is useful when an application needs to display or regularly retrieve performance for objects such as:

• Advertisers
• Campaigns
• Lines

Reporting parameters can be added to the applicable RTB endpoint to request metrics.

For example:

GET /rtb/advertisers?interval=1&metrics=true

The metrics=true parameter tells the API to include performance metrics with the returned objects.

The applicable interval determines the reporting period used for those metrics.

This approach is useful for dashboards, account management tools, and integrations that need performance data together with the underlying Pontiac objects.

For more granular reporting or reporting across a specific historical date range, use Custom Reports.

Custom Reports

Custom Reports allow you to define the structure of the report by selecting:

• Date range
• Reporting interval
• Dimensions
• Metrics
• Applicable Advertisers, Campaigns, Lines, or other filters

A Custom Report can be used when the predefined RTB object metrics do not provide the level of detail required.

For example, a report could be configured to return performance broken out by:

• Date
• Advertiser
• Campaign
• Line
• Creative

with metrics such as:

• Impressions
• Clicks
• Spend
• Conversions
• Post-Click Conversions
• Post-View Conversions
• Video or Audio events, where applicable

The complete list of supported dimensions and metrics is available in the API endpoint documentation.

Dimensions

Dimensions determine how report data is grouped.

For example, selecting:

Date
Line
Creative

produces reporting broken out by each unique combination of Date, Line, and Creative.

Adding more dimensions increases the granularity of the report and may significantly increase the number of returned rows.

Common dimensions may include:

• Date
• Hour
• Advertiser
• Campaign
• Line
• Creative
• Exchange
• Deal
• Geography
• Device
• Site or App
• Audience or Segment
• Other inventory and content dimensions

Only include dimensions that are required for the intended analysis.

Metrics

Metrics are the numerical performance values returned in the report.

Common metrics include:

• Impressions
• Clicks
• CTR
• Spend
• Conversions
• Post-Click Conversions
• Post-View Conversions
• Video Starts
• Video Quartiles
• Video Completions
• Audio events
• Other supported performance metrics

Metric availability can depend on the selected dimensions, inventory type, and report type.

Refer to the API endpoint documentation for the current list of available metrics.

Reporting Interval

The reporting interval determines the time granularity of the results.

For example, a report may return:

• Hourly data
• Daily data
• Aggregated data for the requested period

Use hourly reporting when performance needs to be analyzed within individual days.

Use daily reporting when analyzing performance over multiple days or longer Campaign periods.

The reporting interval is separate from the overall date range. For example, a report covering September 1 through September 30 with a daily interval returns performance broken out by each day in that date range.

Date Ranges

When using reports that support a defined date range, specify the applicable start and end dates for the period you want to analyze.

Historical reporting should be requested using the applicable reporting or Custom Report endpoint rather than relying only on a relative reporting interval such as “yesterday.”

This is especially important for integrations that need to backfill data if a scheduled API pull is missed.

For example, if an integration normally retrieves yesterday’s Creative performance each morning but fails to run, a Custom Report can be used to retrieve the missing historical date.

Time Zones

Time zone selection is important when comparing API reporting with data displayed in the Pontiac interface or with reports generated by another system.

Reporting dates and hours should always be interpreted using the timezone applicable to the report.

When reporting is displayed in a selected timezone, hourly data is converted into that timezone before it is presented.

Integrations that store daily or hourly reporting should keep the report timezone consistent across requests to avoid assigning activity to different dates or hours.

This is particularly important when:

• Comparing API results with Pontiac interface reporting
• Combining reports generated in different time zones
• Running scheduled reports
• Aggregating hourly data into daily totals