TikTok

Scope: a pixel, plus account linking

The TikTok app (marketplace slug tiktok-connector, platform code tiktok) is a CHANNEL-scoped app: it is installed once per store and connected per sales channel. It does three things, and only these:

• Storefront pixel. You store a TikTok pixel ID against a sales channel, and the SDK loads the pixel on the storefront and fires standard e-commerce events at it. In the dashboard this is the TikTok Pixel ID field on the app's connection tab (SalesChannel.tiktokPixelId). Tags start firing within about 5 minutes.
• TikTok for Business sign-in (Marketing API). The connector implements the OAuth connect flow (fixed redirect /api/oauth/tiktok/callback), looks up the advertiser accounts and lists the pixels on the account. When a pixel is discovered it fills the app's read-only pixelId setting. A pixel ID typed on the sales channel always wins over the discovered one.
• TikTok Shop sign-in, connection only. A second, separate credential set (TikTok Shop Open API, redirect /api/oauth/tiktokshop/callback) lets a channel link a TikTok Shop account and resolve the shop's name, ID and region. The dashboard card says it plainly: product and order sync are not available yet, and this only confirms the connection.

There is no product sync, no inventory sync, no order pull, no catalog and no coupon push for a TikTok install. The connector exposes discovery, a connection-status check and the two OAuth flows, and nothing else, so product, inventory and coupon sync jobs are never enqueued for a TikTok install. That is by design, not by omission. A coupon created in Brainerce is never sent to TikTok.

TikTok Shop checkout (selling inside TikTok) is deliberately out of scope. It is unavailable to Israeli merchants, and TikTok retired the external-storefront model in September 2023. Do not build against it. Linking a Shop account (above) does not turn any of that on.

Server-side events and ads are not built

Server-side conversion reporting (the TikTok Events API), catalog ads and Smart+ campaigns do not exist. The connector's discovery response reports the catalog and ads capabilities as not_implemented.

Marketplace status

The TikTok app is seeded hidden (hidden: true in the marketplace seed): it does not appear in browse for merchants, and only a platform super-admin can see and install it. Merchants will not find it until the flag is lifted. Treat everything on this page as a description of the code, not of something a merchant can switch on today.

What a merchant can do today

Without the app, the working path is to fire the TikTok pixel through the merchant's own Google Tag Manager container, which the storefront tags already support on every store. See the merchant guide: Google Analytics, Google Tag Manager and the Meta pixel.