Skip to main content
  1. Home
  2. Integrations
  3. TikTok Ads
Upstack Data

TikTok Ads integration: ad spend and delivery joined to your orders

Pull TikTok cost and delivery data into Upstack alongside your orders, so blended ROAS and true CAC are computed from both halves of the equation rather than one.

Role
Source
Category
Ad platforms
Plans
All plans
Conversions out
TikTok Events API

About TikTok Ads

Upstack pulls TikTok spend into the same reports as your orders, so TikTok is judged on the revenue it produced.

Without this source, TikTok-attributed conversions still show in Upstack, but with no cost beside them. With it, spend, ROAS and CPA sit next to the orders each campaign drove, and the ttclid captured by the Upstack Pixel links a click to the orders that follow.

What TikTok Ads is

TikTok Ads sells attention before it sells clicks. A video can be watched, remembered and acted on days later, from a different device, through a search.

That delay is the whole measurement problem: the platform sees the view, your store sees the order, and nothing joins them.

How TikTok Ads works

TikTok reports spend and delivery through its Marketing API against campaigns, ad groups and ads, alongside video metrics (views, watch time, completion) that have no equivalent on search platforms. Its own attribution leans on click and view windows, which means it counts conversions other platforms also count, and misses the ones where the purchase happened later through another route entirely.

What you can do with it

Three jobs TikTok Ads does once it is connected.

01

Cost next to revenue

Spend, impressions and clicks arrive daily at campaign, ad group and ad level, so ROAS and CPA come from your orders rather than from TikTok’s conversion column.

02

Video engagement, not just clicks

TikTok’s metrics include video plays, 25, 50 and 75 percent watched, completions, 15-second views and engagement, so creative can be judged on more than clicks.

03

TikTok’s view beside yours

TikTok-reported conversions are imported for comparison against the orders Upstack credits to TikTok.

How it works

How TikTok Ads ROAS reporting works.

A read-only connection that pulls TikTok cost and delivery data into Upstack and lines it up with the orders your store recorded.

What comes in

Daily spend, impressions, clicks and TikTok-reported conversions, with CPM, CPC and CTR calculated. Campaigns, ad groups and ads arrive with their names, objectives, status, budgets and creative. The metrics reference lists 77 TikTok metrics.

How often it refreshes

The first sync imports up to 36 months of history. After that Upstack checks every 15 minutes and re-pulls the last 2 days.

Read-only access

Upstack can’t create, change or spend on campaigns. Each ad account you select becomes its own source.

How spend meets orders

The Attribution board shows channel spend, CPA and ROAS beside orders and revenue, grouped by the UTM values on each visit. TikTok’s URL macros use double underscores, such as __CAMPAIGN_NAME__, and the template sets utm_medium=paid.

Credit comes from visits

In Upstack’s attribution, a touchpoint is a tracked visit to your site. A click on a phone can earn credit for an order placed later on a laptop.

Measures you can query

tiktok.spend holds TikTok’s numbers; channel.spend, channel.roas and channel.cpa add up every connected ad account.

Setup

What you need, and how to connect it.

What you need

  • Admin access to your TikTok Business Center.
  • At least one ad account with active or past campaigns.
  • Your Advertiser ID, under Account Info in TikTok Ads Manager.
Connect TikTok Ads as a source
  1. Step 1

    Connect TikTok Ads

    In Upstack, open System, Data Sources, click Connect TikTok Ads and authorize Upstack to read your Business Center data.

  2. Step 2

    Select the ad accounts

    Choose the accounts that drive traffic to your store. Each one becomes its own source.

  3. Step 3

    Confirm

    Review the data access summary and click Confirm. The sync starts straight away.

  4. Step 4

    Tag your ads

    Add Upstack’s TikTok UTM template to your ads, so campaigns, ad groups and ads are grouped correctly and counted as paid.

Check it

How to verify it’s working, and common fixes.

How to verify it’s working

  • The TikTok Ads source shows Connected under System, Data Sources.
  • Campaign data appears on the source’s detail page once the backfill completes.
  • Spend shows in Reports, Attribution, and ROAS fills in for campaigns with both spend and attributed orders.

Common problems and fixes

No data after connecting.
The backfill runs in the background. After an hour, check that the account has spend in the last 36 months and that the Advertiser ID matches, then disconnect and reconnect.
Spend doesn’t match TikTok Ads Manager.
Under 5% is normal (timezone and TikTok’s post-attribution adjustments). Larger gaps come from timezones, currency or ad accounts left unconnected.
The connection expired or was revoked.
Open the TikTok Ads source, click Reconnect, re-select the ad accounts and confirm. Missed data is backfilled on the next cycle.
TikTok traffic lands in organic.
Ad links have no UTM parameters. Add the template so visits carry utm_medium=paid.

Documentation

Set-up reference.

Set-up, event schema and field mapping for TikTok Ads as a source, next to the TikTok Ads developer docs.

FAQ

TikTok Ads integration questions.

What does Upstack import from TikTok Ads?

Daily spend, impressions, clicks and TikTok-reported conversions for every campaign, ad group and ad, with CPM, CPC and CTR calculated, plus campaign names, objectives, status and budgets.

Why connect TikTok Ads if I already send events to TikTok?

The destination sends your events to TikTok. This source brings TikTok’s spend back into Upstack. Without it, TikTok-attributed conversions show with no cost data, so there is no ROAS to compute.

How far back does the import go, and how often does it refresh?

Up to 36 months on the first sync. After that Upstack checks every 15 minutes and re-pulls the last 2 days.

Does Upstack get write access to my TikTok campaigns?

No. The connection is read-only.

Where do I find my TikTok Advertiser ID?

In TikTok Ads Manager, under Account Info.

Can I see TikTok video metrics in Upstack?

Yes. TikTok’s metrics include video plays, views, 25, 50 and 75 percent watched, completions, 15-second views and engagement such as likes, comments and shares.

Why doesn’t spend match TikTok Ads Manager exactly?

A gap under 5% is normal, from timezones and TikTok’s post-attribution adjustments. Larger gaps usually mean a timezone or currency mismatch, or an ad account left unconnected.

Which plans include the TikTok Ads integration?

All plans. Upstack has three plans that scale with your order volume, and the same integrations are on every plan.

Can Upstack also send conversions to the TikTok Events API?

Yes, through the TikTok Events API integration. Forward resolved conversions to the TikTok Events API so the algorithm optimizes on customers, not sessions.

Guides

Guides and related pages.

Background reading for the TikTok Ads integration, and the Upstack pages that go with it.

Similar integrations

Other sources to connect.

See all integrations

Get TikTok Ads tracking right.

A 15-minute walkthrough tailored to your stack and channels.