Data Sources

Return Home

The Trade Desk

Updated:

The_Trade_Desk.svg.png

ChannelMix API connection is built around using MyReports in The Trade Desk to automate data. [Documentation can be referenced here]

(status)Connection Guide

API Version: v3
Attribution Window:

The Trade Desk allows users to define their own attribution rules per advertiser. Please use the references below to manage your attribution windows for this source. ChannelMix does not support changing these settings.
Time Zone Reporting: Time zones are set when a new schedule is created. By default, ChannelMix will run each one time schedule using the timezone UTC. Please submit a support ticket if desiring a different timezone.
API Rate Limits:

The Trade Desk documents API rate limits in this article. 

Report requests per minute: n/a

Report requests per hour: n/a
Backfill Limits:

2 years of historical data

MyReport templates using "Conversion Details" data are limited to 100 day backfills.
Refresh Limits:

15,000 days per client per month
Suspension:

Yes, ChannelMix will suspend work on Trade Desk reports while The Trade Desk builds results and sends them to ChannelMix.

 

Default: 15 minute suspensions
Exponential Backoff:

Yes, ChannelMix will exponentially backoff requests if 429 errors start returning from The Trade Desk.

Connection Authentication

Setting up a connection in Channelmix for The Trade Desk will require a Platform API credential that can be provided by your Trade Desk account manager. Users will also need to provide a Partner ID which is available in the user interface of The Trade Desk.

For some general information about creating a connection in Channelmix please checkout this article on the connection process!

Profile Association and Values

Advertiser ID: Add an advertiser_id to your ChannelMix Profile if you want to filter data to a single advertiser. If wanting to pull all advertisers, select "--ALL ADVERTISERS--".

Report Template: This is a report template that is available in Trade Desk. (this must be created in the user interface prior to appearing in the ChannelMix list)

**Due to API rate limits, only the first 1000 report templates will return. Please use naming to ensure they are in the top 1000.

If you need help creating a report template that ChannelMix can support, please reference Data & Processing | How to setup MyReports in The Trade Desk for a step-by-step explanation.

Legacy support does not require a report template. If a ChannelMix Profile says "Please Select..." then don't worry. It's likely your data is still flowing but there is a legacy profile setting being applied. Please submit a support ticket to help clarify the template ID that is in use.

Required User Permission Levels

To use The Trade Desk connection in ChannelMix, users are required to have a special Trade Desk credential that is specific to The Trade Desk Platform API. Users will need to have this credential provided by their Trade Desk account representative prior to creating a connection in ChannelMix.

Known errors

This error may occur if The Trade Desk partner has too many report templates created. Please reduce the number of report templates saved in The Trade Desk and try to associate the ChannelMix Profile again.

Unable to retrieve values for Report Template From credential {{credential name}}

Data Guide

ChannelMix automates data from The Trade Desk available in MyReports and automates schedules to run using the Platform API. In order to automate schedules into ChannelMix, you will first need to create a least one MyReport in the Trade Desk user interface. The template reports below are available to activate in ChannelMix. 

The templates must not be altered from the standard configuration in The Trade Desk to activate them in ChannelMix.

Lag Availability: 1 day (yesterday's data available in MyReports)
Report Template API Source Documentation ChannelMix Datasets
Basic Performance Stats MyReports Basic Performance Stats
Geo Insights MyReports Geo Insights

Reporting Guide

Type of Application: DSP (Demand-side Platform)

Relevant OneViews

Relevant Dashboards