IntegrationsAdvertisingThe Trade Desk Offline Conversions

The Trade Desk Offline Conversions

Datafly Signal uploads offline conversion data to The Trade Desk server-to-server for attributing in-store purchases, call centre conversions, and other offline activities to programmatic campaigns.

⚠️

This integration is currently in beta. Configuration and behaviour may change.

Prerequisites

Before configuring The Trade Desk Offline Conversions in Signal, you need a Trade Desk account registered as an Offline Data Provider with a Merchant ID and Provider ID assigned.

Create a Trade Desk Account

  1. If you don’t already have one, contact The Trade Desk to set up an advertiser account.
  2. Once provisioned, log in to the Trade Desk platform at desk.thetradedesk.com.
  3. Note your Advertiser ID from Advertiser Settings (a short alphanumeric string like abcde12).

Register as an Offline Data Provider

  1. Contact your Trade Desk account representative to register your organisation as an Offline Data Provider.
  2. The registration process involves providing details about your offline data sources (e.g. POS systems, CRM, call centre).
  3. Once approved, The Trade Desk will assign you an Offline Data Provider ID.

Offline Data Provider registration is managed by The Trade Desk. This is not a self-service process — you must work with your account representative.

Get Your Merchant ID and Provider ID

  1. After registration, your Trade Desk representative will provide your Merchant ID and Offline Data Provider ID.
  2. The Merchant ID links offline data to your product catalogue for transaction-level attribution.
  3. The Offline Data Provider ID identifies your organisation as the source of the offline conversion data.
⚠️

Both the Merchant ID and Offline Data Provider ID are assigned by The Trade Desk. Do not use placeholder values — events sent with incorrect IDs will be rejected.

Configure in Signal

Now that you have your Advertiser ID, Merchant ID, and Offline Data Provider ID, configure the integration in Signal.

Configuration Fields

FieldRequiredDescription
advertiser_idYesYour Trade Desk Advertiser ID. Found in the Trade Desk platform under Advertiser Settings.
merchant_idYesMerchant ID for offline conversion attribution. Links offline data to your product catalogue. Assigned by The Trade Desk.
offline_data_provider_idYesThe offline data provider ID assigned by The Trade Desk for your offline data integration.

Management UI Setup

  1. Go to Integrations > Add Integration > The Trade Desk Offline Conversions.
  2. Enter your advertiser_id, merchant_id, and offline_data_provider_id.
  3. Select consent categories (typically advertising).
  4. Click Save.

Management API Setup

curl -X POST http://localhost:8084/v1/admin/integrations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source_id": "src_abc123",
    "vendor": "the_trade_desk_offline",
    "name": "TTD Offline Conversions Production",
    "enabled": true,
    "config": {
      "advertiser_id": "abcde12",
      "merchant_id": "merch_abc123",
      "offline_data_provider_id": "provider_xyz789"
    },
    "consent_categories": ["advertising"]
  }'

Event Mapping

Datafly EventTrade Desk ActionNotes
Order CompletedOffline conversion uploadRequires value, currency, order_id. Attributed to programmatic campaigns.
Order RefundedConversion adjustmentAdjusts previously reported conversions.
Custom eventsCustom offline conversionEvent properties mapped to offline conversion attributes.

Offline Conversion Data

For accurate offline attribution, include as much data as possible in your conversion events:

_df.track("Order Completed", {
  order_id: "POS-12345",
  total: 89.99,
  currency: "USD",
  store_id: "STORE-001",
  products: [
    { product_id: "SKU-A", name: "Widget", price: 49.99, quantity: 1 },
    { product_id: "SKU-B", name: "Gadget", price: 40.00, quantity: 1 }
  ]
});

Offline conversions are matched to users via identity resolution. Ensure users are identified via _df.identify() with email or phone for the highest match rate.

Testing Your Integration

Step 1: Send a Test Conversion

  1. Trigger an offline conversion event (e.g. an Order Completed event via the Datafly.js collector or server-side API).
  2. Check the Signal event debugger in the Management UI to confirm the event was captured and delivered.

Step 2: Verify in The Trade Desk

  1. In the Trade Desk platform, navigate to Data > Offline Conversions.
  2. Check the upload log to confirm conversions are being received.
  3. Offline conversion data may take up to 48 hours to be fully processed and attributed.

Step 3: Validate Attribution

  1. Review campaign reports in the Trade Desk platform.
  2. Confirm that offline conversions are attributed to the correct programmatic campaigns.
  3. Check the match rate to understand what percentage of offline conversions could be matched to ad impressions.

Troubleshooting

ProblemSolution
Conversions not appearing in The Trade DeskVerify the advertiser_id, merchant_id, and offline_data_provider_id are correct.
Invalid provider ID errorEnsure you are using the exact Offline Data Provider ID assigned by The Trade Desk. Contact your representative.
Low match rateSend user identity data (email, phone) via _df.identify(). Include as many product and transaction details as possible.
Data processing delayedOffline conversions may take up to 48 hours to process. Allow time before investigating.
Permission denied errorConfirm your account has Offline Conversions API access. Contact your Trade Desk representative.

Visit The Trade Desk Offline Conversions documentation for full API documentation and credential setup instructions.

The Trade Desk First-Party Advertiser DataVideoAmp