Overview

Prerequisites:

Before you can enable your TikTok Events API Destination, you will need to:

• Install Elevar's Data Layer & Shopify Source on your store. Follow our guide on How to Implement the Shopify Source.
• Confirm your existing TikTok Pixel setup method is via Elevar. If it is not, follow this guide on how to create a new TikTok pixel.

---

Update TikTok Links

Add UTM and CLID Query Parameters:

• Begin by adding UTM parameters to your TikTok Ad URLs. [ How do I do this? ]
  • Your URL will now be similar to this:

  https://yourdomain.com?utm_source=tiktok&utm_medium=paidsocial
  

• Next, add "ttclid" as a query parameter at the end of your URLs: &ttclid=__CLICKID__
  • Your URl will now have the ttclid similar to this:
    
    

  https://yourdomain.com?utm_source=tiktok&utm_medium=paidsocial&ttclid=__CLICKID__
  

❗️

Note: the CLICKID is TikToks "macro" and should be left exactly as it's shown above.

Add TikTok as a Server-Side Destination

Locate TikTok Destination:

• On the homepage of your Elevar Account, locate the "My Tracking" button from the left-hand menu.
• Once, in "My Tracking" select the "Add Destination" button in the upper right hand corner of the page.
  • A side bar pop-up window will appear, titled "Add Destination".
  • Within this pop-up, use the search function and type "TikTok".
  • Once the TikTok destination appears from the search function, click on it.
    • (See Figure 1)

Figure 1

Get Started:

• After locating and clicking on the TikTok destination, you will be taken to overview screen.
• Click the "Get Started" button in the lower left-hand corner of the Overview box.
  • (See Figure 2)

Figure 2

Enter TikTok Settings

TikTok Settings:

• Within the "TikTok Settings" you will need to enter your specific information.
  • Add in your TikTok Pixel ID.
  • Add in your TikTok Access Token.
• If you have "Markets" enabled in your Shopify Source, you will see the "Markets" section in your TikTok destination.
  • Select either the "All Markets", "Specific market(s)", or the "No Market ID" button to specify which markets will send data to TikTok.
  • If you have selected "All Markets" navigate to the section titled "Destination Label" and use the text box to enter a label. This is how your destination name will appear across the Elevar app (e.g., My Tracking, Reports, History) and helps to identify your destination across our app, especially when you have multiple instances of the same destination.
  • If you have selected "Specific market(s)", navigate to the section titled "use the drop down menu to select the market groups to specify which market's data will be sent to this destination. Then, navigate to the box titled "Destination Label" and use the text box to enter a label. This is how your destination name will appear across the Elevar app (e.g., My Tracking, Reports, History) and helps to identify your destination across our app, especially when you have multiple instances of the same destination.
• Once you have entered your TikTok Settings, click on the "Save and Continue" button located at the bottom of the page.
  • (See Figure 3)

Figure 3

Select Events:

• Once you have entered your TikTok Settings, you have to select the Event settings.
• Click on either the button labeled "Use best practices" or "Customize settings". Currently, our "Use best practices" is the most popular and recommended practice.
• After selecting what events you want to send, click on the "Save and Continue" button located at the bottom of this section.
  • (See Figure 4)

Figure 4

👍

Note: If you are a subscription business then you have the option to also enable the "Subscribe" event.

Selecting this option will trigger a "Subscribe" event to fire anytime your customers purchase a subscription (e.g. Subscription First Order). If you also sell one-time products via native Shopify checkout then this event can help you distinguish between first-time and subscription purchases inside of TikTok.

Recurring orders are handled separately in the Subscription settings below.

Consent Mode:

• After selecting the Events settings, you will be prompted to enable Consent Mode.
• To enable Consent Mode, click on the "Yes, enable for this destination" button. Then navigate to the section of the page titled "What consent categories should a shopper accept before tracking fires?" and use the checkbox to enable the desires consent categories. The "Ad Storage" and "Analytics Storage" options are the most popular consent categories for Partnerize.
  • If consent is required, select what categories you’d like the shopper to agree to before tracking fires. [Learn More]
