> ## Documentation Index
> Fetch the complete documentation index at: https://data-foundation.rockerbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Trade Desk

> Learn how to set up The Trade Desk spend API integration with Rockerbox

## Overview

Rockerbox provides integration with The Trade Desk (TTD) for tracking programmatic advertising on Display, Video, OTT and Audio inventory. The integration includes API-based spend reporting and impression/click tracking.

## Prerequisites

Before setting up the integration, you'll need:

* An active The Trade Desk advertiser account
* MyReports API access from The Trade Desk
* Access letter authorizing Rockerbox partnership
* Four authentication credentials: Partner ID, Account ID, Username, Password

## Requesting API Access

1. Contact your TTD representative to request MyReports API access
2. Send the following message:
   ```text wrap theme={null}
   We need our partner, Rockerbox, to access the reporting API in order to report on TTD spend in the Rockerbox platform. We approve Rockerbox to access the API on our behalf. Please send over the access letter so that we can complete this step.
   ```
3. Request access to these specific Report IDs:
   * **Go-forward spend**: 2554829
   * **Historical spend**: 2681145

## Setup Process

1. Navigate to the [Advertising Platforms](https://app.rockerbox.com/v3/data/marketing/advertising_platforms/connect) page
2. Find and select The Trade Desk from the list of platforms
3. Click "Connect" and enter credentials:
   * Partner ID
   * Account ID
   * Username
   * Password
4. Implement tracking (URL parameters and/or impression pixels)
5. Allow at least one full day of data collection after launch, then verify deployment via the Digital Advertising page

## Tracking Implementation

**Match pixel to inventory type.** Using the wrong pixel type (e.g., Display pixel on Video inventory) will cause tracking failures.

## Display (Desktop) Inventory

### URL Tracking Parameters

**Example Parameter String:**

```text wrap theme={null}
td_campaignid=%%TTD_CAMPAIGNID%%&td_adgroupid=%%TTD_ADGROUPID%%&td_creativeid=%%TTD_CREATIVEID%%&td_supplyvendor=%%TTD_SUPPLYVENDOR_INT%%&td_site=%%TTD_SITE%%&td_type=display
```

<Accordion title="Parameter Details">
  | Parameter | Macro | Description |
  | - | - | - |
  | `td_adgroupid` | `%%TTD_ADGROUPID%%` | Ad Group ID (required) |
  | `td_campaignid` | `%%TTD_CAMPAIGNID%%` | Campaign ID (required) |
  | `td_creativeid` | `%%TTD_CREATIVEID%%` | Creative ID (required) |
  | `td_supplyvendor` | `%%TTD_SUPPLYVENDOR_INT%%` | Supply Vendor (required) |
  | `td_site` | `%%TTD_SITE%%` | Site (required) |
  | `td_type` | `display` | Inventory Type (hardcoded) |
</Accordion>

### Impression Pixel

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=ttd-display&tier_two=%%TTD_CAMPAIGNID%%&tier_three=%%TTD_ADGROUPID%%&tier_four=%%TTD_CREATIVEID%%&tier_five=%%TTD_SUPPLYVENDOR_INT%%&auction_id=%%TTD_IMPRESSIONID%%&referrer=%%TTD_SITE%%&td_partnerid=%%TTD_PARTNERID%%
```

**Note:** `[SOURCE]` is a hardcoded value that must be obtained from Rockerbox - it's your company's [Account ID](https://app.rockerbox.com/v3/settings/account).

<Accordion title="Parameter Details">
  | Parameter | Macro | Description |
  | - | - | - |
  | `tier_one` | `ttd-display` | Platform identifier (hardcoded) |
  | `tier_two` | `%%TTD_CAMPAIGNID%%` | Campaign ID (required) |
  | `tier_three` | `%%TTD_ADGROUPID%%` | Ad Group ID (required) |
  | `tier_four` | `%%TTD_CREATIVEID%%` | Creative ID (required) |
  | `tier_five` | `%%TTD_SUPPLYVENDOR_INT%%` | Supply Vendor (required) |
  | `auction_id` | `%%TTD_IMPRESSIONID%%` | Impression ID (required) |
  | `referrer` | `%%TTD_SITE%%` | Site (required) |
  | `td_partnerid` | `%%TTD_PARTNERID%%` | Partner ID |
</Accordion>

## Video Inventory

Uses the same URL parameters and pixel structure as Display, with `td_type=video` and `tier_one=ttd-video`.

### URL Tracking Parameters

**Example Parameter String:**

```text wrap theme={null}
td_campaignid=%%TTD_CAMPAIGNID%%&td_adgroupid=%%TTD_ADGROUPID%%&td_creativeid=%%TTD_CREATIVEID%%&td_supplyvendor=%%TTD_SUPPLYVENDOR_INT%%&td_site=%%TTD_SITE%%&td_type=video
```

### Impression Pixel

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=ttd-video&tier_two=%%TTD_CAMPAIGNID%%&tier_three=%%TTD_ADGROUPID%%&tier_four=%%TTD_CREATIVEID%%&tier_five=%%TTD_SUPPLYVENDOR_INT%%&auction_id=%%TTD_IMPRESSIONID%%&referrer=%%TTD_SITE%%&td_partnerid=%%TTD_PARTNERID%%
```

**Note:** `[SOURCE]` is a hardcoded value that must be obtained from Rockerbox - it's your company's [Account ID](https://app.rockerbox.com/v3/settings/account).

## OTT/Streaming Audio Inventory

Uses the same URL parameters and pixel structure as Display, with `td_type=ott` and `tier_one=ttd-ott`.

### URL Tracking Parameters

**Example Parameter String:**

```text wrap theme={null}
td_campaignid=%%TTD_CAMPAIGNID%%&td_adgroupid=%%TTD_ADGROUPID%%&td_creativeid=%%TTD_CREATIVEID%%&td_supplyvendor=%%TTD_SUPPLYVENDOR_INT%%&td_site=%%TTD_SITE%%&td_type=ott
```

### Impression Pixel

```text wrap theme={null}
https://metrics.getrockerbox.com/track/v5?source=[SOURCE]&tier_one=ttd-ott&tier_two=%%TTD_CAMPAIGNID%%&tier_three=%%TTD_ADGROUPID%%&tier_four=%%TTD_CREATIVEID%%&tier_five=%%TTD_SUPPLYVENDOR_INT%%&auction_id=%%TTD_IMPRESSIONID%%&referrer=%%TTD_SITE%%&td_partnerid=%%TTD_PARTNERID%%
```

**Note:** `[SOURCE]` is a hardcoded value that must be obtained from Rockerbox - it's your company's [Account ID](https://app.rockerbox.com/v3/settings/account).

## Implementation Notes

* **Inventory type matching is critical**: Ensure Display pixels are used on Display inventory, Video pixels on Video inventory, etc.

**The Trade Desk Resources:**

* [Tracking Tags Overview](https://partner.thetradedesk.com/v3/portal/data/doc/TrackingTagsOverview) (Partner Portal)
* [Static Tracking Tags](https://partner.thetradedesk.com/v3/portal/data/doc/TrackingTagsStatic) (Partner Portal)
* [Creative Specifications](https://www.thetradedesk.com/assets/global/documents/Creative_Specifications-en.pdf) (PDF)

**Note:** Partner Portal documentation requires TTD login access. Contact your Trade Desk representative for implementation assistance.

## Verification

After setup:

1. Confirm API credentials are properly configured
2. Verify impression pixels are firing correctly (check by inventory type)
3. Validate click tracking parameters are populating
4. Check spend data appears in Rockerbox dashboard after at least one full day
5. Contact [support@rockerbox.com](mailto:support@rockerbox.com) for QA assistance


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.