How to Sync Revenue and Offline Conversions in TikTok Ads

After you’ve connected TikTok Ads to SourceLoop, the next step is wiring up the Events API push. You’ll find a Pixel ID and access token in TikTok Events Manager, paste both into SourceLoop, then map which SourceLoop events get sent to which TikTok event name with what value.

Before you start

You’ll need:

• TikTok Ads connected to SourceLoop (the card shows the advertiser name)
• Access to TikTok Ads Manager for the advertiser (specifically Events Manager / Assets -> Events)
• The Pixel you’ll be reporting to (a regular Pixel, or a Server Pixel created specifically for CAPI)
• A list of SourceLoop conversions you want to push and what TikTok event name each maps to (PlaceAnOrder, SubmitForm, Subscribe, etc.)

Step 1: Find your TikTok Pixel ID

1. Sign in to TikTok Ads Manager with a Business Center user.
2. Open Assets -> Events in the left sidebar.
3. Click into the Pixel (or Server Pixel) you want to report to.
4. On the Pixel’s overview / settings page, find the Pixel ID at the top, a 20-character alphanumeric string.
5. Copy it.

Step 2: Generate the Events API access token

1. Stay on the Pixel’s settings page in Events Manager.
2. Scroll to the Events API section (sometimes labeled “Manage” or “Set up”).
3. Click Generate Access Token (or Manage Access Token if you’ve already generated one).
4. Copy the token shown. TikTok only shows it once, save it somewhere safe.

If you ever lose the token, you can revoke and generate a new one from the same screen. SourceLoop accepts either; just re-paste in the next step.

Step 3: Paste both values into SourceLoop

1. Sign in to SourceLoop.
2. Open Setup -> Ad Platforms -> TikTok Ads.
3. In the CAPI configuration section of the drawer:
   • Paste the Pixel ID from Step 1
   • Paste the Events API access token from Step 2
   • (Optional) Paste a Test event code for end-to-end testing
4. Click Save.

SourceLoop validates the token against TikTok’s API. If valid, the connection status flips to Active.

Step 4: Add your conversion sync mappings

Now wire up which SourceLoop events get pushed to which TikTok event name.

1. In the TikTok drawer, scroll to Conversion sync.
2. Click Add conversion mapping.
3. Pick the Trigger event type:
   • Conversion created — every new lead conversion (form, meeting, chat with email captured, first payment)
   • Expected revenue updated — when the lead’s expected revenue changes (CRM-driven)
   • Realized revenue updated — when a payment integration confirms revenue
4. (Optional) Set a Trigger event name filter to scope to a specific source.
5. Pick an Attribution model: Last touch or First touch.
6. Pick the TikTok event name:
   • PlaceAnOrder — TikTok’s equivalent of Purchase for ecommerce
   • CompletePayment — when payment is finalised
   • SubmitForm — most common for forms / lead capture
   • Subscribe — for new SaaS subscriptions
   • CompleteRegistration — for account creation
   • Lead, Contact — lead-generation events
   • AddToCart, InitiateCheckout — funnel events
   • Custom event name — type any string for a custom event
7. Toggle Include value if you want to send a revenue figure. Pick the value source (quote_value, sales_value, or fixed amount) and currency.
8. Set the dedup window in minutes (default 1440).
9. Click Save.

SourceLoop starts pushing matching conversions on the next 2-minute flush cycle.

What gets sent in each event

For every matching SourceLoop conversion, the push to TikTok includes:

• event — the event name from your mapping (e.g., PlaceAnOrder, SubmitForm)
• event_id — a stable identifier per SourceLoop conversion, used by TikTok to dedup against browser-side Pixel events
• timestamp — when the conversion happened (ISO 8601)
• context.page.url — the landing page where the conversion happened
• context.user — matchable signals SourceLoop has captured:
  • ttclid (TikTok click ID) when present
  • hashed email (SHA256)
  • hashed phone (SHA256)
  • external_id (SourceLoop’s contact ID for dedup)
• properties — value and currency when value is included

The richer the user data, the better TikTok’s Event Match Score. ttclid alone gives strong matches; email + phone alone gives medium matches; both together produces near-perfect Match Score.

What’s next

• Troubleshoot pushes that aren’t appearing: Troubleshoot TikTok Ads sync issues.
• Add more mappings for separate funnels: repeat Step 4 with each TikTok event name.