> ## Documentation Index
> Fetch the complete documentation index at: https://moengage-partner-guide.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# TikTok Conversions
> Integrate MoEngage with TikTok's server-to-server Conversions API to sync web and offline events for precise attribution and improved ad performance.
The TikTok Conversions integration bridges MoEngage and TikTok through a robust server-to-server (S2S) framework. By moving beyond client-side dependencies like ad blockers and cookie limitations, it secures a high-fidelity data stream. This ensures peak data reliability, precision attribution, and a measurable boost in ad performance.
MoEngage supports the following distinct connectors for TikTok:
* [**TikTok Web Conversions**](#integration-with-tiktok-web-conversions): Use this to streamline website events (such as Add to Cart or Purchase) captured by the MoEngage Web SDK.
* [**TikTok Offline Conversions**](#integration-with-tiktok-offline-conversions): Use this to sync high-value offline interactions (such as in-store purchases, CRM leads, or phone orders) directly to TikTok.
## Use cases
Integrating TikTok Conversions with MoEngage allows you to sync event data to support the following use cases:
* **Attribute offline actions**: Connect physical storefront activity to digital ad spend and measure the total ROI of your campaigns.
* **Optimize campaign bidding**: Enhance TikTok bidding algorithms by using high-signal conversion data to lower your cost per acquisition (CPA).
* **Target with precision**: Use conversion insights to re-engage users who abandoned carts or to build lookalike audiences based on top-spending customers.
* **Maintain data resilience**: Maintain a consistent data flow even when users have strict privacy settings or ad blockers enabled.
**Prerequisites**
Before you set up either connector, ensure you have the following from your TikTok For Business account:
* **TikTok Pixel ID**: The unique ID for tracking web events.
* **Offline Event Set ID**: The unique ID for tracking offline events.
* **Access Token**: This is generated in the TikTok Events Manager on the **Settings** tab.
* **Active MoEngage account**: Contact your MoEngage CSM if Connected Apps is not enabled.
TikTok Ads Conversions is part of the Connected Channels add-on. Contact your dedicated MoEngage CSM (customer success manager) to enable it for your account.
# Integration with TikTok Web Conversions
## Step 1: Generate credentials in TikTok
To generate the credentials in TikTok, perform the following steps:
1. Log in to your **TikTok Ads Manager** account.
2. On the top navigation bar, click **Tools** > **Events**.
3. Click **Connect data source**.
4. In the **Connect data source** dialog box, select **Web** and then click **Next**.
5. In the **Add your website** dialog box, enter your URL or click **Skip**.
6. In the **Choose a data connection method** dialog box, select **Manual setup** and then click **Next**.
7. In the **Choose a manual connection method** dialog box, click **TikTok Pixel + Events API** (Recommended) and then click **Next**.\\
8. In the **Pixel Name** box, enter a name and then click **Create**.\\
9. After the pixel is created, navigate to the **Implement Events API** tab to find your **Pixel ID**.
10. Click **Generate access token** and then copy the token.
## Step 2: Connect TikTok Web Conversions in the App Marketplace
To connect the TikTok Web Conversions in the App Marketplace, perform the following steps:
1. On the left navigation menu of the MoEngage UI, click **App Marketplace**.
2. On the **App Marketplace** page, search for **TikTok Conversions**.
3. Click the **TikTok Conversions** tile.
4. On the **TikTok Conversions** page, click the **Integrate** tab.
5. Click the 
down arrow, and then click **TikTok Web Conversions**.
6. Enter the following details:
| Field | Required | Description |
| ------------------- | -------- | --------------------------------------------------------------------------- |
| **Connection name** | Yes | A unique name for this integration (for example, TikTok\_Web\_Conversions). |
| **Pixel Code** | Yes | This is your unique TikTok Pixel ID. |
| **Access Token** | Yes | This is the token generated from the TikTok Events Manager. |
7. Click **Connect**.
Your integration is now authorized.
## Step 3: Create a TikTok Web Conversions campaign
To create a TikTok Web Conversions campaign, perform the following steps:
1. On the left navigation menu in the MoEngage dashboard, click **Engage**, and then click **Campaigns**.
2. On the **All campaigns** page, click **+ Create campaign**.
3. In the **Create campaign** dialog box, under **Connected Apps**, click **TikTok Conversions** and then click the most suitable delivery type.
4. In Step 1 (**Target Users**), select your audience.
5. In Step 2 (**Content**), select your connector (**TikTok Web Conversions**) and the connection you created.
6. Under **Conversion Goals**, enter the following fields:
| Field | Required | Description |
| -------------------- | -------- | ------------------------------------------------------------------------------------- |
| **Event Type** | Yes | This is a standard event name (for example, CompletePayment, AddToCart, ViewContent). |
| **Event ID** | No | This is the unique ID used for deduplication (for example, `{{Event['uid']}}`). |
| **TikTok Click ID** | No | The ttclid parameter (highly recommended for matching web events to ad clicks). |
| **Conversion Value** | No | This is a transaction's numeric value. |
| **Currency Code** | No | ISO 4217 currency code (for example, USD, EUR). |
| **External ID** | No | This is the unique system ID stored within MoEngage. |
7. Your campaign is now ready to be tested and sent. Using the *Test* functionality, you can also test your connector configuration. If your test user successfully receives the message, your setup is ready.
8. Publish the campaign.
# Integration with TikTok Offline Conversions
## Step 1: Generate credentials in TikTok
To generate the credentials in TikTok, perform the following steps:
1. Log in to your **TikTok Ads Manager** account.
2. On the top navigation bar, click **Tools** > **Events**.
3. Click **Connect data source**.
4. In the **Connect data source** dialog box, select **Offline** and then click **Next**.
5. In the **Create offline event set** dialog box, enter the following details:
1. In the **Offline event set name** box, type a name for the set.
2. In the **Description** box, type a description for your offline event set.
6. Click **Create**.
7. After the event set is created, copy the **ID** displayed in the event set details.
8. Click the **Settings** tab for the event set, scroll to the **Set Up Events API** section, and then click **Generate Access Token**.
## Step 2: Connect TikTok Offline Conversions in the App Marketplace
To connect the TikTok Offline Conversions in the App Marketplace, perform the following steps:
1. On the left navigation menu of the MoEngage UI, click **App Marketplace**.
2. On the **App Marketplace** page, search for **TikTok Conversions**.
3. Click the **TikTok Conversions** tile.
4. On the **TikTok Conversions** page, click the **Integrate** tab.
5. Click the down arrow, and then click **TikTok Offline Conversions**.
6. Enter the following details:
| Field | Required | Description |
| ------------------------ | -------- | ------------------------------------------------------------------------------- |
| **Connection name** | Yes | A unique name for this integration (for example, TikTok\_Offline\_Conversions). |
| **Offline Event Set ID** | Yes | This is your unique Offline Event Set ID. |
| **Access Token** | Yes | This is the token generated from the TikTok Events Manager. |
7. Click **Connect**. Your integration is now authorized.
### Step 2.2: Create a TikTok Offline Conversions campaign
To create a TikTok Offline Conversions campaign, perform the following steps:
1. On the left navigation menu of the MoEngage UI, click **Engage**, and then click **Campaigns**.
2. On the **All campaigns** page, click **+ Create campaign**.
3. In the **Create campaign** dialog box, under **Connected Apps**, click **TikTok Conversions** and then click the most suitable delivery type.
4. In Step 1 (**Target Users**), select your audience.
5. In Step 2 (**Content**), select your connector (**TikTok Offline Conversions**) and the connection you created.
6. Under **Conversion Goals**, enter the following fields:
| Field | Required | Description |
| -------------------- | -------- | ------------------------------------------------------------------------------- |
| **Event Type** | Yes | This is the standard event name (such as CompletePayment or AddToCart). |
| **Conversion Value** | No | This is the transaction's numeric value. |
| **Currency Code** | No | The ISO 4217 currency code (for example, USD, EUR). |
| **Event ID** | No | This is the unique ID used for deduplication (for example, `{{Event['uid']}}`). |
| **Order ID** | No | This is a specific transaction identifier for offline sales. |
| **Shop ID** | No | This is an identifier for the physical store or digital shop. |
7. Your campaign is now ready to be tested and sent. Using the *Test* functionality, you can also test your connector configuration. If your test user successfully receives the message, your setup is complete.\\
8. Publish the campaign.
**Best practices**
* **Deduplication**: Always map a unique *Event ID* to prevent TikTok from counting the same conversion multiple times.
* **Timely uploads**: Send web events within 48 hours and offline events within 62 days of the transaction for optimal processing.
* **Data quality**: Ensure email and phone data are captured accurately in MoEngage to maintain high match rates on TikTok.
* **Attribution**: Mapping the ttclid (*TikTok Click ID*) significantly improves web event attribution accuracy.
**Troubleshooting**
* **Low match rate**: Verify that the ttclid is being captured correctly for web events or that the PII fields (email or phone) are available in MoEngage.
* **Events not appearing**: Check that the access token hasn't expired and verify that the *Pixel ID* matches your TikTok Ads Manager setup.