Chord supports the TikTok Conversions Segment destination. This destination sends website events from your Chord website to the TikTok events API, which allows you to see website events in TikTok.
Review the official Segment destination documentation for general configuration. After you've configured the destination, there are a couple of additional steps that improve the quality of the integration.
The TikTok Segment destination does not include a default mapping for TikTok’s “Complete Payment” event, which is one of the events TikTok uses to measure transactions. This mapping must be added manually in the Segment destination configuration for TikTok to report any transactions.
To configure, navigate to the TikTok destination in Segment and select the “Mappings” tab. Select "New Mapping" and choose "Report Web Event."
First, in the mapping configuration, enter "Order Completed" as the event name:
Second, enter "CompletePayment" as the value to map to TikTok's "Event Name":
Now "Order Completed" events will appear as "CompletePayment" events in TikTok.
You might see this error in the TikTok diagnostics tab:
The content type for one or more of your events is invalid. Content type must be either "product" or "product_group".
To fix this error, navigate to the TikTok destination in Segment and select the “Mappings” tab. For each event that sends product data (by default, "View Content," "Product Added," "Checkout Started," and "Order Completed"), choose “Edit Mapping”.
Find the "Contents" section on the mapping page and make sure "content_type" is set to "product." (The default is properties.category.)
Optionally, you can include a ttclid property on Segment events to match website visitor events with clicks from TikTok ads. See TikTok's documentation for more background.
To add the ttclid property to Segment events that are sent by Chord’s SDKs, we recommend using Segment analytics.js middleware to add the property. Segment middleware allows you to intercept events before they are sent to Segment and add additional data.
Here's an example of how you might retrieve the ttclid from the URL and append it to Segment events: