> For the complete documentation index, see [llms.txt](https://blog.mantago.cc/en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://blog.mantago.cc/en/message-pack/utm-setup.md).

# UTM Setup

Add UTM tags to your chatbot's links, and your dashboard shows you how many times each link was clicked, where it was clicked from, and who clicked it.

***

#### 1. Filling In the Five Fields

In **Reply Settings**, click any supported reply type (circled in red), switch on **Enable UTM Parameters**, and fill in these five fields (only the first is required):

<figure><img src="https://971361156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjEgYnj4JfzImd872neOw%2Fuploads%2FJTqNNu73qwxxBvFdyGWD%2Fimage.png?alt=media&amp;token=1b0cf72b-3dd8-4484-a2d4-54a23a28970e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://971361156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjEgYnj4JfzImd872neOw%2Fuploads%2FHxIwac9K32tDiG11UsuI%2Fimage.png?alt=media&amp;token=a36dbfa5-2d23-448f-bc4d-94e1861c743e" alt=""><figcaption></figcaption></figure>

| Field             | What it tags                               | Example                    |
| ----------------- | ------------------------------------------ | -------------------------- |
| **utm\_source**＊  | Which platform it's sent from              | `line`                     |
| **utm\_medium**   | Which position or format it's clicked from | `mainmenu`, `share_button` |
| **utm\_campaign** | Which campaign it belongs to               | `regular`, `summer_promo`  |
| **utm\_content**  | Which feature or asset it leads to         | `member_management`        |
| **utm\_term**     | The most granular breakdown (optional)     | `member_page`              |

> **Naming rule**: all lowercase, use underscores, keep terms consistent. `line` and `LINE` are counted as two different sources — don't mix them.

***

#### 2. The Trick: Same Button, Different Spots

The same **Member Center** button should be filled in differently depending on whether it sits in the main menu or in a campaign share flow:

| Field         | Main Menu version   | Campaign Share version |
| ------------- | ------------------- | ---------------------- |
| utm\_source   | `line`              | `line`                 |
| utm\_medium   | `mainmenu`          | `share_button`         |
| utm\_campaign | `regular`           | `demo`                 |
| utm\_content  | `member_management` | `member_management`    |
| utm\_term     | `member_page`       | `search_points_reward` |

Recommended approach:

* **Same destination → keep** source and content the same
* **Different position or campaign → change** medium and campaign accordingly

Tag them this way, and your dashboard can tell how many people each entry point brought in.

<div><figure><img src="https://971361156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjEgYnj4JfzImd872neOw%2Fuploads%2Fz8ZHPmTJDn3ZCpH2GNMP%2Fimage.png?alt=media&amp;token=b856b3a3-7c45-4437-b33d-5e4ffbe636f2" alt=""><figcaption></figcaption></figure> <figure><img src="https://971361156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjEgYnj4JfzImd872neOw%2Fuploads%2Ff5N8BhIVWmzOjO6z0lzt%2Fimage.png?alt=media&amp;token=baa7a8f4-7082-4a30-9648-21d0be35a173" alt=""><figcaption></figcaption></figure></div>

***

#### 3. Where to See the Results

Go to **UTM Analytics** in your dashboard and start with three numbers:

* **Total Clicks**: total number of clicks (including repeats)
* **Unique Clicks**: clicks after removing the same person's repeats
* **Unique Visitors**: how many different people actually clicked

To compare which entry point works better → switch to the **Medium** dimension. To see who clicked → switch to the **User Analysis** tab, which drills down to individual User IDs and lets you message them directly.

<figure><img src="https://971361156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjEgYnj4JfzImd872neOw%2Fuploads%2FSBwsZisq0w9G63n7J8nu%2Fimage.png?alt=media&amp;token=938bb355-ed11-47bc-90b3-11a6d83f8dac" alt=""><figcaption></figcaption></figure>

***

#### 4. If You're Running GA

* **MantaGO covers the click**: which touchpoint drove the traffic, and who clicked
* **GA covers what happens next**: whether they browsed, whether they converted, how much it was worth

When the UTM naming matches on both sides, GA can work out how many of the people brought in by a given campaign actually converted.

> **Note**: The two sides de-duplicate differently (member vs. device), so it's normal for the numbers not to match down to the digit — just watch the trend.