Back to Bidders

The Trade Desk

Features

Disclosure

This adapter is known to use an HTTP 1 endpoint. Header bidding often generates multiple requests to the same host and bidders are encouraged to change to HTTP 2 or above to help improve publisher page performance via multiplexing.

Note: The Trade Desk Header Bidding adapter requires setup and approval before beginning. Please reach out to OpenPathPublishers@thetradedesk.com for more details.

Bid Params

Banner Object

The following banner parameters are supported:

mediaTypes.banner Parameters

The TTD adapter for banner uses certain parameters in the AdUnit’s mediaTypes.banner definition. Specifically, sizes is required for banner ad units. pos is recommended.

Here’s a banner ad unit example:

var bannerAdUnit = {
    code: 'myBannerAdUnit',
    mediaTypes: {
        banner: {
            sizes: [400, 600],
            pos: 1
        }
    },
    bids: [
        {
            bidder: 'ttd',
            params: {
                supplySourceId: 'supplier'
                publisherId: '1427ab10f2e448057ed3b422',
                siteId: 'site-123',
                placementId: 'sidebar_1',
                banner: {
                    expdir: [1, 3]
                },
                bidfloor: 0.95
            }
        }
    ]
}

Video

mediaTypes.video Parameters

The TTD adapter for video requires certain parameters in the AdUnit’s mediaTypes.video definition. Specifically, maxduration, api, mimes, placement, and protocols are all required for video ad units. playerSize, startdelay, playbackmethod, and pos are recommended. minduration, minbitrate, maxbitrate, skip, skipmin, and skipafter are optional.

Note: TTD does not currently support adpod video contexts.

Here’s a video ad unit example:

var videoAdUnit = {
    code: 'myVideoAdUnit',
    mediaTypes: {
        video: {
            minduration: 1,
            maxduration: 60,
            playerSize: [640, 480],
            api: [1, 3],
            mimes: ['video/mp4'],
            placement: 3,
            protocols: [2, 3, 5, 6],
            startdelay: -1,
            playbackmethod: [1],
            pos: 1,
            minbitrate: 0,
            maxbitrate: 5000,
            skip: 1,
            skipmin: 5,
            skipafter: 10
        }
    },
    bids: [
        {
            bidder: "ttd",
            params: {
                supplySourceId: 'supplier',
                publisherId: '1427ab10f2e448057ed3b422',
                siteId: 'site-123',
                placementId: 'video1',
                bidfloor: 0.95
            }
        }
    ]
}

Lists of api, playbackmethod, protocols, pos, and expdir potential values are in the OpenRTB 2.5 docs, copied here for convenience:

api

• 1 : VPAID 1.0
• 2 : VPAID 2.0
• 3 : MRAID-1
• 4 : ORMMA
• 5 : MRAID-2
• 6 : MRAID-3
• 7 : OMID-1

playbackmethod

• 1 : Initiates on Page Load with Sound On
• 2 : Initiates on Page Load with Sound Off by Default
• 3 : Initiates on Click with Sound On
• 4 : Initiates on Mouse-Over with Sound On
• 5 : Initiates on Entering Viewport with Sound On
• 6 : Initiates on Entering Viewport with Sound Off by Default

protocols

• 1 : VAST 1.0
• 2 : VAST 2.0
• 3 : VAST 3.0
• 4 : VAST 1.0 Wrapper
• 5 : VAST 2.0 Wrapper
• 6 : VAST 3.0 Wrapper
• 7 : VAST 4.0
• 8 : VAST 4.0 Wrapper
• 9 : DAAST 1.0
• 10 : DAAST 1.0 Wrapper
• 11 : VAST 4.1
• 12 : VAST 4.1 Wrapper

pos

• 0 : Unknown
• 1 : Above the Fold
• 3 : Below the Fold
• 4 : Header
• 5 : Footer
• 6 : Sidebar
• 7 : Full Screen

expdir

• 1 : Left
• 2 : Right
• 3 : Up
• 4 : Down
• 5 : Full Screen

First Party Data (Supported starting prebid v7.49)

Publishers should set First Party Data in the ortb2 and ortb2Imp objects. These fields are supported:

• ortb2.site.ext.data
• ortb2.user.ext.data
• AdUnit.ortb2Imp.ext.data (for AdUnit data)

"Send All Bids" Ad Server Keys

Back to Bidders