Use cases

  • The DV360 Exchange Reporting API allows users to generate and retrieve reports.

  • Heavy-loaded dimensions like creative ID or deal ID in reports can cause long generation times and potential rate limiting.

  • The report columns provide detailed information including date, hour, publisher ID, creative ID, creative type, and various impression metrics.

Here are some common use cases of the DV360 Exchange Reporting API.

Generate report

Refer to the generateReport documentation for instructions on how to generate a report.

Get report (formerly pull report)

Refer to the getReport documentation for instructions on how to pull a report.

Columns of Report Row in the Report File

Fields Notes
UTC Event Date string
Date of the report in the format YYYYMMDD.
UTC Event Hour string
Hour of the report. Used in hourly reports, representing the hour of the day. Values from 0 to 23, 0 representing [0:00:00 ~ 1:00:00) UTC.
Publisher ID string
Publisher ID, for example, "10005_1350300".
Creative ID string (int64 format)
Creative ID.
Creative Type string
Creative type of the report row, for example, image or audio. Mapping can be found in the Entity Mapping section.
Country ID string
Country (Region) ID. The mapping can be accessed through Entity reader files through DV360 API or DoubleClick Bid Manager API.
Partner ID string
Partner ID of the buyer (usually reflects the buyer's partner ID in DV360).
Inventory Source ID string
Inventory Source ID. This field maps to the Deal ID field from the request.
Environment string
Environment type, for example, mobile or desktop. This field related to the Device Type field from the request. Mapping can be found in the Entity Mapping section.
UTC Week string
The date of the first day of the week represents the week in report row.
UTC Month string
The year month of the report row, in the format of YYYY/MM.
Impressions string (int64 format)
Impression value in specified date/hour/week.
Impression Cost (USD) number (double format)
Impression cost in specified date/hour/week, currency in USD.
Invalid Impressions string (int64 format)
Invalid traffic impression in the specified week.
Invalid Impression Cost (USD) string (int64 format)
Invalid traffic impression in the specified week, currency in USD.