The Trade Desk Event Tracking | OpsBlu Docs

The Trade Desk Event Tracking

Track conversions, custom actions, and user behavior with The Trade Desk Universal Pixel for audience building and attribution.

Event Tracking Overview

The Trade Desk Universal Pixel supports custom event tracking for conversions, engagement actions, and user behavior. Events enable audience building, conversion optimization, and attribution reporting. Proper event implementation maximizes campaign performance and measurement accuracy.

Standard Event Types

Purchase Event

Track completed transactions and revenue:

ttd.universal({
  advertiser_id: 'YOUR_ADVERTISER_ID',
  td1: 'YOUR_UNIVERSAL_PIXEL_ID',
  event_name: 'purchase',
  value: 149.99,
  currency: 'USD',
  order_id: 'ORDER789456',
  items: [
    {
      item_id: 'SKU123',
      item_name: 'Product Name',
      quantity: 2,
      price: 74.99
    }
  ]
});

Lead Generation Event

Track form submissions and lead conversions:

ttd.universal({
  advertiser_id: 'YOUR_ADVERTISER_ID',
  td1: 'YOUR_UNIVERSAL_PIXEL_ID',
  event_name: 'lead',
  value: 25.00,
  lead_type: 'contact_form',
  td2: 'newsletter_signup'
});

Add to Cart Event

Track product interest and cart additions:

ttd.universal({
  advertiser_id: 'YOUR_ADVERTISER_ID',
  td1: 'YOUR_UNIVERSAL_PIXEL_ID',
  event_name: 'add_to_cart',
  value: 49.99,
  currency: 'USD',
  items: [
    {
      item_id: 'SKU456',
      item_name: 'Product Title',
      price: 49.99,
      quantity: 1
    }
  ]
});

Page View Event

Track page visits for audience building:

ttd.universal({
  advertiser_id: 'YOUR_ADVERTISER_ID',
  td1: 'YOUR_UNIVERSAL_PIXEL_ID',
  event_name: 'page_view',
  page_url: window.location.href,
  page_title: document.title,
  td2: 'product_category',
  td3: 'womens_shoes'
});

Sign Up Event

Track user registrations and account creation:

ttd.universal({
  advertiser_id: 'YOUR_ADVERTISER_ID',
  td1: 'YOUR_UNIVERSAL_PIXEL_ID',
  event_name: 'signup',
  signup_type: 'email',
  td2: 'free_trial'
});

Video View Event

Track video engagement and completion:

ttd.universal({
  advertiser_id: 'YOUR_ADVERTISER_ID',
  td1: 'YOUR_UNIVERSAL_PIXEL_ID',
  event_name: 'video_view',
  video_title: 'Product Demo',
  video_duration: 120,
  percent_viewed: 75,
  td2: 'homepage'
});

Custom Event Parameters

Use custom parameters (td2, td3, td4, td5, td6, td7, td8, td9, td10) for additional segmentation:

ttd.universal({
  advertiser_id: 'YOUR_ADVERTISER_ID',
  td1: 'YOUR_UNIVERSAL_PIXEL_ID',
  event_name: 'purchase',
  value: 299.99,
  currency: 'USD',
  td2: 'spring_sale',        // Campaign source
  td3: 'returning_customer', // Customer type
  td4: 'premium_member',     // Membership tier
  td5: 'email_campaign'      // Traffic source
});

E-commerce Enhanced Tracking

Product Detail View

ttd.universal({
  advertiser_id: 'YOUR_ADVERTISER_ID',
  td1: 'YOUR_UNIVERSAL_PIXEL_ID',
  event_name: 'product_view',
  items: [
    {
      item_id: 'SKU789',
      item_name: 'Premium Laptop',
      category: 'Electronics',
      brand: 'TechBrand',
      price: 1299.99
    }
  ],
  td2: 'search',  // Discovery method
  td3: 'sale'     // Product tag
});

Checkout Initiation

