TikTok Events API Integration

ClickerVolt integrates with TikTok via OAuth, automatically importing all your advertisers and pixels. Once connected, conversion events are sent directly to TikTok via their Events API with 14 matching signals for high-quality attribution.

Connecting Your TikTok Account

TikTok uses OAuth for secure authorization. When you connect, ClickerVolt automatically imports all advertisers and pixels you have access to.

1. Go to Settings → Integrations

2. Select the TikTok tab

3. Click "Connect TikTok Account"

4. You will be redirected to TikTok to authorize access

5. Grant permissions when prompted

6. ClickerVolt will automatically import your advertisers and pixels

After authorization, you'll see all your TikTok advertiser accounts listed, each with their associated pixels ready for event tracking and cost attribution.

What Gets Imported

When you connect via OAuth, ClickerVolt automatically fetches:

• All advertiser accounts you have access to

• All pixels associated with each advertiser

• Account timezone and currency for accurate cost tracking

• Access tokens for both Events API (conversions) and Reporting API (cost pulling)

Signal Matching (14 Signals)

ClickerVolt sends 14 data points to TikTok for identity matching:

• Click Attribution: ttclid (TikTok Click ID), ttp (TikTok Pixel)

• PII (hashed with SHA-256): email, phone, external_id, first_name, last_name

• Technical: IP address, user agent, locale

• Geo (hashed): country, region, city, zip

All personally identifiable information (PII) is hashed before sending, ensuring privacy compliance.

Automatic Cost Attribution

With OAuth, ClickerVolt can pull your ad spend data directly from TikTok:

• Hourly cost data is fetched automatically from the TikTok Reporting API

• Spend is matched to your clicks via ad ID for accurate ROI calculation

• Uses the "Snapshot & Delta" method for reliable cost tracking

• No manual cost input required

Event Mapping

Configure which TikTok events to fire for your conversions:

• CompletePayment: The default event for purchases/conversions

• AddToCart, InitiateCheckout, AddPaymentInfo: Funnel events

• Subscribe, SubmitForm, Contact: Lead generation events

• CancelOrder: Used automatically for refund sync

Automatic Refund Sync

When a refund postback is received, ClickerVolt automatically sends a "CancelOrder" event to TikTok. This helps TikTok's optimization algorithms learn which conversions were reversed, improving your campaign performance over time.