TikTok Ads Integration

Connecting TikTok Ads to Attribution.ai lets you sync ad spend, track campaign performance, and match TikTok click IDs (ttclid) to conversions on your Shopify store. This guide covers the setup process, data synced, how TikTok attribution works, and troubleshooting common issues.

Prerequisites

Before connecting TikTok Ads, ensure you have:

A TikTok for Business account with an active ad account
Admin access to the TikTok Ads Manager for the advertiser account you want to connect
A verified TikTok Business Center account (unverified accounts may fail authorization)
The Attribution.ai pixel installed on your Shopify store

Step-by-Step Setup

Navigate to Settings > Integrations in your Attribution.ai dashboard.
Find TikTok Ads and click Connect.
You will be redirected to TikTok for Business. Log in with your TikTok Business account credentials.
Review the permission requests and authorize Attribution.ai to access your ad account data.
If you manage multiple advertiser accounts, select the specific account(s) you want to connect.
Click Confirm to approve the authorization.
You will be redirected back to Attribution.ai with a confirmation message. The initial data sync begins immediately.

Required Permissions

During the OAuth flow, Attribution.ai requests the following TikTok permissions:

Permission	Purpose
Campaign data read	Access campaign, ad group, and ad performance metrics
Reporting data read	Pull spend, impression, click, and conversion data
Account info read	Identify and list available advertiser accounts

Attribution.ai only reads data from your TikTok Ads account. It does not create, modify, or pause any ads or campaigns.

What Data Is Synced

Spend and Performance Data

Daily spend broken down by campaign, ad group, and individual ad
Impressions: Total ad impressions per day
Clicks: Total clicks on your ads
Video views: Video view metrics (2-second views, 6-second views, view-through rates)
Engagement metrics: Likes, shares, and comments on ad content

Campaign Structure

Campaign names, IDs, and objectives
Ad group names, targeting settings, and budget configurations
Ad creative names and IDs
Campaign status (active, paused, deleted)

Click ID Matching

When a user clicks a TikTok ad, TikTok appends a ttclid parameter to the destination URL
Attribution.ai's pixel captures this parameter and stores it in the visitor's session
When that visitor makes a purchase, the ttclid links the order back to the specific TikTok campaign, ad group, and ad

Sync Frequency and Historical Data

Automatic sync: Every six hours
Historical import: Up to 60 days of historical data on first connection (shorter than Facebook and Google due to TikTok API limitations)
Manual sync: Available from Settings > Integrations at any time
Data finalization: TikTok may adjust reported metrics for up to 48 hours. Attribution.ai re-syncs recent dates to capture these adjustments.

How TikTok Attribution Works in Attribution.ai

TikTok presents unique attribution challenges because much of TikTok's influence on purchases is organic -- users discover brands through the For You Page, creator content, and TikTok Shop without clicking tracked ads. Attribution.ai addresses this through multiple signals:

ttclid matching (strongest signal for paid): The pixel captures the ttclid parameter from TikTok ad clicks. On purchase, this links the order to the specific paid campaign.
UTM parameter matching: If your TikTok ads include UTM parameters (recommended), these provide a secondary signal. Use:
```
utm_source=tiktok
utm_medium=paid_social
utm_campaign={campaign_name}
```
Referrer matching: Visits from tiktok.com are classified as TikTok organic traffic unless a ttclid or paid UTM parameters are present. This captures some organic TikTok traffic, though many TikTok users open links in TikTok's in-app browser, which may not pass referrer data.
Survey responses (critical for TikTok): The post-purchase survey is especially valuable for TikTok attribution. Many customers discover brands through organic TikTok content, creator collaborations, or viral posts that do not include trackable links. When a customer reports "Social media > TikTok" or "Influencer / creator" in the survey, this data fills the gap that pixel tracking alone cannot cover.

Why TikTok Attribution Is Especially Challenging

TikTok differs from Facebook and Google in several ways that affect attribution:

Organic discovery is a major driver: A significant portion of TikTok-influenced purchases come from organic content, not paid ads. The pixel can only track paid ad clicks with ttclid.
In-app browser behavior: TikTok's in-app browser may not preserve URL parameters across all navigation scenarios, which can result in lost ttclid values.
Cross-device journeys: Users often discover brands on TikTok (mobile) but purchase on desktop. These cross-device journeys are difficult to track with pixel data alone.
View-through influence: Users may see a TikTok video about your product, not click any link, and later search for your brand on Google. The sale gets attributed to Google by pixel data, but TikTok was the true catalyst.

