Report builder

The Report Builder allows you to select a time interval, dimensions, metrics, and filters to create a custom report. Custom reports can be saved for future use, shared with other PubMatic platform users associated with your account, and scheduled for recurring delivery.

Reporting Glossary

For a full list of definitions for time presets, dimensions, and metrics for programmatic and wrapper reports, refer to the Reporting glossary.


Building a report

Follow these steps to build a custom report. For a description of dimensions, see programmatic dimensions and wrapper dimensions below.

You can select up to ten dimensions, but only five will display in the report. Dimensions can also be used as filters. This is useful if you don't want to view data for a dimension in a report, but want to use it to filter the values of other dimensions.

  1. From the main navigation menu, select Analytics > Report Builder
  2. Select Programmatic or Wrapper.
  3. Select the Time period for your report. If you want to do a time comparison, select Custom and choose the dates in the modal. See Time Comparison Reports for more information. 
  4. Select up to ten Dimensions and ten Metrics. Some things to know before making your selections:

    • You can select up to ten dimensions, but only five will display data in the report. Dimensions can also be used as filters. This is useful if you don't want to view data for a dimension in a report, but want to use it to filter the values of other dimensions.

    • For a description of dimensions and metrics, hover over the i icon.
    • When you select an item, it's added to the Selected panel on the right side of the page. To remove a selection, click the X to the right of the item name.
    • If a dimension or metric is greyed out, it's because it conflicts with another selected item(s). Hover over the ! icon to the right of the item name to find out what's conflicting. If you want to remove the conflict and add the item, select click here in the modal. 
  5. If you want to add filters, click Select Filters at the bottom of the page (this is optional).
    1. You can Show the Top or Bottom 10, 25, 50 or 100 dimensions by one of the metrics you've selected. Click the metric to select a different metric. 
    2. Hover over the grey funnel icon and then click Use as a Filter.  
  6. Click Generate Report. It may take a few seconds for the report to display.
  7. If you want to save this report parameters for future use, click Save.
  8. If you saved this report and want to view it in the future, go to the main navigation menu and select Analytics > Existing Reports > click the Custom tab.
    • To edit, share, schedule, or delete a report, click the Actions menu icon in to the left of the report name and follow the instructions in the modal.

Why a dimension reports as "Other"

The dimensions listed below will report results as "Other" in reporting if the value does not meet the associated threshold for that week. If the dimension value begins reporting more than the threshold revenue for the week, it will then be reported individually (with specific results) starting the following week.

DimensionThreshold
Advertiser & Advertiser Domain> $10 in spend across the PubMatic platform in a week
Site> $10 in revenue in a week
Ad Tag> $5 in spend in a week

Example:

Ad Tag DimensionRevenue per week
1$3
2$4
3$20
4$21
5$25

 the above would be reported as:

Ad Tag DimensionRevenue per week
3$20
4$21
5$25
Other$7

Programmatic dimensions

This table provides a description for all reporting dimensions. See wrapper dimensions below.

You can select up to ten dimensions, but only five will display in the report. Dimensions can also be used as filters. This is useful if you don't want to view data for a dimension in a report, but want to use it to filter the values of other dimensions.


Ad Attributes

Ad Format

Type of ad associated with the impression. For example, video, display.

Ad Size

Size of ad associated with the impression.

Buyer

Ad Network (Group)

Name of the parent ad network which monetized the impression.

Note: This dimension can be combined only with the following dimensions - Ad Format, Ad Size, Ad Network (Variant), Category, Ad Tag, Fold Position (Placement), Secure Status, Site, Date and Hour.

Ad Network (Variant)

Name of the ad network's campaign which monetized the impression.

Note: This dimension can be combined only with the following dimensions - Ad Format, Ad Size, Ad Network (Group), Category, Ad Tag, Fold Position (Placement), Secure Status, Site, Date and Hour.

Advertiser

Name of the advertiser associated with the ad.

Advertiser Domain

Domain Name (web address) of the Advertiser. These domains are identified by the landing page of the impression displayed.

Buyer

Name of the ATD, agency or buyer associated with the DSP who won the impression.

Note: For non-zero bids, you need to select the NonZero Bids Received bid metrics rather than NonZero Bids Response metrics.

Campaign

Name of the RTB campaign which won the impression.

Category

Category of the advertiser associated with the ad.

Note: Both PubMatic categories and IAB categories will be displayed. PubMatic categories will be prefixed with pm. Example, pm_<categoryName>, pm_fashion. 

