The Trade Desk Offline Conversion Connector Setup Guide

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.