ttd.universal({
  advertiser_id: 'YOUR_ADVERTISER_ID',
  td1: 'YOUR_UNIVERSAL_PIXEL_ID',
  event_name: 'begin_checkout',
  value: 249.99,
  currency: 'USD',
  items: [
    {
      item_id: 'SKU111',
      quantity: 1,
      price: 249.99
    }
  ],
  cart_size: 1,
  td2: 'guest_checkout'
});

Purchase with Order Details

ttd.universal({
  advertiser_id: 'YOUR_ADVERTISER_ID',
  td1: 'YOUR_UNIVERSAL_PIXEL_ID',
  event_name: 'purchase',
  value: 549.98,
  currency: 'USD',
  order_id: 'ORD20240101',
  items: [
    {
      item_id: 'SKU001',
      item_name: 'Running Shoes',
      category: 'Footwear',
      price: 129.99,
      quantity: 2
    },
    {
      item_id: 'SKU002',
      item_name: 'Athletic Socks',
      category: 'Accessories',
      price: 19.99,
      quantity: 2
    }
  ],
  shipping: 15.00,
  tax: 45.00,
  td2: 'first_purchase',
  td3: 'email_promo'
});

Dynamic Remarketing Events

Product Catalog Integration

ttd.universal({
  advertiser_id: 'YOUR_ADVERTISER_ID',
  td1: 'YOUR_UNIVERSAL_PIXEL_ID',
  event_name: 'product_view',
  items: [
    {
      item_id: 'SKU555',
      item_name: 'Product Title',
      category: 'Category Name',
      price: 89.99,
      image_url: 'https://example.com/images/product.jpg',
      product_url: 'https://example.com/products/555'
    }
  ]
});

Server-Side Event Tracking

For server-to-server event transmission:

// Node.js example
const axios = require('axios');

await axios.post('https://insight.adsrvr.org/track/up', {
  adv: 'YOUR_ADVERTISER_ID',
  upid: 'YOUR_UNIVERSAL_PIXEL_ID',
  event_name: 'purchase',
  value: 199.99,
  currency: 'USD',
  order_id: 'ORD123456',
  user_agent: req.headers['user-agent'],
  ip: req.ip,
  td_uid: 'UID2_TOKEN_IF_AVAILABLE'
});

Event Configuration in TTD Platform

  1. Navigate to Settings → Universal Pixel → Tracker Events
  2. Click Create Tracker Event
  3. Enter event name (must match event_name in pixel code)
  4. Select conversion type (purchase, lead, engagement, etc.)
  5. Set attribution windows (click: 1-30 days, view: 1-7 days)
  6. Configure conversion counting (unique or multiple per user)
  7. Set conversion value source (static or dynamic from pixel)
  8. Save and deploy pixel code with matching event_name

Event Validation & Testing

Chrome DevTools Method

  1. Open Chrome DevTools (F12 or right-click → Inspect)
  2. Navigate to Network tab
  3. Filter by "adsrvr" or "insight.adsrvr.org"
  4. Trigger event action (purchase, form submit, etc.)
  5. Verify pixel request contains correct event_name and parameters
  6. Check response status is 200 OK

TTD Pixel Helper Extension

  1. Install TTD Pixel Helper Chrome extension
  2. Navigate to page with Universal Pixel
  3. Click extension icon to view pixel status
  4. Verify base pixel loads on all pages
  5. Trigger events and confirm event parameters
  6. Review warnings or errors in helper interface

Platform Event Debugger

  1. In TTD platform, navigate to Universal Pixel → Event Debugger
  2. Enter test URL or trigger live event
  3. View real-time event stream and parameters
  4. Verify events match expected configuration
  5. Check for parameter formatting errors or missing values

Best Practices

  • Use consistent event naming conventions across all implementations
  • Always include value and currency for conversion events
  • Implement order_id for transaction de-duplication
  • Use custom parameters (td2-td10) for granular segmentation
  • Test events in staging environment before production deployment
  • Document all event names and parameter mappings
  • Set appropriate attribution windows for each event type
  • Implement server-side backup tracking for critical conversions
  • Monitor event volume and conversion rates in TTD reporting
  • Regular audit of event configuration and data quality
  • Use descriptive custom parameter values for reporting clarity
  • Ensure data layer values populate before event fires
返回顶部