Build reports with Instant Report Builder
Overview
With Instant Report Builder, you can retrieve detailed statistics either as a one-time report or a scheduled report. It also provides an instant preview of the data for the first 24 hours of the selected report period. The data in Instant Report Builder is typically refreshed every 6 to 10 hours.
If the financial metrics, such as revenue numbers shown on the Instant Report Builder, differ from the numbers on the monthly invoice, the numbers on the invoice take precedence.
The general data retention period for Instant Insights, the Instant Report Builder, and the Reporting API is three months. This means the earliest possible start date for a report is three months prior to the current date. Data older than three months isn't retrievable.
Access
To access Instant Report Builder, from the navigation menu, select Reports. Then, from the upper menu select Instant Report Builder.
Switch to Instant Insights
You can easily switch to the Instant Insights at any time without losing any of the current settings, such as selected time frame, selected dimensions, or metrics. To do this, select Instant Insights at the top of the page. For more information, see Analyze data with Instant Insights.
Select time frame
Using date picker, select the following options:
- Define the time frame you want to report on. You can select either Custom (to specify exact start and end dates) or choose from predefined time frames such as Today, Yesterday, Last 7 days, Last week, Current month, or Last month.
- Choose a time zone from those enabled in your network. By default, the network’s default time zone is preselected. This setting is especially useful for companies with operations across multiple time zones. ⓘ Note: time zones with minute offsets, for example, Indian Standard Time [IST] or UTC+05:30 aren't supported.
Views
All metrics and dimensions are organized into Views. Use the menu in the top-right corner to choose from the following views:
- Programmatic: contains general dimensions and metrics. It is a default view.
- Data Marketplace: contains general dimensions and metrics and dimensions related to audience or semantic contextual targeting.
- Activation: contains general dimensions and metrics and dimensions related to the Activation module.
- Content Metadata: contains general dimensions and metrics and dimensions describing publishers' video content where ads are being placed.
Metrics
Select metric
The metrics are categorized into Video, Financial, Delivery, and Interactions. Select Metrics + to add new metrics. If needed, you can rearrange them by dragging each metric into its desired position.
Available metrics
For more information about the available metrics and their description, see Report metrics.
Dimensions
Select dimension
The dimensions are categorized into Video, Ad Info, Quality & Privacy, Placement, Competition, Targeting, and Time. Select Dimensions + to add new dimensions. If needed, you can rearrange them by dragging each dimension into its desired position.
Filter dimensions
To set a filter in dimensions, click Filter and select the desired dimension. Then, select the actual values. Enter at least three characters to get automatic suggestions. The auto-suggestion of values is limited to values that have actual results. For example, an insertion for which there are no results won't be auto-suggested. You can also filter values in dimensions by enabling the according checkbox next to the value in the Dimension table.
The following rules apply for filters:
- multiple values of the same dimension are connected with the OR operator, for example: "Seat ID 123" OR "Seat ID 456".
- multiple values of different dimensions are connected with the AND operator, for example: "Seat ID 123" AND "Deal ID 123".
Available dimensions
For more information about the available dimensions and their description, see Report dimensions.
Preview report
As you compose your report query, a preview of the last 24 hours of the report time frame is shown, provided that the selected metrics and dimensions are compatible with the preview feature. If no preview is available (because the selected metrics and dimensions don't allow for a preview), you can click Generate Report right away. Likewise, if the preview takes too long to appear, in case of complex reports, you can skip the preview and click Generate Report directly.
Download report
To download the report as a one-time report, click on Download report and choose from the following options:
- CSV file: downloads the report in CSV format.
- Send by e-mail: opens the Generate report window where you can specify the report name, the file format, and the email recipients.
Schedule report
You can schedule a report to receive it by e-mail on a regular basis. To do this, follow these steps:
- Select Schedule Report.
- In the Report name field, define a report name.
- In the Send report field, select the following:
- Set how frequently you want to receive the report: Hourly, Daily, Weekly, or Monthly.
- Select the period each report will cover: Last hour, Current day, Previous day, Last 7 days, Previous week, Current month, or Previous month.
- In the Start schedule on field, specify the start date and time of the scheduled report. During this time frame, the report will be sent with the frequency selected above, for example, hourly, daily.
- In the Stop schedule on field, specify the end date and time of the scheduled report.
- In the Email recipient(s) (comma separated) field, enter the email addresses of the scheduled report recipients, separated by commas. Your own email address is entered by default. To add multiple addresses, follow this format: name1@domain1.com,name2@domain2.com. Don't include spaces between email addresses.
- Select Confirm to run the scheduled report.
Report list
Click Report list at the top of the page to display all One-time or Scheduled reports.
Customize report list
To customize a report list use the following options:
- Pin columns: to pin a column, hold the pointer over the column name and click the pin icon. The pinned column will then move to the left.
- Rearrange columns: to rearrange a column, hold the pointer over a column head and drag it to the desired location.
- Show and hide columns: to show/hide columns on the deal list, click the column selector button located to the right. Select the columns you want to display and deselect those you want to hide.
Manage report list
To manage a report list, click the three-dot icon on the right of a report and select one of the following options:
- Clone Configuration: applies to one-time reports only. It opens the Instant Report Builder with the parameters of the one-time report pre-selected, which can then be further edited.
- Delete: applies to both one-time and scheduled reports. It deletes the selected report.
Reporting limitations
Various limitations in the Instant Report Builder are in place to provide access to actionable insights in a timely manner.
Reports on aggregated data
A report runs on aggregated data when it includes commonly used reporting columns such as insertion, site, format, or deal, along with standard metrics such as impressions or revenue.
The maximum period covered by the reports is three months.
Reports on log-level data
A report runs on log-level data when it includes specific reporting columns, such as domain, city, or keywords, and metrics such as video interaction metrics, or when it combines metrics and columns that aren't commonly used together.
The following table lists various report types running on log-level data and the period they can cover.
Report type | Specification | Period covered by report |
---|---|---|
Reports by hour | Not applicable | less than 7 days |
Reports with specific fields | Applies to the following fields: Unique visitors, Unique Pages, Unique clicks, Domain, Keyword, Audience Segments. | less than 31 days |
Other reports | Not applicable | less than 31 days |