TikTok Ads

Source + Destination — Vendo imports ad performance data from TikTok Ads and exports offline conversions back via the Events API.

What Vendo Syncs

Ad Performance Data

Vendo imports daily ad-level metrics from the TikTok Reporting API:

Metric	Description
Impressions	Total ad impressions
Clicks	Ad clicks
Spend	Ad spend with currency conversion

Dimensions

Dimension	Description
Account ID	TikTok advertiser ID
Campaign ID & Name	Campaign-level grouping
Ad Group ID & Name	Ad group-level grouping
Ad ID	Individual ad identifier
Destination URL	Landing page URL (with macros resolved)
Report Date	Date of performance data

URL Macro Resolution

TikTok supports dynamic macros in landing URLs. Vendo automatically resolves these before extracting UTM parameters:

Macro	Resolves To
`__CAMPAIGN_NAME__`	Campaign name
`__CAMPAIGN_ID__`	Campaign ID
`__AID_NAME__`	Ad group name
`__AID__`	Ad group ID
`__CID_NAME__`	Creative name
`__CID__`	Creative ID
`__PLACEMENT__`	Placement info

UTM Parameters

After macro resolution, Vendo extracts:

utm_source
utm_medium
utm_campaign (falls back to campaign name if not set)
utm_term
utm_content

The utm_source_platform is automatically set to tiktok.

Conversion Export

Vendo can export offline conversions back to TikTok via the Events API using the ttclid (TikTok Click ID). See Export Conversions for configuration.

Platform Details

Setting	Value
Ad Platform	TikTok Ads
Publisher Platform	tiktok
Channel Type	video
API	TikTok Reporting API
Click ID Parameter	`ttclid` (TikTok Click ID)
Max Sync Window	30 days per chunk

Currency Conversion

Ad spend is automatically converted from your TikTok account currency to your reporting currency using daily exchange rates.

Data Freshness & Backfill

Ad performance data syncs daily in 30-day chunks. Historical backfill is included during onboarding.

Setup

Connect your TikTok Business Account through the Vendo app
Authorize with the required BUSINESS_MANAGE scope
Select the advertiser account to sync
Configure reporting currency and timezone

Verify Setup

Confirm the TikTok Ads integration status is active in Vendo
Check that ad metrics appear in your destination or BigQuery export
For conversion exports, verify recent conversions in TikTok Ads