TikTok Ads Integration

Send conversions to TikTok via the Events API for server-side tracking.

Prerequisites

TikTok for Business account
TikTok Pixel created
Access to TikTok Events Manager

Setup

Connect Your Account

Go to Dashboard → Integrations
Click Connect TikTok Ads
Sign in with your TikTok Business account
Authorize Convultra access

Select Pixel

Choose the TikTok Pixel that should receive events.

Configure Events

Map Convultra events to TikTok standard events:

Convultra Event	TikTok Event
`purchase`	`CompletePayment`
`lead`	`SubmitForm`
`signup`	`CompleteRegistration`
`add_to_cart`	`AddToCart`
`pageview`	`ViewContent`

Test Integration

Use TikTok's Events Manager to verify events are arriving.

TTCLID Attribution

TikTok uses ttclid for click attribution:

User clicks ad → https://yoursite.com/?ttclid=xyz789...
         ↓
Convultra captures TTCLID → Stores for 90 days
         ↓
User converts → TTCLID included in event
         ↓
TikTok matches to original ad click

Event Structure

// What Convultra sends to TikTok
{
  pixel_code: 'YOUR_PIXEL_CODE',
  event: 'CompletePayment',
  event_id: 'evt_1704067200000_abc123',
  timestamp: '2024-01-15T14:30:45Z',
  
  context: {
    user_agent: 'Mozilla/5.0...',
    ip: '203.0.113.0'
  },
  
  user: {
    ttclid: 'xyz789...',
    email: 'sha256_email_hash',
    phone: 'sha256_phone_hash'
  },
  
  properties: {
    value: 99.99,
    currency: 'USD',
    contents: [
      { content_id: 'PROD-001', content_type: 'product', quantity: 1 }
    ]
  }
}

Enhanced Matching

Include user data for better attribution:

Convultra.trackConversion('purchase',
  {
    orderId: 'ORDER-12345',
    value: 99.99,
    currency: 'USD',
    content_ids: ['PROD-001']
  },
  {
    email: 'customer@example.com',
    phone: '+1234567890'
  }
)

Monitoring

TikTok Events Manager

Go to Events Manager in TikTok Ads Manager
Select your Pixel
View Events Overview for received events

Convultra Logs

Dashboard → Integrations → TikTok Ads → View Logs

Troubleshooting

Events Not Appearing

Check pixel code is correct
Verify access token is valid
Check for API errors in Convultra logs

Low Match Rate

Ensure TTCLID is being captured
Add email/phone for enhanced matching

Next Steps

Microsoft Ads LinkedIn Ads