Skip to Content
SourcesTikTok AdsExport Conversions

Export Conversions to TikTok

Vendo can export conversion events back to TikTok via the Events API, enabling offline conversion tracking for better ad optimization and ROAS measurement.

How It Works

  1. Vendo reads conversion events from your analytics data
  2. An attribution model matches conversions to TikTok clicks using the ttclid (TikTok Click ID)
  3. Attributed conversions are sent to TikTok’s Events API

Prerequisites

  • A TikTok Ads account connected in Vendo
  • A TikTok pixel code and access token
  • Website tracking that captures and stores the ttclid parameter

Configuration

SettingDescriptionDefault
TikTok Conversion Event NameEvent name sent to TikTok (e.g., “Purchase”)Required
Pixel CodeYour TikTok pixel codeRequired
Access TokenTikTok API tokenRequired
Account IDTikTok advertiser IDRequired
Mixpanel Conversion EventSource event to trackRequired
Conversion Event PropertyProperty containing the conversion valueRequired
Lookback WindowDays to look back for click matching7 days
Attribution ModelHow to distribute credit across touchpointsParticipation
Only First ConversionCount only the first conversion per userYes

Attribution Models

Choose how conversion credit is distributed. See Attribution Models for details on each model.

Conversion Payload

Each conversion sent to TikTok includes:

pixel_code     — Your TikTok Pixel
event          — Configured conversion event name
event_id       — Unique ID (ttclid + date)
timestamp      — ISO 8601 timestamp
context.user.ttclid — TikTok Click ID for attribution
properties.currency — Source currency code
properties.value    — Attributed conversion value

Click ID Tracking

TikTok appends the ttclid parameter to your landing page URLs automatically. Ensure your website captures and stores this parameter so Vendo can match conversions to clicks.

https://yoursite.com/product?ttclid=abc123def456

Sync Details

  • TikTok enforces a 30-day maximum sync window per chunk
  • Conversion results are tracked and stored for audit purposes
  • Failed exports due to expired access tokens will surface as authentication errors

Verify Setup

  1. Trigger a conversion event in your analytics source
  2. Check Vendo integration logs for a successful export
  3. Confirm the conversion appears in TikTok Ads after processing time
Last updated on
UTM TrackingOverview