> ## 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.

# Tracking Health

> Cometly Tracking Health scores your pixel, URL parameters, forms, ad data, events and Conversion API, and gives you a fix for each failing check.

Tracking Health is a live report on whether your tracking is working: the pixel, URL parameters, forms, ad data, events and the Conversion API. Open it after you finish Setup, and any time you want to confirm that data is still flowing.

Cometly Tracking Health matters because every report depends on these pieces. The pixel (the script on your site that records visits) and the URL parameters on your ads tell Cometly which ad a visitor came from. Events (the leads and sales you track) and the Conversion API (which sends those conversions back to the ad platforms) do the rest. When one of them stops, this tab names the failing check and gives you a button to fix it, so you catch a gap before it shows up as missing leads or sales.

## Where to find it

Click **Setup** in the left sidebar, then the **Tracking Health** tab. When all seven steps are done, the **Setup complete** card also has a **Tracking Health** button.

Anyone who can open Setup can see the report. The checks are recalculated each time the page loads.

Until [step 1](https://docs.cometly.com/getting-started/about-your-business.md) is answered, the tab shows **Answer three questions first** with a **Go to step 1** button, because the checks depend on how you track leads and sales.

![The Tracking Health tab before step 1 is answered, showing the Answer three questions first card with a Go to step 1 button.](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/getting-started/tracking-health/03.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=42f69bb825e137cb43132c821cfce42e)

## Tracking Score

The ring shows a score from 0 to 100 with a label.

![The Tracking Health tab with a Tracking Score ring of 80 labeled Healthy, the Breakdown card counting 4 passing, 1 needs attention and 1 not applicable, and the Setup Status list of checks.](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/getting-started/tracking-health/01.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=243ee5e67f02a903de0356733b7427a6)

| Score | Label |
| - | - |
| 71 to 100 | **Healthy** |
| 41 to 70 | **Getting There** |
| 0 to 40 | **Needs Attention** |

The score is the share of active checks that pass. A check is active when it is passing or failing: checks that are waiting for data or not applicable are left out. For example, three passing checks and one failing check give a score of 75. With no active checks, the ring shows `--` and **Not enough data yet.**

## Breakdown

The **Breakdown** card counts your checks by status. A status with no checks is not listed.

| Status | Icon | Meaning |
| - | - | - |
| **Passing** | Green check | The check passes. |
| **Needs attention** | Red X | The check fails. |
| **Waiting for data** | Amber clock | Cometly cannot judge yet, for example right after you connect an ad account. |
| **Not applicable** | Gray dash | The check does not apply to your setup yet, for example the Conversion API is off. |

Below the counts, the card states how many active checks the score is based on. **Change your setup answers** opens step 1.

## Setup Status

Each row shows the check's status icon, its name and a sentence describing the current state. A failing row also shows a fix button and expandable **Troubleshooting steps**. A failing **URL Parameters** row lists each affected ad platform with its number of ads.

| Check | Passes when | Fails when | Fix button |
| - | - | - | - |
| **Pixel Installed** | At least one of your domains is verified. | You have added domains but none is verified. | **Go to Setup** opens step 2. |
| **URL Parameters** | No active ad in an active, tracked campaign has a URL parameter error. | One or more of those ads has a URL parameter error. | **Go to Setup** opens step 4. |
| **Form Tracking** | Form tracking was detected on at least one page you tested in step 2. | No tested page has form tracking detected. | **Go to Setup** opens step 2. |
| **Ad Data** | Ad data has been pulled in from at least one connected ad platform. | Your ad accounts have been connected for more than 2 hours and no ad data has arrived. | **Go to Setup** opens step 3. |
| **Event Data** | Event data was received from your integrations in the last 7 days. | Events are configured but no event data was received in the last 7 days. | **View Events Log** opens the Events Log. |
| **Conversion API** | The Conversion API is on and a conversion was sent successfully in the last 14 days. | The Conversion API is on, sends were attempted and none succeeded in the last 14 days. | **Troubleshoot** opens [Conversion API not sending conversions](https://docs.cometly.com/support/troubleshooting/conversion-api/conversions-not-sending.md) in a new tab. |

These pages go deeper on fixing each check:

* **Pixel Installed**: [Install and verify the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md) and [pixel troubleshooting](https://docs.cometly.com/support/troubleshooting/overview.md#pixel)
* **URL Parameters**: [Fix UTM Setup Errors](https://docs.cometly.com/support/troubleshooting/url-parameters/utm-setup-errors.md)
* **Form Tracking**: [Test form tracking](https://docs.cometly.com/guides/form-tracking/testing.md)
* **Ad Data**: [Ad data not syncing](https://docs.cometly.com/support/troubleshooting/ad-data/ad-data-not-syncing.md)
* **Event Data**: [Create and configure events](https://docs.cometly.com/getting-started/events.md)
* **Conversion API**: [Conversion API overview](https://docs.cometly.com/guides/conversion-api/overview.md) and [Conversion API not sending conversions](https://docs.cometly.com/support/troubleshooting/conversion-api/conversions-not-sending.md)

A check is not always passing or failing:

* **Pixel Installed** and **Form Tracking** wait until you add a domain. **Form Tracking** is only listed if you answered **Yes** to forms on your site in step 1.
* **URL Parameters** and **Ad Data** wait until an ad account is connected, then for about 2 hours while the first ad data syncs.
* **Event Data** is not applicable until at least one event is connected to an integration.
* **Conversion API** is not applicable while the Conversion API is off for every ad platform. The row tells you whether you have event data yet and, during the first 7 days of event data, how many days Cometly recommends you still wait before turning it on. Once it is on, the check waits until the first conversion is processed.

## Issues Found

This section appears only when the **Lead Form Tracking** check fails. The check runs if you answered **Yes** to native lead forms in step 1. It looks for lead form campaigns on your connected Meta and LinkedIn ad accounts, and fails when such campaigns exist but no event data has reached Cometly in the last 14 days. The row names the platforms to look at, and **Fix Lead Forms** opens the Meta lead form tracking guide in a new tab.

For the setup behind this check, see [Meta lead form tracking](https://docs.cometly.com/integrations/forms/meta-lead-forms.md) and [LinkedIn Lead Gen Form tracking](https://docs.cometly.com/integrations/forms/linkedin-lead-forms.md).

While this check passes it is not listed, but it still counts under **Passing** in the breakdown and in the score.

## How Tracking Health affects the Setup steps

Two Setup steps are tied to these checks, so they can change after you complete them:

* Step 4, **Add URL parameters to your ads**, is complete while **URL Parameters** passes and returns to not done when ads with errors are found.
* Step 6, **Send conversions to ad platforms**, is complete while **Conversion API** passes.

## Frequently asked questions

### How often does Cometly update the Tracking Score?

The checks are recalculated each time the page loads, so there is no schedule to wait for. Reload the **Tracking Health** tab to see the latest result.

### Does a check that is waiting for data lower my Tracking Score?

No. The score only counts active checks, which are the ones that are passing or failing. Checks that show **Waiting for data** or **Not applicable** are left out until Cometly can judge them.

### Can the Setup assistant check my tracking health for me?

Yes. The Setup assistant can look up what exists in your space, including its tracking health, and help you with the step behind a failing check. See [Setup assistant](https://docs.cometly.com/getting-started/setup-assistant.md).

## Next steps

* [Fix UTM Setup Errors](https://docs.cometly.com/support/troubleshooting/url-parameters/utm-setup-errors.md): clear a failing **URL Parameters** check
* [Conversion API overview](https://docs.cometly.com/guides/conversion-api/overview.md): turn on conversion sending once event data is flowing
* [About your business](https://docs.cometly.com/getting-started/about-your-business.md): the answers that decide which checks run
* [Setup](https://docs.cometly.com/getting-started/setup.md): the seven steps these checks are tied to
* [Setup assistant](https://docs.cometly.com/getting-started/setup-assistant.md): get help with a step that needs attention

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.