Skip to main content
Feedback

Verizon Media (Oath) walkthrough

Oath report types

OAuth report types include:

  • stats reports (mainly statistics)
  • dimensions reports

General filters

Both types of reports offer general filters in the form of seats and advertisers. Seat- a seat is a licensed account that is held by an ad agency, trading desk, or direct advertiser that enables that organization to participate in the real-time bidding marketplace. If not chosen, the default seat is used. If you have more than one seat, you can select multiple seats for the same report.

Advertiser - a company that lists advertisements on Oath Ad Platforms DSP to purchase inventory provided by a range of publishers in the broader marketplace. Leave empty for all advertisers, or select those you need.

Statistics report

The statistics report is the primary report on the Oath platform, providing metric information and dimension data.

Statistics report setup

  1. Dimension: Represents an attribute such as Creative, advertiser, and more. Most dimensions return more than one attribute. For example, Campaign returns both the Campaign name and the Campaign ID.
  2. Metric: Represents a measurement. For example, clicks, impressions, and more.
  3. Granularity (interval): The granularity of the data returned.
    1. Cumulative: Returns a single row in which each column displays data for the entire range.
    2. Day: Returns one row for each calendar day in the specified date range.
    3. Month: Returns one row for each full or partial month in the specified date range.
    4. Week: Returns one row for each calendar week in the specified date range.
    5. Hour: Returns one row for each hour that has data.
  4. Timezone: The timezone of the report. The default timezone is America/New_York.
  5. Currency: The currency of the report.

Time period

Only the statistics report supports the time period.

Date Range

  • Pulls data in the date range between the start and end date provided, including the end date.
  • You must select a start date.
  • Leaving the end date empty pulls data according to the current time of the river's run.
  • Select a timezone offset to send dates considering the offset.
  • Use the Last Days Back For Each Run to expand the start date and pull data a given number of days back before the chosen start date.

Predefined date - A date range defined by Data Integration:

  • Day - Yesterday.
  • Week (From Monday to Sunday) - Week to date, Previous week, Previous week to date.
  • Month - Month to date, Previous month, Previous month to date.
  • Year - Year to date.

API data accuracy limitation

Oath does not guarantee the availability of Recent campaign data and data collected from events occurring in the previous six hours.

Rate limits for statistics reports

TypeLimitDescription
Request Per Minute5Number of requests per minute per seat.
Row Counts Per Day1,000,000Total rows of data exported from DSP Reporting API per day per seat. The limit applies to a 24-hour interval starting from the first request from any user in the seat.
Requests Per Day500Total number of reporting requests issued per day per seat. The limit applies to a 24-hour interval starting from the first request from any user in the seat.

Contact your Oath account manager to increase the limits.

Known limitations for statistic reports

  • The Reporting API supports reports up to 20 GB in size.
  • The settings below cause the reports to return up to 500k rows instead of the 1000k rows.
  • The following metrics:
  • 115 Unique Viewers
    • 163 Oath Viewable Rate
    • 166 Oath Viewable Impressions
    • 167 Oath Measurable Impressions
    • 242 Oath Analyzed Impressions
    • 243 Oath AVOC
    • 244 Oath AVFH
    • 245 Oath Measurability Rate
    • 247 Oath AVOC Rate
      • Extracting data before 2017-08-11
      • Reports that return newer and older data:
        • The dateTypeId has a value of 1 - Today.
        • The dateTypeId has a value of 10 - All Time.
        • The dateTypeId has a value of 11 - Custom.
        • The startDate of the report has a value that is before 2017-08-11.

Dimension reports

The four dimension reports are available:

  • advertisers
  • campaigns
  • lines
  • ads 

Rate limits for dimension reports

TypeLimitDescription
Requests Per Minute10Number of requests allowed in a minute per user account.
Requests Per Hour300Number of requests allowed in an hour per user account.
Requests Per Day5000Number of requests allowed in a day per user account.
warning

Exceeding these limits causes errors. Contact your Oath account manager to increase the limits. Your data will not be available after you exceed the limit until the limitation is reset. For example, if you have made more than 5000 requests per day, you must wait until the limitation is reset before you can pull any other data that day.

On this Page