Universal content categories report
The Universal Content Categories Report lets you research and break down the amount of inventory available from sellers across universal content categories and domains. You can also find out what creative sizes were shown in what countries. Sample use cases include:
- Buyers who want to know the volume available for a given universal content category
- Buyers who want to see how many impressions are available at the intersection of a universal content category and seller
- Buyers who want to know the volume available at the intersection of universal content category and country in a given creative size
To access this report, go to Network > Inventory > Reporting and select Universal Content Categories from the Type dropdown. For more information on the available data fields and their definitions, see Dimensions and Metrics below.
For instructions on running the report, see To Run Your Report.
Time frame
All dates and times are given in UTC.
Time ranges
Time ranges define the time period of the data extracted for the report. The following is a complete list of time ranges available for reports.
However, all time ranges are not available for every report.
- Custom
- Current Hour
- Last Available Day
- Last Hour
- Today
- Last 24 Hours
- Last 48 Hours
- Yesterday
- Last 2 Days
- Last 7 Days
- Last 7 Available Days
- Last 14 Days
- Last 14 Available Days
- Last 30 Days
- Last 30 Available Days
- Last Month
- Last 100 Days
- Last 365 Days
- Quarter to Date
- Month to Date
- Month to Yesterday
- Lifetime
Intervals
Intervals determine how your data is grouped together into rows in the report response. The following is a complete list of intervals available for reports. However, all intervals are not available for every report.
- Hourly: Data is grouped into rows by the hour.
- Daily: Data is grouped into rows by the day.
- Monthly: Data is grouped into rows by the month.
- Cumulative: Data is grouped together in one figure, covering the entire selected time range.
This report's data is retained for 60 days.
Dimensions
Note
The Filter? column shows whether a dimension can be used as a filter as well as being used to group by.
| Column | Type | Filter? | Description |
|---|---|---|---|
| Top-level category | string | Yes | The top-level universal content category associated with the inventory where these impressions occurred. For example, "Business & Industry". |
| Seller | string | Yes | The seller on whose inventory these impressions occurred. |
| Country | string | Yes | The country where the user was located for the impression. |
| Size | string | Yes | The size of the creative used in the impression. |
| Minimum Impressions | int | Yes | The minimum number of impressions you'd like to filter by. For example, you may want to see only impressions and uniques from members whose volume exceeds 100,000 impressions over the selected time range. |
| Second-level category | string | No | The second-level universal content category associated with the inventory where these impressions occurred. For example, "Aerospace & Defense", which is filed under "Business & Industry". |
| Domain | string | No | The URL of the domain where the impression took place. Not all sellers expose their domains in reporting. Traffic from sellers who have elected not to expose domains will be reported as "Undisclosed". |
Note
You can also filter on a particular number of impressions using the Minimum Impressions filter.
Metrics
Note
When values of a metric are displayed as percentages in the UI, they will be displayed as decimals when you export the report.
| Column | Type | Formula | Description |
|---|---|---|---|
| Platform-Audited Imps | int | Platform-Reviewed Imps | The number of platform-reviewed impressions that took place on this inventory during the selected time range. |
| Seller-Audited Imps | int | Seller-Reviewed Imps | The number of seller-reviewed impressions that took place on this inventory during the selected time range. |
To run your report
Follow these steps to run your report.
Select Reporting from the appropriate top menu (depending on how your account has been configured).
Or, from the Publishers top menu, click on Prebid Server Premium > Analytics > Prebid Server Analytics
Select the relevant report from the list. The Report screen shows the available filters, dimensions, and delivery options for the report. The selections you make here will determine what report data is delivered to you, and how.
Important
For an explanation of how grouping and filtering work, see Dimensions, Metrics, Filtering, and Grouping.
Select the relevant filters to limit the data displayed to just the information you want. For example, rather than running a report that shows impressions for all inventory sources, you may want to list results for just a select few. When you select a filter (by clicking Edit), a selection panel appears. Select items in the Available list (left), then click Add to include them in the Chosen list (right).
Group by Dimension. Grouping allows you to display rows of data in the order you prefer.
Warning
The more dimensions you group by, the larger the data set that is returned. Larger data sets can take substantially longer to process. Be sure to group using only the dimensions you need.
Choose a delivery option. Once you've selected your filters and grouped by your chosen dimensions, you need to choose a delivery method. Available delivery methods include:
Run now, show results in screen: For smaller amounts of data, you may want to view the report as soon as possible in your browser. You can download the report in XLSX, CSV, Excel/TSV, and JSON format. However, there is a limit of 100,000 rows per report when downloading as XLSX and Excel file.
Run in background, notify me when results are ready to view: A popup notification will let you know when the report is ready to view or download.
Tip
The maximum size of the report that can be downloaded from the UI is 100 MB. Also, there is a limit of 100,000 rows per report when downloading as XLSX and Excel file. If the size of the report is more than that, you can try to download it using the API for that reporting service (The limit here is 10 million rows).
Export, send results via email: Run the report in the background and email the results to one or more email addresses.
Save as report template: Save your selected report settings so that you can run this report again in the future. You can name this template using the text entry field under Name this report (its checkbox is auto-selected when you choose this option). A saved report can be rerun from the Your Reports screen.
Add to scheduled reports: Run this report automatically at specified times and have it sent to one or more email addresses.
Name this report: Give this report with its current settings a name for future reference.
Click Run report to send your report request.