• If you do not want to enable Consent Mode, click on the "No" button.
• Once you have all of selected all of the information for enabling Consent Mode, click on the "Save and Continue" button located at the bottom of this section.
  • (See Figure 5)

Figure 5

Select Content Type:

• After selecting the information for enabling Consent Mode, you will need to choose a Content Type.
  • Click on either the "Product Group" or the "Product" button. What you select here depends on what value you pass in your catalog.
  • If you are sending product ID select "Product Group". If you are sending Variant ID, select "Product".
• After selecting the Content Type, click on the "Save and Continue" button located at the bottom of this section.
  • (See Figure 6)

Figure 6

Select your Product Identifier:

• After selecting details for Content Type, you need to choose a Product Identifier.
  • Product ID is the most common primary "content_id" in TikTok catalog integrations. You will want to match the product identifier used in your Pixel/Events API tracking to the product identifier you use in your Product Catalog in TikTok.
  • If you are migrating from the native Shopify <> TikTok Channel, then you will likely leave this as Product ID. The Shopify <> TikTok Channel uses the Product ID by default, so this will map over as you currently have it.
  • Our pre-built tags also use Product ID by default. So if you select Product ID in this step, nothing further needs to be done.
• After selecting the Transaction Identifier, click on the "Save and Continue" button located at the bottom of this section.
  • (See Figure 7)

_Figure 7_

🚧

If you choose a different Product Identifier for your TikTok Events API, be sure to change your TikTok tags in Google Tag manager to match!

This will need to be updated for your Product View, Add to Cart, Initiate Checkout, and Purchase TikTok Tags in Google Tag Manager.

Filter Transactions:

• After selecting details for the Product Identifier, you need to choose whether or not to filter transactions.
• Currently, our recommended practices suggests clicking the button labeled, "Yes, Block some transactions", and blocking exchange & historical import orders.
  • A common scenario where you may want to block orders is offline orders. Learn how to block these orders in this guide
  • Not sure if you need to block orders? Look at what Sales Channels you have in Shopify!
• Once you have all of selected all of the information for Filtered Transactions, click on the "Save and Continue" button located at the bottom of this section.
  • (See Figure 8)

_Figure 8_

❗️

Note: New vs Returning Purchase Events

The filtering settings that you add in the filter transaction step will effect these custom purchase events, except if you filter out the TikTok sales channel.

TikTok sales channel orders will be include in your New & Returning Purchase events because TikTok does not automatically include them in the custom events but will automatically include them in the purchase events.

Subscriptions:

• If you sell subscriptions, select whether you are using the unified Shopify checkout, or using a separate checkout. If you do, you can choose to send first-time orders only or first-time + recurring orders to your marketing destination.
• If you do not sell subscriptions, select the button labeled "No".
• Once you have all of selected all of the information for Subscriptions, click on the "Save and Continue" button located at the bottom of this section.
  • (See Figure 9)

Figure 9

Web Container Setup:

• After selecting the required information for the Subscription Settings, you will need to set up the Web Container.
  • Locate and click on the "Download Pre-Built Web Tags" button.
  • Then import & publish these tags in Google Tag Manager. How do I do that?
• Once you have set up the Web Container, click on the "Mark as Complete" button located at the bottom of this section.
  • (See Figure 10)

_Figure 10_

(Optional) Test the TikTok Events API Integration:

• Follow this guide on how to test the TikTok Events API.

Go Live:

• After completing all of the previous TikTok Setup Steps, an Overview page will appear.
• If all of the details within the Configuration Summary look correct, then click on the button labeled "Go Live" at the bottom of this section.
• A pop-up window will appear, asking for a confirmation of your changes.
• Click on the "Yes, Go Live" button located in the lower right-hand corner of the confirmation window.
  • (See Figure 11)

_Figure 11_

🚧

Be sure to remove any pre-existing TikTok setup if you haven't already done so! (if you're using native Shopify follow this guide