Send widget events to your TikTok Pixel
Connect your TikTok Pixel so sign-ups and clicks in your widget are reported to TikTok Ads through the Events API.
Connect your TikTok Pixel when you run TikTok ads and want them to know when someone signs up or clicks in your widget. Embeddable sends the events to TikTok from our servers, using TikTok's Events API.
Before you start
You need your pixel code and an Events API access token.
- In TikTok Ads Manager, open Tools, then Events, and choose Web Events. Pick your pixel.
- Copy the pixel code shown under the pixel's name.
- Open the pixel's Settings. Under Events API, click Generate Access Token and copy it. Treat it like a password.
Connect it
TikTok Pixel needs both the pixel code and the access token, so connect it from Connect apps. The connection card in the AI chat has room for one value only, and events won't reach TikTok without both.
If you already connected TikTok Pixel from the chat, disconnect it first, using the trash icon on the card or Disconnect in Connect apps. Then follow these steps.
- Open your widget in the editor.
- Click More, then Connect apps.
- Find TikTok Pixel and click Connect.
- Click Continue. If you see Which account? instead, choose Add another account.
- Give the connection a name in Name (only you see this). Paste the code into Pixel Code and the token into Access token.
- Click Save and continue, make sure the new account is selected under Which account?, and click Connect.
What happens next
Widgets built with the AI usually report what people do in them, like sending a form or clicking a button. Once TikTok Pixel is connected, those events are sent to your pixel too. They have names like form_submit, button_click and signup. To change what's reported, tell the AI chat, for example "Report a sign-up to TikTok when the form is sent."
Events are only sent from your live widget, not from the editor preview. To check, use your widget on your live site, then open your pixel in TikTok's Events Manager. Events can take a few minutes to appear.
Remove it
- Click More, then Connect apps, open TikTok Pixel and click Disconnect.
- The connection stays saved in your workspace so you can use it again.
If events don't show up after a while, check the code and token for typos by connecting again. If it still doesn't work, email us through the contact page with the widget name.
Did this answer your question?
Your feedback helps us improve.