For these reasons, we strongly recommend enabling the post-purchase survey alongside the pixel for TikTok advertisers. Triangulated measurement is designed to reconcile these signals and produce more accurate TikTok attribution than pixel-only tracking.

Best Practices

URL Configuration

Link directly to your Shopify store: Avoid URL shorteners (bit.ly, etc.) or third-party landing page builders that may strip the ttclid parameter.
Use consistent UTM parameters: Add UTM parameters to all TikTok ad URLs as a redundant tracking signal.
Test your ad URLs: After setting up a campaign, click the ad URL yourself and verify that the ttclid and UTM parameters appear in the browser address bar when you land on your store.

Combining Paid and Organic TikTok Data

Attribution.ai separates "TikTok Paid" (via ttclid) and "TikTok Organic" (via referrer or survey) in your attribution reports. When reviewing TikTok performance:

Look at both channels together to understand TikTok's total impact on your business.
If survey data shows significant TikTok organic attribution but pixel data shows little, this suggests your organic TikTok content is driving purchases through non-trackable paths.
Use this insight to inform your TikTok content strategy alongside your paid ad strategy.

Creator and Influencer Tracking

If you work with TikTok creators or influencers, the survey data is your best attribution signal. When creators promote your product in their content, viewers typically do not click a tracked link. Instead, they search for your brand or type your URL directly. The survey captures this by asking "How did you first hear about us?" with "Influencer / creator" as an option and a follow-up free-text field for the creator's name.

Troubleshooting

Connection Failures

Unverified business account: TikTok requires that your TikTok Business Center account is verified. If verification is pending or failed, the OAuth authorization may not complete. Check your verification status at business.tiktok.com.
Wrong account type: Personal TikTok accounts cannot be used for Ads Manager access. Ensure you are using a TikTok for Business account.
Browser issues: Clear your browser cache and cookies for tiktok.com, then retry the connection. If the OAuth page does not load, try a different browser.

Missing Spend Data

New campaigns: Newly created campaigns may take up to 24 hours to appear in synced data. Ensure the campaign has delivered at least one impression.
Campaign status: Only active and recently paused campaigns are synced. Campaigns that have been deleted or inactive for more than 60 days may not appear.
Data lag: TikTok's reporting API can have a delay of up to 24 hours for the most recent day's data. If yesterday's spend is missing, wait until the next sync cycle.

ttclid Not Appearing in Event Data

If your Events tab shows TikTok referral traffic but no ttclid values:

Verify your TikTok ad destination URLs point directly to your Shopify store without intermediate redirects.
Check that you are not using a URL shortener that strips query parameters.
Test by clicking one of your own TikTok ads and checking the URL in your browser. The ttclid parameter should be visible.
TikTok's in-app browser can sometimes lose URL parameters during navigation. This is a known platform behavior and the survey data helps compensate.

Re-Authorization

TikTok OAuth tokens can expire periodically. When this happens:

You will see a warning banner on the TikTok integration card in your dashboard.
Go to Settings > Integrations and click Reconnect on the TikTok card.
Complete the OAuth flow again. Historical data is preserved.

Data Discrepancies with TikTok Ads Manager

Differences between Attribution.ai and TikTok Ads Manager are common, especially for conversion metrics:

Spend data should match closely (within 2-3%). If it does not, check time zone alignment.
Conversion data will differ because Attribution.ai uses its own attribution models rather than TikTok's self-reported conversions. TikTok tends to claim more credit for conversions than independent attribution tools because TikTok uses view-through attribution by default.
This discrepancy is expected and is one of the primary reasons for using an independent attribution platform.

Disconnecting TikTok Ads

Go to Settings > Integrations.
Click the three-dot menu on the TikTok Ads card.
Select Disconnect.
Confirm the disconnection.

Previously synced data remains in your Attribution.ai account. To also revoke access from the TikTok side, go to TikTok Business Center > Settings > Authorized Partners and remove Attribution.ai.