{"id":14753,"date":"2026-09-01T19:45:24","date_gmt":"2026-09-01T19:45:24","guid":{"rendered":"https:\/\/wiki.pontiac.media\/?docs=api\/bidder-api-reporting\/reporting-methods"},"modified":"2026-09-01T19:53:43","modified_gmt":"2026-09-01T19:53:43","slug":"reporting-methods","status":"publish","type":"docs","link":"https:\/\/wiki.pontiac.media\/?docs=api\/bidder-api-reporting\/reporting-methods","title":{"rendered":"Reporting Methods"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">There are two primary approaches to reporting:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>RTB Object Reporting:<\/strong> Retrieve performance metrics alongside Advertisers, Campaigns, Lines, and other RTB objects.<\/li>\n\n\n\n<li><strong>Custom Reports:<\/strong> Generate a report using selected dimensions, metrics, date ranges, and reporting intervals.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Scheduled reporting can also be used when the same report needs to be generated and delivered on a recurring basis.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">RTB Object Reporting<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">RTB object endpoints can be used to retrieve object information together with performance metrics.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is useful when an application needs to display or regularly retrieve performance for objects such as:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Advertisers<\/li>\n\n\n\n<li>Campaigns<\/li>\n\n\n\n<li>Lines<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Reporting parameters can be added to the applicable RTB endpoint to request metrics.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET \/rtb\/advertisers?interval=1&amp;metrics=true<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The <code>metrics=true<\/code> parameter tells the API to include performance metrics with the returned objects.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The applicable <code>interval<\/code> determines the reporting period used for those metrics.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This approach is useful for dashboards, account management tools, and integrations that need performance data together with the underlying Pontiac objects.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For more granular reporting or reporting across a specific historical date range, use Custom Reports.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Custom Reports<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Custom Reports allow you to define the structure of the report by selecting:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Date range<\/li>\n\n\n\n<li>Reporting interval<\/li>\n\n\n\n<li>Dimensions<\/li>\n\n\n\n<li>Metrics<\/li>\n\n\n\n<li>Applicable Advertisers, Campaigns, Lines, or other filters<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">A Custom Report can be used when the predefined RTB object metrics do not provide the level of detail required.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example, a report could be configured to return performance broken out by:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Date<\/li>\n\n\n\n<li>Advertiser<\/li>\n\n\n\n<li>Campaign<\/li>\n\n\n\n<li>Line<\/li>\n\n\n\n<li>Creative<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">with metrics such as:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Impressions<\/li>\n\n\n\n<li>Clicks<\/li>\n\n\n\n<li>Spend<\/li>\n\n\n\n<li>Conversions<\/li>\n\n\n\n<li>Post-Click Conversions<\/li>\n\n\n\n<li>Post-View Conversions<\/li>\n\n\n\n<li>Video or Audio events, where applicable<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">The complete list of supported dimensions and metrics is available in the API endpoint documentation.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Dimensions<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Dimensions determine how report data is grouped.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example, selecting:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Date\nLine\nCreative<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">produces reporting broken out by each unique combination of Date, Line, and Creative.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Adding more dimensions increases the granularity of the report and may significantly increase the number of returned rows.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Common dimensions may include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Date<\/li>\n\n\n\n<li>Hour<\/li>\n\n\n\n<li>Advertiser<\/li>\n\n\n\n<li>Campaign<\/li>\n\n\n\n<li>Line<\/li>\n\n\n\n<li>Creative<\/li>\n\n\n\n<li>Exchange<\/li>\n\n\n\n<li>Deal<\/li>\n\n\n\n<li>Geography<\/li>\n\n\n\n<li>Device<\/li>\n\n\n\n<li>Site or App<\/li>\n\n\n\n<li>Audience or Segment<\/li>\n\n\n\n<li>Other inventory and content dimensions<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Only include dimensions that are required for the intended analysis.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Metrics<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Metrics are the numerical performance values returned in the report.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Common metrics include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Impressions<\/li>\n\n\n\n<li>Clicks<\/li>\n\n\n\n<li>CTR<\/li>\n\n\n\n<li>Spend<\/li>\n\n\n\n<li>Conversions<\/li>\n\n\n\n<li>Post-Click Conversions<\/li>\n\n\n\n<li>Post-View Conversions<\/li>\n\n\n\n<li>Video Starts<\/li>\n\n\n\n<li>Video Quartiles<\/li>\n\n\n\n<li>Video Completions<\/li>\n\n\n\n<li>Audio events<\/li>\n\n\n\n<li>Other supported performance metrics<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Metric availability can depend on the selected dimensions, inventory type, and report type.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Refer to the API endpoint documentation for the current list of available metrics.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Reporting Interval<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">The reporting interval determines the time granularity of the results.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example, a report may return:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Hourly data<\/li>\n\n\n\n<li>Daily data<\/li>\n\n\n\n<li>Aggregated data for the requested period<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Use hourly reporting when performance needs to be analyzed within individual days.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Use daily reporting when analyzing performance over multiple days or longer Campaign periods.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Date Ranges<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">When using reports that support a defined date range, specify the applicable start and end dates for the period you want to analyze.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Historical reporting should be requested using the applicable reporting or Custom Report endpoint rather than relying only on a relative reporting interval such as &#8220;yesterday.&#8221;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is especially important for integrations that need to backfill data if a scheduled API pull is missed.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example, if an integration normally retrieves yesterday&#8217;s Creative performance each morning but fails to run, a Custom Report can be used to retrieve the missing historical date.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Time Zones<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Time zone selection is important when comparing API reporting with data displayed in the Pontiac interface or with reports generated by another system.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Reporting dates and hours should always be interpreted using the timezone applicable to the report.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When reporting is displayed in a selected timezone, hourly data is converted into that timezone before it is presented.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Integrations that store daily or hourly reporting should keep the report timezone consistent across requests to avoid assigning activity to different dates or hours.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is particularly important when:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Comparing API results with Pontiac interface reporting<\/li>\n\n\n\n<li>Combining reports generated in different time zones<\/li>\n\n\n\n<li>Running scheduled reports<\/li>\n\n\n\n<li>Aggregating hourly data into daily totals<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"author":17,"featured_media":0,"parent":14750,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_is_vendor_doc":"0","footnotes":""},"doc_tag":[],"class_list":["post-14753","docs","type-docs","status-publish","hentry","no-post-thumbnail"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14753","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/users\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=14753"}],"version-history":[{"count":1,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14753\/revisions"}],"predecessor-version":[{"id":14765,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14753\/revisions\/14765"}],"up":[{"embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14750"}],"next":[{"title":"Report Generation","link":"https:\/\/wiki.pontiac.media\/?docs=api\/bidder-api-reporting\/report-generation","href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=\/wp\/v2\/docs\/14754"}],"wp:attachment":[{"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=14753"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/wiki.pontiac.media\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=14753"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}