DSP

Name of the DSP that won the impression.

Deal

Name of the Marketplace deal that won the impression.

Note: This dimension can be combined only with the following dimensions - Ad Format, Ad Size, Advertiser, Buyer, Category, DSP, Platform, Site, Date and Hour.

Inventory

Ad Tag

Name of the ad tag using which an impression was requested.

Cookied Bid

Indicates whether the DSP's cookies were dropped or not when an impression was requested.

Fold Position (Placement)

Fold placement associated with the ad tag from which an impression was requested.

Placement Type

Secure Status

Indicates whether the inventory is secure or not.

Site

URL of the site from which an impression was requested.

Vertical

Category of the site from which an impression was requested.

General

Channel

Sales channel through which the impression was won. For example, PMP, RTB

Platform

Platform through which an impression was requested. For example, web, mobile web.

Geography 

Country

Country from which an impression was requested.

Time units

Date

Date (in the YYYY-MM-DD format) on which an impression was requested.

Hour

Time (in the 24-hour HH format) at which an impression was received. This dimension can only be used for records generated in the last 48 hours.

Month

Month (YYYY-MM-format) at which an impression was received.

Mobile 

Mobile - Device ID Present

Indicates whether the user's device ID is present or not in the impression requests.

Mobile - Device ID Type

Type of device ID used by the visitor to generate an impression request.

Mobile - Device Type

Type of device used by the visitor to generate an impression request.

Mobile - Geo Source

Source using which the geographical location of the visitor has been provided.

Mobile - Lat/Long

Indicates whether the latitude/longitude details of the visitor have been included in the impression request or not.

Wrapper dimensions

This table provides a description for all wrapper dimensions. See programmatic dimensions above.

Wrapper

Ad FormatType of ad associated with the impression. For example, video, display.
AdvertiserName of the advertiser associated with the ad.
Blocked Reason CodeReason code for a rejected ad.
CountryCountry from which an impression was requested.
DomainDomain name (web address) of the advertiser. D omains are identified by the landing page of the impression displayed.

Partner

SSP/Exchanges whose header tag is included in the wrapper.

PlatformPlatform through which an impression was requested. For example, web, mobile web.

Profile

Defines inventory for the wrapper. Includes configuration settings for the OpenWrap.

Profile VersionA version of a profile. Refers to the settings included in the profile. One profile can include multiple versions (only one can be the live version in production).
Server/ClientAd requests go first to an OpenWrap server, which then sends them to partners. Server-side request processing can speed web page loading but can reduce user match rate compared to client-side processing.
Test GroupFor A/B tests, where the request was assigned to the control group of the test group.

Time units

Date

Date (in the YYYY-MM-DD format) on which an impression was requested.

Hour

Time (in the 24-hour HH format) at which an impression was received. This dimension can only be used for records generated in the last 48 hours.

Wrapper metrics

Ad attributes

Avg Latency (ms)

Average time it takes a demand partner to respond to a bid request.

Bid Rate

Percentage of requests to a demand partner that result in a non-zero bid.

Bid eCPMAverage CPM of a demand partner's non-zero bids.
Fill RatePercentage of requests to a demand partner that result in a monetized impression.
Monetized ImpressionsNumber of impressions monetized by a demand partner.
Monetized eCPMThe average CPM of monetized impressions.
RequestsNumber of ad impressions for which a request was sent to a demand partner.
ResponsesNumber of ad impressions for which a demand partner responded with a non-zero bid.
RevenueRevenue for monetized impressions.
S2S Match Rate% of requests where a S2S request to a demand partner had the demand partner's user ID available.
Timeout RateThe percentage of requests timed out.
TimeoutsAverage number of requests that timed out.
Win RatePercentage of request to demand partner where the demand partner wins at OpenWrap

Video metrics

Ad Pod Ad Paid Impressions

Monetized ad impressions in an ad pod.

Ad Pod Ads Returned

Total number of ads that were returned for an ad pod.

Ad Pod Ads Returned Duration

Aggregate passed, extracted, or max ad durations, in seconds.

Ad Pod RequestsNumber of requests that were made for an ad pod.
Avg. Ad Pod Ad Paid Impressions per Pod

The formula for determining this metric:

avg. ad pod ad paid impressions per pod = ad pod ad paid impressions / ad pod requests

Avg. Ad Pod Ads Returned per Pod

The formula for determining this metric:

avg. ad pod ads returned per pod = ad pod ads returned / ad pod requests

Table of Contents