The Trade Desk Offline Conversion Connector Setup Guide
This article describes how to set up The Trade Desk (TheTradeDesk) Offline Conversion connector.
Configuration
Go to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see About Connectors.
After adding the connector, configure the following settings:
- Agency Secret Key: The secret key provided to you by The Trade Desk.
- Merchant ID: (Optional) The ID associated with the merchant account in The Trade Desk. The Trade Desk provides this ID.
Actions
| Action Name | AudienceStream | EventStream |
|---|---|---|
| Send Offline Conversion | ✓ | ✓ |
Enter a name for the action and select the action type from the drop-down menu.
The following section describes how to set up parameters and options for each action.
Send Offline Conversion
Batch Limits
This connector uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:
- Max number of requests: 1000
- Max time since oldest request: 10 minutes
- Max size of requests: 1 MB
Data Provider ID
| Parameter | Description |
|---|---|
| Data Provider ID | The ID for the data provider in the TTD system. Your Technical Account Manager from The Trade Desk can provide this value. |
Data ID
- Map a Trade Desk ID, a device advertising ID, a Unified ID, or an IdentityLink.
- If more than one is mapped, then the first non-empty ID is chosen in the priority of: Trade Desk ID, Device Advertising ID, Unified ID, IdentityLink.
- A Device Advertising ID is represented with either iOS IDFA or Android Advertising ID (AAID).
- Only raw (not hashed) IDFA and raw AAID IDs with a GUID that is 36 characters (including dashes) are accepted.
| Parameter | Description |
|---|---|
The Trade Desk ID (TDID) (TDID) |
The Trade Desk 36-character GUID (including dashes) for this user. |
Device Advertising ID (DAID) |
The raw device ID for this user, sent in 36-character GUID format (including dashes). Use iOS IDFA or Android’s AAID. |
Unified ID (UID2) |
The raw UID2 value, also known as UID2. This value is case-sensitive. Raw UID2s are generated and managed using UID2 APIs. |
| UID2 Token (encrypted advertising token) | The encrypted UID2 advertising token. This token is case-sensitive. |
IdentityLink (IDL) |
The 49-character or 70-character RampID (previously known as IdentityLink). This must be a RampID from LiveRamp that is mapped specifically for The Trade Desk. |
Item Data
| Parameter | Description |
|---|---|
| Tracking Tag ID | (Required) The Tracking tag ID created using the Tracking tag APIs. Example: abc1234 |
| Conversion Timestamp | (Required) Conversion date and time in UTC. The time the offline conversion happened. Example: 2019-02-07T13:25:00Z |
| Impression ID | The raw (not hashed) GUID that is 36 characters long, including dashes. |
| Monetary value | Monetary value. Example: 0.02 |
| Monetary currency | Monetary value currency. Example: USD |
| Country | Country. Example: United States. |
| Region | Region. Example: New York. |
| Metro Area | Metro area. Example: 501 |
| City | City. Example: Brooklyn. |
| Postal Code | The postal code. Example: '11223'. |
| Event Name | The type of event is defined by the partner platform. For more information, see The Trade Desk: Event Mapping. |
| Order ID | The unique identifier for a transaction or conversion event, with a maximum length of 64 characters. |
Additional Data
| Parameter | Description |
|---|---|
TD1 - TD10 |
Optional reporting fields used for category or other organization, with a maximum length of 64 characters. |
Line items
The properties that contain merchant product catalog line item information. These mappings accept array attributes.
| Parameter | Description |
|---|---|
| Item Code | The item identifier (such as SKU). |
| Item Name | The name associated with the item code, with a maximum length of 150 characters. |
| Item Quantity | The number of items in the order for the item code. |
| Item Price | The unit price of the item. |
| Item Category | The item category ID. |
This page was last updated: March 17, 2026