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

# Test your Meta ads tracking

> Test Meta ads tracking in Cometly: click your own ad, complete a conversion, and confirm the click and the event are credited to the right ad.

You have set up Cometly, but you are not sure that a click on one of your Meta (Facebook and Instagram) ads ends up as a conversion credited to that ad. Or a lead or sale you expected is missing from your reports, and you want to find out where it got lost.

Three things have to work together for a conversion to be attributed to the right ad: the Cometly pixel (the script on your website that tracks your visitors), the URL parameters (the short tags at the end of the ad's link that tell Cometly which ad was clicked), and the event (the action Cometly records, such as a lead or a purchase). If one of them is missing or set up incorrectly, the conversion is not tied to the ad.

To find out which part is failing, test Meta ads tracking end to end: click your own ad, complete the conversion, and check what Cometly recorded. The steps below walk you through it.

[Test your Meta ads tracking video](https://www.loom.com/embed/324c7efd20aa4bfc814915720579c293)

## Prerequisites

Before you start this test, make sure that:

* You have completed the steps in [Setup](https://docs.cometly.com/getting-started/setup.md).
* Your [Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md) is installed.
* Your [events](https://docs.cometly.com/getting-started/events.md) are configured.
* Cometly's [URL parameters](https://docs.cometly.com/getting-started/url-parameters.md) are added to your Meta ads.

## Test Meta ads tracking step by step

**1. Select an ad for testing**

1. Go to your **Meta Ads Manager**.
2. Find an ad you want to test that has the Cometly URL parameters.
3. Click the ad and select **Preview**.
4. Under the **View on Facebook** dropdown, select **Facebook Desktop News Feed**.

> [!WARNING]
>
> Do not use the Preview link at ad level. It does not pass the dynamic URL parameters through, so the test will not work.

**2. Click the ad like a normal user**

1. Find your ad in your Facebook News Feed (you may need to scroll past a few posts).
2. Click the ad using the button or the ad headline.
3. (Optional) Right-click and open the ad in an **Incognito/Private Browsing window** to start a fresh tracking session.

**3. Verify the URL parameters**

Once the ad opens in your browser, check that the Cometly URL parameters in the address bar are filled in with real values.

Example: `comet_source=fb`, `comet_ad_id=123456789`, `comet_placement=Facebook_Desktop_Newsfeed`

If the parameters appear with values like these, the click data is being captured properly.

**4. Complete the conversion action**

1. Perform the conversion event you want to test:
   * If testing a **lead opt-in**, submit the form.
   * If testing a **booked call**, book a call.
   * If testing a **purchase**, complete the checkout.
2. If necessary, verify your email or complete any other required steps.

**5. Check the data in Cometly**

1. Return to your Cometly account.
2. Go to the [**Report Builder**](https://app.cometly.com/custom/report). You can also go straight to the [**Contacts**](https://app.cometly.com/journeys/profiles) page and search for the email you used.
3. In the Report Builder, under **Metrics**, click **Add Metrics** and select the event you tested.
4. Refresh the page and check that the event count has increased. For example, if the previous count was **9**, it should now show **10**.
5. Click the new event to view the contact's full journey. You should see the exact ad you clicked and all the events tracked.

**6. (Optional) Run additional tests**

* To verify tracking for multiple events (for example, a lead submission followed by a purchase), repeat the steps above and check that Cometly updates the full journey in real time.
* If you use multiple emails, Cometly tracks them under the same contact if they belong to the same person.

## Confirm the test worked

Your tracking works when the event count in the **Report Builder** has gone up by one and the new event opens a contact whose journey shows the exact ad you clicked. You can also search for the email you used on the **Contacts** page and open the contact from there.

## Troubleshooting

If the data does not appear correctly in Cometly:

* Double-check that you opened the ad through the **Facebook Desktop News Feed** preview.
* Make sure the **Cometly pixel** is placed on all relevant pages.
* Verify that the Cometly **URL parameters** are present in the ad URL.
* Confirm that the event reached Cometly: open **Events Manager** > **Events Log**, or use the [Cometly Pixel Helper](https://docs.cometly.com/guides/tracking/pixel-helper.md) on the page.

## Frequently asked questions

### How long does a test conversion take to show up in Cometly?

The event shows in the **Events Log** within 60 seconds, so check there first to confirm Cometly received it. It can take up to 15 minutes to appear in the reporting areas, such as the Report Builder or Ads Manager.

### How do I remove a test conversion from my Cometly reports?

Open the contact from **Contacts**, find the test conversion in the **Timeline**, click the three-dot menu next to its date and click **Delete**. This keeps test leads and purchases out of your attribution and reports. See [Edit or delete a conversion on a contact](https://docs.cometly.com/guides/events/edit-or-delete-conversions.md).

### Do I need the Cometly Pixel Helper to test my tracking?

No. The Pixel Helper is a Chrome extension that shows whether the pixel and your events fire on a page, which helps when a test fails. You can also check the pixel inside Cometly: go to **Setup** > **Install the Cometly pixel** and use **Verify your pixel**.

## Next steps

* [Use the Events Log to check the events Cometly received](https://docs.cometly.com/support/troubleshooting/general/event-log.md)
* [Fix UTM Setup Errors on your ads](https://docs.cometly.com/support/troubleshooting/url-parameters/utm-setup-errors.md)
* [Understand No Source in reports](https://docs.cometly.com/support/troubleshooting/sources/no-source.md)
* [Why Cometly attribution differs from Meta Ads Manager](https://docs.cometly.com/support/troubleshooting/reporting/attribution-differs-from-meta.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.