> For the complete documentation index, see [llms.txt](https://help.littledata.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.littledata.io/integrations/tiktok/installation.md).

# Shopify to TikTok installation guide

Follow these steps to connect your Shopify store to TikTok with Littledata. You'll copy your pixel ID and an access token from TikTok Events Manager and paste them into the Littledata app.

### Before you start

* Access to the Littledata app for your Shopify store.
* Access to TikTok Ads Manager, with **Manage** (admin) permission for the pixel you want to use. View-only access can't generate an access token.
* Permission to manage apps in your Shopify admin, so you can turn off other TikTok tracking.

### Connect TikTok in the Littledata app

{% stepper %}
{% step %}

#### Add the destination

In the Littledata app, click **Add destination**. A list of destinations opens under **Available in your plan**.
{% endstep %}

{% step %}

#### Connect TikTok

Find **TikTok** in the list and click **Connect**. You'll see the **Connect your store to TikTok** screen. Click **Continue**.
{% endstep %}

{% step %}

#### Choose your tracking preferences

On **Set up your tracking**, keep **Use best practices** selected (it has a **Recommended** badge) and click **Continue**.

If you choose **Customize your tracking** instead, you'll first pick a product identifier and the events to send, clicking **Continue** after each screen.
{% endstep %}

{% step %}

#### Open the Connect your TikTok pixel screen

You'll now see **Connect your TikTok pixel** with two fields: **Pixel code** and **Access token**. Keep this tab open and open TikTok Ads Manager in a new tab.
{% endstep %}
{% endstepper %}

### Copy your keys from TikTok

{% stepper %}
{% step %}

#### Open Events Manager

In TikTok Ads Manager, click **Tools** in the top menu. In the **Management** column, click **Events Manager**. Events Manager opens in a new browser tab.

<figure><img src="https://3956158252-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QhTbrMraNWciQeDvu1b%2Fuploads%2Fgit-blob-2bf25a1b3d46eacefc5453b3d8a6a1d42beab11c%2Fhc-tiktok-tools-events-manager.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Find your pixel

In the left menu of Events Manager, click **Data sources** (some accounts call it **Datasets**). Your pixels are listed there.

Don't click **Connect data source** at the top right. That creates a new, empty pixel with no ad history.
{% endstep %}

{% step %}

#### Copy your pixel ID

Click the name of the pixel you want Littledata to send data to. Copy the code next to **ID** under the pixel name. It's 20 capital letters and numbers, for example `CHEAOO3C22U3D4AKHNNG`.

Don't copy your ad account ID or a dataset ID. Those are numbers only.

Paste the pixel ID into **Pixel code** in the Littledata app.
{% endstep %}

{% step %}

#### Generate an access token

On the pixel page, open the **Settings** tab and scroll down to the **Events API** section. Click **Generate Access Token**.

Copy the token straight away. TikTok shows it only once. If you lose it, generate a new one.

Paste it into **Access token** in the Littledata app, then click **Continue**.

{% hint style="warning" %}
Use the token from the pixel's **Settings** tab only. A token from TikTok for Business Developer or the Marketing API is a different kind of token and won't work here.
{% endhint %}

{% hint style="info" %}
If you see an error in the Littledata app, check that there are no spaces before or after the value you pasted. If you can't generate a token, ask the admin of your TikTok Business Center for access to the pixel.
{% endhint %}
{% endstep %}
{% endstepper %}

### Turn off duplicate tracking

{% stepper %}
{% step %}

#### Open the TikTok app in Shopify

On the **Disable other tracking apps** screen (marked **Action required**), click the **TikTok Sales Channel** link. It opens the TikTok app in your Shopify admin.
{% endstep %}

{% step %}

#### Disconnect the TikTok pixel

In the TikTok app, open the **Settings** tab, then **Data sharing**. Under **Customer Data Sharing**, click **Disconnect** next to your TikTok pixel. Click **Disconnect** again in the confirmation window.

Don't just lower the data-sharing level to **Standard**. That still sends browser pixel events, so you'd get duplicates.
{% endstep %}

{% step %}

#### Turn off other TikTok tracking

If another app sends TikTok events from your store, uninstall it or turn off its TikTok tracking feature. Check that app's own help docs for how.

Also remove any TikTok base code added to your theme by hand, and check **Settings** > **Customer events** in your Shopify admin for a custom pixel with TikTok code. Remove or disconnect it.
{% endstep %}

{% step %}

#### Confirm and continue

Back in the Littledata app, tick **I have disabled all other tracking apps** and click **Continue**.
{% endstep %}

{% step %}

#### Finish the connection

You'll see **Adding tracking** while Littledata applies its tracking to your TikTok pixel. When it's done, you'll see **You're connected! Here's where to go next.** Click **Skip to dashboard** to go back to the main page, or **Explore the event editor** to see the events you're sending.

{% hint style="info" %}
If you leave before the end, the TikTok card shows **Pending setup**. Click **Continue** on the card to pick up where you left off.
{% endhint %}
{% endstep %}
{% endstepper %}

### Check that it works

* In the Littledata app, the TikTok card shows a green **Connected** badge.
* To change your pixel code or token later, find the TikTok card, click the **⋯** menu on its card and choose **Settings**.
* In TikTok Ads Manager, open **Tools** > **Events Manager** and select your pixel under **Data sources**. On its **Overview**, new events (for example **Complete Payment**) should appear with **Events API** as the connection method after people browse and buy on your store. This can take a few hours.

### Related articles

* [TikTok](https://help.littledata.io/integrations/tiktok)
* [How the TikTok connection works](https://help.littledata.io/integrations/tiktok/how-it-works)
