Export Conversions to TikTok Ads
Send attributed conversions from Vendo to your TikTok pixel through the Events API, so that TikTok can optimize your campaigns.
Last reviewed September 15, 2026
This guide shows how to send conversions from Vendo to TikTok Ads. TikTok uses the conversions to measure and optimize your campaigns.
How It Works
- The source event that you select counts as a conversion, such as a purchase.
- Vendo applies your attribution model to connect each conversion to a TikTok ad click.
- Vendo sends each conversion to your TikTok pixel through the Events API.
Vendo matches a conversion to a click with the ttclid click ID. It can also send hashed email and phone to improve the match.
Before You Start
- A TikTok Ads App connected in Vendo. Vendo uses the sign-in of this App to send conversions. You do not need an access token.
- A TikTok web pixel in your TikTok Ads account.
- A Source that records the event that you want to count as a conversion.
- A website that keeps the
ttclidparameter from the landing page URL.
https://yoursite.com/product?ttclid=abc123def456Step 1: Get the Pixel Code from TikTok
- In TikTok Ads Manager, open Events Manager.
- Select your web pixel.
- Copy the pixel code.
Step 2: Add the Destination
- In Vendo, go to Data > Destinations.
- Click Add Destination.
- Select TikTok Ads as the destination.
- Select the Source that records your conversion event.
Step 3: Configure the Conversion
Caution: Do not select the Participation attribution model for this export. Participation gives full credit to each touchpoint. TikTok then receives more than one conversion for each purchase, and its optimization data is wrong.
The form shows these settings in this order:
| Setting | What it does | Default |
|---|---|---|
| Conversion Count | Every sends each conversion. Use it for purchases. Once sends only the first conversion for each customer. Use it for leads. | Every |
| Deduplication Window | Shown for Every only. Vendo ignores a repeat conversion from the same customer inside this window: 4 hours, 1 day, 3 days, 1 week or 30 days. | 4 hours |
| Attribution Model | How Vendo gives credit for a conversion: Last Click, First Click, Linear, Time Decay, U-Shaped or Participation. | Last Click |
| Lookback Window | How many days of conversions each export reads again: 1, 7, 14 or 28 days. | 7 days |
| Conversion Matching | Identified Conversions sends only conversions with a click ID. Send All Conversions also sends conversions without a click ID, matched with hashed email and phone. | Identified Conversions |
| Pixel Code | The pixel code from Step 1. Required. | None |
| Conversion Event (Pixel Settings) | The TikTok standard event that Vendo sends: Complete Payment, Place an Order, Subscribe, Submit Form, Complete Registration, Add to Cart, View Content, Initiate Checkout, Add Payment Info or Search. Required. | None |
| Conversion Event | The source event that counts as this conversion. Select one event for each conversion action. If you leave it empty, Vendo can send every conversion event. | None |
| Conversion Mapping | Connects TikTok fields to properties on the source event. Email and phone come from identity resolution unless you map them. | Identity resolution |
| Dynamic Value Assignment | Sends a value from a prediction model in place of the event value. If a customer has no prediction, Vendo sends the event value. | Off |
The form has two settings named Conversion Event. The one in Pixel Settings is the TikTok event. The other one is the event from your Source.
For more information about each model, see Attribution Models.
Note: The TikTok Events API can match on email and phone.
Step 4: Check the Export
Caution: The test sends a real event to the live TikTok API. Use a test row, not a real customer conversion, if you can.
- On the Destination page, click Test.
- Select a row from the source table.
- Click Send Test Event.
- Click Sync Now to start an export.
- Open the Conversion Log tab.
- Make sure that your conversions show the Sent status.
- If a row shows Failed, open the Logs tab to read the error.
- After TikTok processes the events, find them in TikTok Events Manager.
The Conversion Log shows the time, the user, the event, the source, the match type, the value and the status of each conversion.
What Vendo Sends
Vendo sends events to the event/track/ endpoint of the TikTok Events API.
| Field | Value |
|---|---|
event_source_id | Your pixel code |
event | The TikTok standard event from Pixel Settings |
event_id | A stable event ID. TikTok uses it to remove duplicates of pixel events. |
timestamp | The conversion time |
user.ttclid | The TikTok click ID, when the conversion has one |
user.email, user.phone_number | Hashed email and phone, when you select them |
user.external_id | A SHA-256 hash of the Vendo user ID |
properties.value | The attributed conversion value |
properties.currency | The currency of the conversion |
Vendo does not send a conversion that has no click ID and no selected email or phone. TikTok cannot match that conversion.
Troubleshooting
- No conversions in the Conversion Log: make sure that your website keeps the
ttclid. Also make sure that the source Conversion Event is correct. - Pixel not found: make sure that the Pixel Code is the code of your web pixel from Step 1.
- Authentication errors: open the TikTok Ads App in Vendo. If it shows Reconnect Required, connect it again.