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

# Tracking for TikTok Ads

**This guide will show you how to set up tracking for the following TikTok metrics in Northbeam:**

* Spend, impressions, visits and all conversion-based metrics attributed to TikTok Ads

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Input
      </th>

      <th>
        Output
      </th>

      <th>
        If Input is missing...
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        TikTok Integration (required)
      </td>

      <td>
        The following data is pulled into your dashboard:

        * Campaign, Adset, Ad Names
        * Ad Spend
        * Impressions
        * TikTok-reported metrics
      </td>

      <td>
        Campaign, Adset, Ad Names will be missing, along with Spend, Impressions, and TikTok-reported metrics.
      </td>
    </tr>

    <tr>
      <td>
        Northbeam UTM Parameters (required)
      </td>

      <td>
        Revenue, Transactions, and Visit attribution to your Campaigns, Adsets, and Ads.
      </td>

      <td>
        Northbeam UTM Parameters create the linkage between your Ads and the conversions they drive. If missing, your ad spend and your revenue will be reported on different line-items, making it very difficult to draw insights.
      </td>
    </tr>
  </tbody>
</Table>

<Info>
  ### Advertise on TikTok Shop?

  * **Shopify Stores** - Make sure your store is connected to [TikTok Shops](https://help.shopify.com/en/manual/online-sales-channels/tiktok/setup).
  * **Custom Stores** - Make sure to label your TikTok Shop orders with an `order_tag`([Server AP](https://northbeam-orders-api.readme.io/reference/post_orders)I) and [reach out to our team](https://www.northbeam.io/submit-a-support-ticket) with the name of the tag.

  **For more information,[learn about TikTok Shops (and Meta Shops) here](/docs/tracking-for-shops).**
</Info>

***

## GMV Max Campaigns

TikTok’s GMV Max is an automated advertising solution designed to maximize a seller’s total sales revenue (GMV) within their TikTok Shop. It uses AI to optimize campaign performance — automating tasks like audience targeting, bidding, and creative selection — while focusing on hitting a target ROI and driving incremental sales through a mix of paid and organic traffic.

In short, GMV Max takes over the heavy lifting of campaign management so you can scale your TikTok Shop sales more efficiently.

### How to track GMV Max in Northbeam

**Requirements**

* Your TikTok Shop account must be connected to a TikTok Ad Account
* That TikTok Ad Account must also be connected to Northbeam
* The connected user must be an admin on the TikTok Ad Account and TikTok Shops account.

<Tip>
  Once these connections are in place, Northbeam will automatically attribute GMV Max campaign data to the corresponding TikTok campaigns.
</Tip>

### Where to Find GMV Max Performance in Northbeam

Navigate to the Sales page in Northbeam. You'll see a platform labeled **GMV Max**. Within this platform, you’ll find your GMV Max campaigns along with attributed conversion data.

### Troubleshooting GMV Max

**If you don’t see GMV Max spend or attributed conversion data, it’s likely due to one of the following:**

* Your TikTok Shop account isn’t connected to any TikTok Ad Account
* Your TikTok Shop account is connected to a TikTok Ad Account that isn't linked to Northbeam

**To verify this setup in TikTok Business Center:**

1. Select the correct Business Center
2. Go to Assets → Ad Accounts
3. Select the relevant Ad Account
4. Navigate to Assets → TikTok Shop
   1. If your shop isn’t listed, it’s not linked to that Ad Account

***

## TikTok Smart+ 2.0 (Smart Performance Campaigns)

TikTok Smart+ 2.0 adds a new level called **Asset Groups**, which sits between Ad Groups and creatives.

Because this structure is different from standard TikTok campaigns, Northbeam made an update so Asset Group names are easy to see in reporting.

### How Smart+ 2.0 Appears in Northbeam

**TikTok Smart+ 2.0 structure:**

* Campaign
* Ad Group
* **Asset Group**
* Creative

**How Northbeam Displays It**

* Campaign
* Ad Group
* **Asset Group |:| Creative Name**

Northbeam shows the Asset Group **at the start of the Ad name**, followed by the creative name.

#### Ad Name Format

`Asset Group Name |:| Creative Name`

**Example:**

`Prospecting - UGC |:| spark-echo_V3_QRT472_LD-20251112.mp4`

**What to know**

* `|:|` is a separator between the Asset Group and the Creative
* This happens automatically for Smart+ 2.0 campaigns
* No setup or changes are required

### How to View Performance by Asset Group

Asset Groups are not a separate tab yet, but you can still review performance by using search.

**Steps**:

1. Go to the **Sales** Page
2. Filter Platform to **TikTok**
3. At the **Ad level**, use the search bar to enter the Asset Group name

This will show all ads that belong to that Asset Group.

<Note>
  This update improves naming clarity for Smart+ 2.0 campaigns. More Asset Group reporting improvements are being explored.
</Note>

***
