Send lead conversions from Viewers directly to TikTok Ads. When someone submits their information through your widget, TikTok receives the conversion event - helping you optimize your campaigns, build better audiences, and track your true cost per lead.
This integration is available on all plans, including Free.
How It Works
When a lead is captured on your site, Viewers fires a conversion event to your TikTok Pixel. TikTok then attributes that conversion to the ad that drove the visitor, giving you accurate data on which campaigns, ad sets, and creatives are actually generating leads.
No code changes required. Just add your Pixel ID and Viewers handles the rest.
What You’ll Need
- A TikTok Ads account
- A TikTok Pixel installed on your website
- Your TikTok Pixel ID
Finding Your TikTok Pixel ID
- Go to your TikTok Events Manager
- Select your Pixel from the list
- Click on your Pixel name to view details
- Copy your Pixel ID (a unique alphanumeric code)
The Pixel ID is a string of numbers and letters that identifies your specific pixel.
Setting Up the Integration
- Log in to your Viewers dashboard
- Go to Automations
- Find TikTok Ads and click to configure
- Paste your Pixel ID
- Configure your options (see below)
- Save your settings
Configuration Options
Value per Lead (Optional)
Assign a monetary value to each conversion. This helps TikTok optimize for value and lets you track revenue metrics in your ads dashboard.
Examples:
- If your average customer is worth $500 and 10% of leads convert, your value per lead is $50
- If you charge $100 per qualified lead, enter $100
Supported currencies: USD, EUR, GBP, CAD, AUD
Leave this blank if you don’t want to pass a value.
Lead Types to Track
Choose which modules should fire conversions to TikTok. You might want all lead types tracked, or only specific ones.
Available modules:
- Chat
- Feedback
- Custom
- Newsletter
- Share
- Contact Us
- Discount (Spin to Win)
Select the modules that represent meaningful conversions for your TikTok campaigns. For example, if you’re running ads to capture newsletter signups, you might only track Newsletter leads.
Selective Conversion Tracking
Control when conversions fire to TikTok. This helps ensure you’re only counting quality leads.
Sync all conversions (default) Fires the conversion immediately when a lead is captured. Use this for maximum data and fastest optimization.
Sync only verified emails Only fires the conversion after the lead’s email has been verified as valid and deliverable. This filters out fake or mistyped emails. May take a few minutes after capture.
Sync only enriched leads Only fires conversions for leads that have company/contact enrichment data. This ensures you’re only counting business leads with real company information. May take a few minutes after capture. Requires a PRO plan for enrichment.
Best Practices
Start with “Sync all conversions” This gives TikTok the most data to optimize against. You can always tighten it up later if you’re seeing low-quality leads.
Use “Sync only verified emails” if you’re seeing spam If your campaigns are attracting bot traffic or fake submissions, switching to verified-only filters out the junk before it hits TikTok.
Use “Sync only enriched leads” for B2B If you’re specifically targeting business leads and only care about conversions with company data, this ensures TikTok optimizes for the leads that matter to you.
Set a realistic lead value Don’t inflate your value per lead - it’ll skew your ROAS calculations. Use your actual average lead value based on conversion rates and customer lifetime value.
Match your lead types to your campaign goal If your TikTok ad promotes a discount offer, only track Discount module conversions. This keeps your data clean and your optimization focused.
Verifying the Integration
After setting up:
- Run a test by submitting a lead through your widget
- Wait a few minutes (especially if using verified or enriched sync)
- Check your TikTok Events Manager for the incoming conversion
- Verify the event shows the correct value (if you set one)
TikTok Events Manager has a “Test Events” section where you can see real-time incoming events.
Troubleshooting
Conversions not appearing in TikTok?
- Double-check your Pixel ID is correct
- Make sure the integration is saved and enabled in Viewers
- If using verified/enriched sync, wait a few minutes - these don’t fire instantly
- Check that the lead type you submitted is selected in “Lead Types to Track”
Conversion counts don’t match Viewers?
- If using “Sync only verified emails,” invalid emails won’t fire conversions
- If using “Sync only enriched leads,” personal email addresses (Gmail, Yahoo, etc.) won’t fire conversions since they can’t be enriched
Value not showing in TikTok?
- Make sure you entered a number in the Value per Lead field
- Verify you selected a currency
Frequently Asked Questions
Do I need the TikTok Pixel installed on my site separately? Yes. Viewers sends conversion events to your existing pixel. You still need the base pixel code installed on your website for TikTok to track visitors and match conversions.
Will this work with TikTok’s Conversions API (CAPI)? Viewers fires events to your pixel. If you have CAPI set up separately, you may see duplicate conversions. Contact us if you need help with deduplication.
Can I track different conversion values for different lead types? Not currently. The value per lead applies to all tracked conversions. If you need different values per module, contact us about custom setups.
How quickly do conversions appear in TikTok? For “Sync all conversions,” within seconds. For verified or enriched sync, it may take a few minutes while we verify the email or enrich the lead.
Is this available on the Free plan? Yes. The TikTok Ads integration is available on all plans. However, “Sync only enriched leads” requires a PRO plan since enrichment is a PRO feature.
Need Help?
If you have questions about connecting Viewers to TikTok Ads, contact us.Share
Artifacts
Download all
Setting up the ai chat module
Document · MD
How to enable widget minimizing
Document · MD
How to hide viewers branding
Document · MD
Embed code options and variables
Document · MD
Free vs pro which plan is right for you
Document · MD
How to close your account
Document · MD
How to update your payment method
Document · MD
Document · MD
How to change your plan
Document · MD
Embed code installation guide
Document · MD