TikTok Ads

Vendo syncs TikTok Ads performance data and exports conversions back via the Events API.

Last reviewed September 15, 2026

Source + Destination: Vendo imports ad performance data from TikTok Ads. Vendo also exports offline conversions back to TikTok through 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 resolves these macros automatically before it extracts 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 Vendo resolves the macros, it extracts these parameters:

utm_source
utm_medium
utm_campaign (if it is not set, Vendo uses the campaign name)
utm_term
utm_content

Vendo sets utm_source_platform to tiktok automatically.

Conversion Export

Vendo can export offline conversions back to TikTok through the Events API. The export uses the ttclid (TikTok Click ID). For the configuration, see Export Conversions.

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

Vendo converts ad spend automatically from your TikTok account currency to your reporting currency. It uses daily exchange rates.

Data Freshness & Backfill

Vendo imports daily performance rows on the configured schedule of the Source. During onboarding, Vendo divides large historical windows into request chunks of limited size.

Setup

Connect your TikTok Business Account in the Vendo app.
Authorize the required BUSINESS_MANAGE scope.
Select the advertiser account to sync.
Set the reporting currency and timezone.

Verify Setup

Make sure that the status of the TikTok Ads Source is active in Vendo.
Make sure that ad metrics appear in your Destination or BigQuery export.
If you export conversions, make sure that recent conversions appear in TikTok Ads.