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

# Fix UTM Setup Errors

> Fix a UTM Setup Error in Cometly: find the ads with the red dot in the Ads Manager, correct their URL parameters and confirm the error clears.

You see a red dot on the **Ads** tab of the Cometly Ads Manager, and hovering over it shows the tooltip **UTM Setup Error**. You may also see a **Tracking Error** notification for the same ad account.

The cause is that at least one active ad is missing Cometly's URL parameters, or has them set up incorrectly. URL parameters are the short tags added to the end of an ad's link that tell Cometly which ad a click came from. Without them, that ad cannot be credited with the leads and sales it produces. To fix a UTM Setup Error in Cometly, follow the steps below.

## Understanding the red dot indicator

Cometly uses a red dot to alert you to URL parameter (UTM) setup errors on your ads. If you see a red dot on the **Ads** tab in the Ads Manager, at least one ad in that ad account is missing the Cometly URL parameters or has them set up incorrectly. Hover over the dot to see the tooltip **UTM Setup Error**. The same red dot appears next to the name of each affected row in the table.

> [!WARNING]
>
> If you have imported your campaigns in the last hour, you may see a UTM Setup Error until the next data refresh. Allow up to 1 hour for the next data refresh before you take additional troubleshooting steps.

> [!WARNING]
>
> This alert only shows on **active** ads within Cometly that have potential URL parameter setup errors.

## Troubleshooting steps

### Step 1: Identify which ad platform is showing the error

The troubleshooting steps are different depending on the ad platform. In the Ads Manager, open each of your ad accounts and look for the red dot on the **Ads** tab. Hover over the red dot: a tooltip tells you there is a UTM Setup Error.

You can also go to **Setup** and open the step **Add URL parameters to your ads**. It lists each platform that has ads with URL parameter errors, with the number of ads.

### Step 2: Make sure you have the correct URL parameters on your ads

You must have the correct Cometly URL parameters on your ads, or you will see a UTM Setup Error.

In Cometly, go to [**Setup**](https://app.cometly.com/space-setup?step=url-params) and open the step **Add URL parameters to your ads**. Choose your ad platform under **Select integration** to see the URL parameters required for your space, then click **Copy Parameters** (for Google Ads and Microsoft Ads, **Copy Tracking Template**). For where to paste them on each platform, see [Set up URL parameters](https://docs.cometly.com/getting-started/url-parameters.md).

### Step 3: Check the URL parameter setup inside the Cometly Ads Manager

#### For Meta and TikTok

1. Go to the Cometly Ads Manager and select your Meta or TikTok ad account.
2. Open the **Columns** menu and choose the preset **Tracking Status**.
3. Click the **Ads** tab. The **Ad Links** and **URL Params** columns show what each ad carries, and the **Tracking Status** column shows **Normal** or **Error** for each ad.

TikTok should have the parameters directly on the link.

#### Variant in URL

> [!NOTE]
>
> If there is already a `?` in your Website URL (for example, if you have a [variant in your URL](https://docs.cometly.com/guides/url-parameters/urls-with-variant-parameter.md)), the URL already has parameters. Start the Cometly parameters with `&` instead of `?` when you add them to the end of your Website URL.

**Example:** if your Website URL is

```text theme={null}
www.test.com?variant=123456
```

Then instead of adding:

```text theme={null}
?comet_source={{site_source_name}}&comet_ad_id={{ad.id}}&comet_placement={{placement}}
```

You would need to add:

```text theme={null}
&comet_source={{site_source_name}}&comet_ad_id={{ad.id}}&comet_placement={{placement}}
```

So your final Website URL would be:

```text theme={null}
www.test.com?variant=123456&comet_source={{site_source_name}}&comet_ad_id={{ad.id}}&comet_placement={{placement}}
```

#### Meta carousel ads

For carousel ads, you have to add the URL parameters to each of the cards on the carousel ad.

> [card] [Learn how to update carousel ads](https://docs.cometly.com/guides/url-parameters/meta-carousel-ads.md)

#### For Google and Microsoft

Google Ads and Microsoft Ads use a tracking template, which can be set on the ad, the ad group, the campaign or the account. The lowest level that has a template is the one that applies, so a template on an ad or ad group overrides the one on the campaign. See [Check for Google tracking templates at the ad group or ad level](https://docs.cometly.com/support/troubleshooting/url-parameters/google-tracking-template-ad-group-level.md).

1. Go to the Cometly Ads Manager and select your Google or Microsoft ad account.

2. Open the **Columns** menu and select **URL Params**.

3. The **URL Params** column now shows the tracking template of each campaign. Make sure it is the correct tracking template. The **Ad Groups** and **Ads** tabs show the templates set at those levels, and an account-level template is shown above the table next to **Account URL Params:**.

### Step 4: Wait for updates

> [!WARNING]
>
> If you changed your URL parameters inside Meta, TikTok, Google or another ad platform, you may have fixed the issue, but you will continue to see the red dot until the **next data refresh**.

Allow Cometly up to 1 hour to refresh the data. See [how often ad data updates](https://docs.cometly.com/support/troubleshooting/ad-data/data-update-frequency.md).

## Confirm the UTM Setup Error is resolved

Once you have resolved the UTM Setup Error, the red dot goes away. After the next data refresh, open the Ads Manager and check that the **Ads** tab no longer shows a red dot and that the **Tracking Status** column shows **Normal** for the ads you fixed. In **Setup**, the step **Add URL parameters to your ads** no longer lists that platform among the ones with errors.

## Frequently asked questions

### What happens if my ads don't have Cometly URL parameters?

Cometly cannot tell which ad a click came from, so that ad is not credited with the leads and sales it produces. To add them, see [Set up URL parameters](https://docs.cometly.com/getting-started/url-parameters.md).

### Why doesn't my Meta lead form ad show a UTM Setup Error?

Cometly only flags ads that send people to a website. Meta ads with no website link, for example lead form, Messenger or WhatsApp ads, are not flagged, because there is no landing page link to carry the parameters.

### Does Cometly notify me about UTM setup errors?

Yes. Cometly raises one **Tracking Error** notification per ad account, showing how many active ads are running without its URL parameters, and updates it once a day. When the problem is fixed, the notification's title changes to start with **Resolved**. See [Notifications](https://docs.cometly.com/settings/notifications.md).

## Next steps

* [Set up URL parameters for all channels](https://docs.cometly.com/getting-started/url-parameters.md)
* [Check for Google tracking templates at the ad group or ad level](https://docs.cometly.com/support/troubleshooting/url-parameters/google-tracking-template-ad-group-level.md)
* [Add URL parameters to Meta carousel ads](https://docs.cometly.com/guides/url-parameters/meta-carousel-ads.md)
* [See how often ad data updates](https://docs.cometly.com/support/troubleshooting/ad-data/data-update-frequency.md)
* [Check your Tracking Health](https://docs.cometly.com/getting-started/tracking-health.md)

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.