Reports
Reports are one of several reporting solutions in The Trade Desk platform. Unlike REDS, which provides raw log-level data, reports offer aggregated historical data that’s updated daily. Choose from predefined or user-defined formats to access key performance metrics—like win rate, CPM, CPC, CPA, and conversion touch—across various dimensions such as ad environment, audience, contextual categories, creatives, and ad formats. You can schedule, customize, and download reports on demand to gain deeper insights into your campaigns and ad groups.
| Report Type | Description |
|---|---|
| User-defined reports (formerly My Reports) | Use the GraphQL API or the Platform UI to create custom report templates, and then use either the GraphQL or REST API to schedule and retrieve reports. |
| Predefined reports | Choose from a list of reports that have predefined metrics and lookback periods. NOTE: Access to predefined reports is currently limited to a curated selection of templates, which may vary based on the advertiser, their use cases, and permission levels. This set of predefined reports is referred to as "suggested templates," which have a userGenerated value of false in the GraphQL API. |
| Dimension-specific reports | Download on-demand reports with predefined data tailored to specific dimensions like contextual categories, creatives, and ad formats. |
If you are a third-party Dynamic Creative Optimization (DCO) vendor who wants to provide creative variant reporting to The Trade Desk platform, see DCO creative variant reporting.
Reports at a glance
The following table provides a detailed comparison of the different report options.
| Comparison Aspect | User-Defined Reports | Predefined Reports | Dimension-Specific Reports |
|---|---|---|---|
| API | GraphQL and REST | GraphQL | GraphQL |
| Availability | As scheduled | On demand | On demand (cached) |
| Delivery methods | Email, download | Download | Download |
| File format | Excel or TSV/CSV | CSV | Excel |
| Dimensions | Any | Depends on report type | One per report |
| Attribution details | Available | Available | None |
| Field customization | High, custom templates | None, predefined templates | None |