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.

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 matrics 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 who won the impression.

Deal

Name of the Marketplace deal which 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.

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

Partner

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

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.

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.

⇧ Top

Do you have feedback on this document? Let us know: email us.

Table of Contents