# TikTok Ads Conversion Tracking & Attribution Setup Guide

Connect TikTok Ads to push offline conversions back to your Pixel via the TikTok Events API. Multi-advertiser support, hashed PII matching, ttclid tracking.

Source: https://sourceloop.ai/help/connect-tiktok-ads/
Updated: 2026-05-28

---

Connecting TikTok Ads to SourceLoop opens the full conversion loop. Every tracked lead converts (form submission, meeting booked, payment received), and SourceLoop sends that event server-side to TikTok via the Events API. The Smart Performance Campaigns and Value-Based Optimisation algorithms train on real revenue, not just browser-side Pixel events that get blocked by privacy settings.

This article covers the OAuth connect flow only. After connecting, see:
- [Configure TikTok Events API sync](/help/configure-tiktok-events-api/)
- [Troubleshoot TikTok Ads sync issues](/help/troubleshoot-tiktok-ads-sync/)

## Why connect TikTok Ads to SourceLoop?

TikTok Pixel events fired in browsers cover maybe 60-70% of conversions on a good day. Mobile in-app browsers, aggressive privacy settings, and ad blockers eat the rest. The Events API closes that gap by sending events server-side from SourceLoop instead of the browser.

What SourceLoop adds:

- **Server-side conversion push** via the TikTok Events API, immune to browser-side blocking
- **Click ID matching** using `ttclid` plus hashed email and phone
- **Revenue values** sent on every conversion when payment integrations are connected
- **Event-level dedup** so server-side and browser-side reporting of the same conversion don't double-count
- **Multi-touch attribution** within SourceLoop, while still feeding TikTok the conversion signals needed for VBO and Smart bidding

## Before you start

You'll need:

- A **SourceLoop workspace** with the [tracking pixel installed](/help/install-the-tracking-pixel/)
- A **TikTok Business Center** account that owns the advertisers you want to connect
- A TikTok user with **Admin** or **Standard** access on the Business Center
- An existing **TikTok Pixel** in Events Manager (or a Server Pixel created specifically for CAPI)
- **Admin** or **Owner** role in SourceLoop (Editors can't add integrations)

## Step 1: Open the Ad Platforms page

1. Sign in to [SourceLoop](https://app.sourceloop.ai/).
2. Click **Setup** in the left sidebar.
3. Click the **Ad Platforms** tab.
4. Scroll to the **TikTok Ads** card and click **Connect**.

You'll be redirected to TikTok's OAuth consent screen on business-api.tiktok.com.

## Step 2: Authorise SourceLoop on TikTok

1. Sign in with the TikTok user that has Business Center access.
2. Pick the **Business Center** that owns the advertisers you want to connect.
3. Review the access SourceLoop is requesting (read and write to advertiser data, plus pixel events).
4. Click **Confirm**.

TikTok redirects you back to SourceLoop with an authorisation code, which SourceLoop exchanges for an access token. The token is stored encrypted.

## Step 3: Pick the advertiser

If your TikTok user has access to more than one advertiser, SourceLoop shows a picker listing each one, including the currency and timezone.

1. Find the advertiser you want to connect.
2. Click **Connect this advertiser**.

SourceLoop creates a connection for that specific advertiser. The TikTok Ads card flips to **Connected** with the advertiser name and Advertiser ID.

> **To connect another advertiser, repeat the flow**
> Each TikTok advertiser is its own connection. To connect multiple advertisers (e.g., one per brand or region), run the Connect TikTok Ads flow once per advertiser. They sync and push conversions independently.

## Step 4: Add your Pixel ID and Events API token

For SourceLoop to actually push conversions, it needs your **Pixel ID** and an **Events API access token** that's authorised to write to that Pixel.

The full walk-through is in [Configure TikTok Events API sync](/help/configure-tiktok-events-api/). Short version:

1. In SourceLoop's TikTok drawer, find the **CAPI configuration** section.
2. Paste your **Pixel ID** (from TikTok Events Manager).
3. Paste your **Events API access token** (generated from the Pixel's Settings tab).
4. Click **Save**.

The connection status flips to **Active**, and the daily Insights sync + the 2-minute Events API push cycle both start running.

## What gets synced

Once connected, SourceLoop runs two flows automatically:

**PULL (Insights sync, daily at 05:00 UTC):**
- Campaign, ad group, and ad hierarchy
- Daily spend, impressions, clicks per level
- 14-day rolling re-sync to catch TikTok's late attribution
- Refreshed in SourceLoop dashboards within minutes of each sync run

**PUSH (Events API, every 2 minutes):**
- Every SourceLoop conversion where the visitor's session carries a `ttclid` cookie or a hashed email / phone that matches a TikTok user
- Conversion value (currency) and currency code when configured
- Stable event IDs for dedup against any browser-side Pixel events fired on the same action
- Page URL where the conversion happened

## What's next

- **Pick which SourceLoop events map to which TikTok event name:** [Configure TikTok Events API sync](/help/configure-tiktok-events-api/).
- **Troubleshoot** any push errors: [Troubleshoot TikTok Ads sync issues](/help/troubleshoot-tiktok-ads-sync/).
- **Disconnect or reset** the integration: [Disconnect TikTok Ads from SourceLoop](/help/disconnect-tiktok-ads-from-sourceloop/).

## Frequently Asked Questions

### Do I need a TikTok Business Center account?

Yes. SourceLoop connects to advertisers (TikTok's term for ad accounts) inside a Business Center. If you've been running TikTok Ads via a personal account, claim it inside a Business Center at business.tiktok.com first.

### Which advertisers can I connect?

Every active advertiser your TikTok user has access to inside the Business Center. After OAuth, SourceLoop shows a picker (with currency and timezone) and you pick one per connection. Repeat to connect multiple.

### What's the difference between the TikTok Pixel ID and the Events API access token?

The Pixel ID identifies the Pixel (or Server Pixel) that should receive the events. The Events API access token is the credential SourceLoop uses to call the API against that Pixel. Both are configured in the TikTok drawer after the initial OAuth, the next article walks through finding each.

### How long does the TikTok OAuth access last?

The OAuth access token issued during connect is long-lived and SourceLoop reuses it for both Insights sync and Events API push. If TikTok ever revokes the token (rare, usually only happens if a user explicitly removes the app from Business Center), the card flips to Token expired and you'll need to reconnect.

### Can I sync TikTok Shop conversions?

Yes, if they're configured as TikTok Pixel events. The Events API push doesn't distinguish between TikTok Shop and other conversion types; any event you map in SourceLoop gets sent to TikTok against the Pixel you've configured.

### Does TikTok have something equivalent to Meta's Match Quality?

TikTok's diagnostic equivalent is the Event Match Score, visible in TikTok Events Manager. Like Meta's Match Quality, it improves with richer identity signals, ttclid + email + phone produces the best scores. The improvements you make to Meta CAPI matching usually carry over to TikTok automatically.

### Can I connect multiple TikTok advertisers to one SourceLoop workspace?

Yes. Each advertiser is a separate connection. Repeat the Connect TikTok Ads flow once per account.
