(Conversion API) TikTok Events API

Follow
Avatar
Jonathan Chen
Updated
Conversion Postbacks for web, PC, and console events are only available to Singular customers with access to Singular’s Web, PC, and Console game attribution.

Singular’s integration with the TikTok Events API allows advertisers to send Singular attributed TikTok click conversions to TikTok. This integration is supported for Singular web, PC, and console measurement. For Singular’s mobile measurement integration with TikTok, see our help center article on the topic.

How to Configure the TikTok Events API Integration

  1. Ensure you have an integrated web, PC, or console app with Singular
  2. Go to Singular > Attribution > Partner Configuration
  3. Click “Add a Partner”, and type and choose “TikTok Events API”
  4. In the dialog, choose your App and App site (platform) to configure. Note that only web, PC, and console apps are supported with this integration
  5. Paste in your app's "Access Token" and "Pixel Code" from your TikTok Ads Manager dashboard.


  6. Optionally configure any additional events to send to TikTok and map it to a "TikTok Event Name"


  7. Click "Save" to finish.

FAQ

What data does Singular send via API?
Parameter Details
ttclid
  • TikTok click ID
  • automatically passed
IP address  
user agent
  • (For web only)The user agent for the browser corresponding to the event
Are mobile events supported in TikTok Conversions API?
  • TikTok conversion event postbacks should only be configured for mobile app sites to send app events when using Singular's Mobile Web to App attribution flow (i.e. TikTok ad click → Advertiser owned Landing Page with Singular Web SDK → Singular Mobile Web to App click → Install)
  • This integration should not be used for standard mobile app install and retargeting campaigns. Use the TikTok Ads Integration for mobile campaigns. 
What are the limitations of TikTok Events API?

(Coming Soon)