What Is a TTCLID? TikTok Click Identifier Explained

A TTCLID (TikTok Click Identifier) is a unique tracking parameter that TikTok Ads appends to your destination URLs when a user clicks on your TikTok ad. It serves the same fundamental purpose as Google’s GCLID or Meta’s FBCLID — connecting an ad click to a downstream conversion event.

For The Upload Offline Conversions App (TUOCA), the TTCLID enables offline conversions (phone calls, booked jobs, completed services) to be sent back to TikTok via the Events API, allowing TikTok’s bidding algorithms to optimize for actual business outcomes.

How TTCLIDs Work

1. User clicks your TikTok ad — TikTok generates a unique TTCLID
2. TTCLID appended to URL — The parameter is added to your landing page URL
3. TikTok Pixel stores it — The pixel (if installed) stores the TTCLID in a first-party cookie (_ttp)
4. You capture it — Your website, CRM, or call tracking tool stores the TTCLID
5. Conversion happens offline — The lead becomes a customer
6. You send the event — Via Events API, the TTCLID + conversion data is sent to TikTok
7. TikTok attributes it — TikTok matches the TTCLID to the original click

What a TTCLID Looks Like

https://yourwebsite.com/landing?ttclid=E.C.P.AbCdEf123GhIjKl456MnOpQr789

Property	Value
URL parameter	ttclid
Typical length	40–80 characters
Format	Alphanumeric with dots and mixed case
Validity	28 days from click date
Auto-tracking required	Yes

The 28-Day Window

TikTok’s attribution window is 28 days — a middle ground between Meta’s aggressive 7-day window and Google/Microsoft’s generous 90-day window:

Platform	Click ID	Window
Google Ads	GCLID	90 days
Microsoft Ads	MSCLKID	90 days
TikTok	TTCLID	28 days
Meta	FBCLID	7 days

For service businesses with sales cycles longer than 28 days, supplement the TTCLID with hashed PII for user data matching.

Enabling TTCLID Auto-Tracking

TTCLID auto-tracking must be enabled in TikTok Ads Manager:

1. Go to Assets → Events → Web Events
2. Select your pixel
3. Click Settings
4. Enable Auto-tracking (or Auto Advanced Matching)
5. Save

When enabled, TikTok automatically appends ttclid= to all ad click URLs.

Sending Offline Conversions with TTCLID

Offline conversions are sent to TikTok via the Events API (server-side), not through the pixel (client-side). The Events API accepts both the TTCLID and hashed user data.

Events API Request Format

{
  "event_source": "offline",
  "event_source_id": "YOUR_OFFLINE_EVENT_SET_ID",
  "data": [{
    "event": "CompletePayment",
    "event_time": 1714502400,
    "user": {
      "ttclid": "E.C.P.AbCdEf123GhIjKl456MnOpQr789",
      "email": ["a8b14f04b2..."],
      "phone": ["d4f5c3b1e7..."]
    },
    "properties": {
      "value": 4500.00,
      "currency": "USD",
      "content_type": "product"
    }
  }]
}

Supported Event Types for Offline Conversions

Event Name	Use Case
CompletePayment	Completed job, closed deal
SubmitForm	Lead form submission
Contact	Phone call, email inquiry
Subscribe	Service agreement signed
PlaceAnOrder	Job booked/scheduled

Capturing TTCLIDs

Hidden Form Field

<input type="hidden" name="ttclid" id="ttclid" value="">
<script>
  const params = new URLSearchParams(window.location.search);
  const ttclid = params.get('ttclid');
  if (ttclid) {
    document.getElementById('ttclid').value = ttclid;
  }
</script>

Multi-Platform Capture

For businesses running ads on multiple platforms, capture all click identifiers:

const params = new URLSearchParams(window.location.search);
const clickIds = {
  gclid: params.get('gclid'),
  msclkid: params.get('msclkid'),
  fbclid: params.get('fbclid'),
  ttclid: params.get('ttclid')
};
// Store whichever identifier is present

Use the Click ID Tester tool to verify all identifiers are captured correctly.

How TUOCA Uses TTCLIDs

TUOCA handles TikTok offline conversions through the same unified relay pipeline:

1. Auto-detection — TUOCA identifies TTCLIDs by their distinctive format
2. Platform routing — Records with TTCLIDs are routed to the TikTok Events API
3. PII enrichment — Hashed email and phone are included alongside the TTCLID for higher match rates
4. Event mapping — TUOCA maps your conversion types to TikTok’s event taxonomy
5. 28-day validation — Checks TTCLID age and warns when approaching expiration
6. Deduplication — Uses event_id to prevent duplicate event submissions

TikTok for Service Businesses

While TikTok is often associated with B2C and e-commerce, it’s increasingly effective for service businesses:

• Local service ads — Targeting homeowners in specific areas for HVAC, plumbing, roofing
• Video-first creative — Before/after job videos perform exceptionally well
• Younger homeowner demographic — Millennials are now the largest home-buying generation
• Lower CPMs — TikTok’s ad costs are generally lower than Google or Meta

Uploading offline conversions to TikTok is essential for these campaigns — without revenue data, TikTok optimizes for video views and clicks rather than booked jobs.

Next Steps

1. Enable auto-tracking in TikTok Ads Manager
2. Verify TTCLID capture with the Click ID Tester
3. Set up Events API access in TikTok’s developer portal
4. Configure a TUOCA relay for TikTok
5. Read the full guide — TikTok Offline Conversions Guide