> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runconverge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Ads

> An introduction to the TikTok Ads Destination

export const OutboundLink = ({linkText, linkTarget}) => {
  return <a target="_blank" href={linkTarget}> {linkText} 
    <div className="inline h-3 w-3 fill-gray-500 dark:fill-gray-100 text-gray-500 dark:text-gray-300 ml-1 mr-1">
      <svg className="inline w-2.5 h-2.5 bg-gray-500 dark:bg-gray-300" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/up-right-from-square.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }}></svg> 
    </div>
    </a>;
};

export const IconText = ({name, text, iconSource = "mintlify", iconLocation = "before", iconType = "solid"}) => {
  const sourceUrl = iconSource === 'local' ? `url('/images/icons/${name}.svg')` : `url('https://mintlify.b-cdn.net/v6.5.1/${iconType}/${name}.svg')`;
  return <>
            <div className="inline-block pl-2">
                {iconLocation === 'before' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 " style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
                <span className="inline-block align-middle font-semibold fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 pl-1 pr-2">{text}</span>
                {iconLocation === 'after' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 pr-3" style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
            </div>
        </>;
};

export const Icon = ({name}) => {
  return <div className="h-4 w-4 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle">
            <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/${name}.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
        </div>;
};

## Overview

Destination Type: <IconText text="Client-side" name="browser" iconType="duotone" iconLocation="after" />  and <IconText text="Server-side" name="server" iconType="duotone" iconLocation="after" />

* Includes support for the <OutboundLink linkText="TikTok Events API" linkTarget="https://ads.tiktok.com/help/article/events-api?redirected=1" />

***

## Installation instructions

1. Navigate to your [TikTok Events Manager](https://ads.tiktok.com/i18n/events_manager/). If the direct link does not open your Events Manager, you can access it from the TikTok Ads Manager dashboard under **Tools** > **Events**.

2. From your Events Manager, **click on "Manage"** under **Web Events**.

3. Click on your pixel, you might have to go through 2FA.

4. From the TikTok Pixel menu, copy your **Pixel ID**, you will need it later. The Pixel ID looks as follows: `CJQBODJC77UB4MRTGFRF`

5. Navigate to the **Settings** subtab and scroll down until you find the **Generate Access Token** button. Click on it to generate your token and keep it around for the next steps.

6. In the Converge sidebar, click on <IconText name="arrow-right-from-line" text="Event streams" /> and then click **Create new Destination**.

7. Select the **TikTok** destination and click **Next**.

8. Give your destination a **name** (e.g. TikTok Destination) and click **Next**.

9. Fill in the **Pixel ID** and **Access Token** you copied from **TikTok** and click **Next**.

10. Fill in your homepage domain name in the **Your Domain name** field, including `https://`. Click **Next**.

11. Select **Use default mapping** and click **Next**.

<Note>You can find the Default mapping for the TikTok destination [here](#event-mapping). For more information on setting up Custom mappings, look [here](/destinations/event-mapping).</Note>

12. Select the sources you want to forward events from, then click **Next**.

13. Review any issues and click **Submit**.

<Warning>
  Set this destination to **Deactivated** while you remove your existing TikTok tracking setup. Running both in parallel leads to duplicate conversion data. Follow the **Turn off your old TikTok tracking** instructions below, then set the destination to **Active** when you're ready.
</Warning>

***

## Turn off your old TikTok tracking

### Turning off the Shopify TikTok Sales Channel data sharing

1. Navigate to your <OutboundLink linkText="Shopify Admin Dashboard" linkTarget="https://admin.shopify.com/" />.

2. Click on **Sales channels** and choose **TikTok** from the *Installed sales channels* menu.

3. Click on **Settings**, then **Data sharing**, and finally click on **Disconnect**.

   <Frame>
     <img src="https://mintcdn.com/converge/zWlDFBz7l1F_0PFn/images/guides/turn-off-tracking/shopify-tiktok-sales-channel/shopify-tiktok-sales-channel-1.png?fit=max&auto=format&n=zWlDFBz7l1F_0PFn&q=85&s=4ca54a921ef073592754bb3e5f9fc556" alt="settings-tiktok-1" width="1866" height="960" data-path="images/guides/turn-off-tracking/shopify-tiktok-sales-channel/shopify-tiktok-sales-channel-1.png" />
   </Frame>

4. After reading and confirming the impact of disconnecting the pixel, click on **Disconnect**.

   <Frame>
     <img src="https://mintcdn.com/converge/zWlDFBz7l1F_0PFn/images/guides/turn-off-tracking/shopify-tiktok-sales-channel/shopify-tiktok-sales-channel-2.png?fit=max&auto=format&n=zWlDFBz7l1F_0PFn&q=85&s=84f605731bf9412b18f3587cc33f348e" alt="settings-tiktok-2" width="632" height="348" data-path="images/guides/turn-off-tracking/shopify-tiktok-sales-channel/shopify-tiktok-sales-channel-2.png" />
   </Frame>

   <Note>This will prevent you from creating TikTok campaigns from the Sales Channel, but **it won't impact any campaigns or ads in your TikTok Ads Manager**. We strongly recommend running ads from the Ads Manager instead of the TikTok Sales Channel.</Note>

***

## Modify your Content ID

The Converge TikTok Destination will use the **Default** content mode to define the Content ID forwarded by default.
However, you can configure the destination to use explicitly the **Product ID**, the **Variant ID** or **SKU** instead.

1. Navigate to your TikTok Destination, click on **Configuration**.
2. Click on the **Configuration**-subtab
3. Open the **Advanced configuration (optional)** section
4. Pick your desired Content ID, and click on **Save**

**List of Content ID Modes**

| Content ID Mode | Behavior                                                          |
| --------------- | ----------------------------------------------------------------- |
| Default         | Use the `variant_id` if available, otherwise use the `product_id` |
| Product Id      | Always use the `product_id`                                       |
| Variant Id      | Always use the `variant_id`                                       |
| SKU             | Always use the `sku`                                              |

***

## Converge functionality

This integration supports the following Converge destination functionality.

| Converge Feature                                     |       Supported       |
| ---------------------------------------------------- | :-------------------: |
| Custom Events                                        | <Icon name="check" /> |
| Filters                                              | <Icon name="check" /> |
| Server-side Conversions                              | <Icon name="check" /> |
| [Conversion amount](/destinations/conversion-amount) | <Icon name="check" /> |

## Event mapping

Converge automatically maps the following events from the [Converge event spec](/sources/converge-spec) to the TikTok Ads spec.

| Converge Event Name                                                                               | TikTok Ads Event Name                   |
| ------------------------------------------------------------------------------------------------- | --------------------------------------- |
| [\$page\_load](/sources/converge-spec#page-load)                                                  | `PageView`                              |
| [Viewed Product](/sources/converge-spec#viewed-product)                                           | `ViewContent`                           |
| [Viewed Collection](/sources/converge-spec#viewed-collection)                                     | `ViewContent`                           |
| [Added To Cart](/sources/converge-spec#added-to-cart)                                             | `AddToCart`                             |
| [Started Checkout](/sources/converge-spec#started-checkout)                                       | `InitiateCheckout`                      |
| [Added Payment Info](/sources/converge-spec#added-payment-info)                                   | `AddPaymentInfo`                        |
| [Placed Order](/sources/converge-spec#placed-order)                                               | `Purchase`                              |
| [Started Subscription](/sources/converge-spec#started-subscription)                               | `Subscribe`                             |
| [Placed Recurring Subscription Order](/sources/converge-spec#placed-recurring-subscription-order) | `RecurringSubscriptionPaymentSucceeded` |
| [Cancelled Subscription](/sources/converge-spec#cancelled-subscription)                           | `CancelSubscription`                    |
| [Activated Subscription](/sources/converge-spec#activated-subscription)                           | `Subscribe`                             |
| [Searched](/sources/converge-spec#searched)                                                       | `Search`                                |
| [Subscribed To Newsletter](/sources/converge-spec#subscribed-to-newsletter)                       | `CompleteRegistration`                  |

This integration also auto-tracks some additional events that are not part of the TikTok Base Spec but are so heavily requested that we automatically forward them.

| Converge Event Name                                                       | TikTok Event Name     |
| ------------------------------------------------------------------------- | --------------------- |
| [Placed Order](/sources/converge-spec#placed-order)  (New Customers Only) | `NewCustomerPurchase` |
|                                                                           |                       |