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

# Track custom parameters

> Track custom parameters in Cometly: add comet_custom to a link, then see the leads and sales that link produced in the Report Builder.

Custom parameters let you track the performance of a specific campaign, promotion or affiliate. You add a `comet_custom` value to a link, and Cometly records it on every visit that arrives through that link.

This is useful when you want to measure one initiative, such as a special offer or affiliate-driven traffic. When you track custom parameters, you can see how many leads, trials or purchases that one link produced, and decide whether it deserves more of your time and budget.

Watch the video, or follow the written steps below it.

[Tracking custom parameters in Cometly](https://www.loom.com/embed/c39b9f66b3784af68ad6c00e2d2bf688)

## What is a custom parameter?

A custom parameter is a unique identifier (for example `comet_custom=XYZ`) that you add to your links. It lets you see the results of a specific campaign or promotion in Cometly.

For example:

* Track the number of leads driven by a particular affiliate.
* See how many conversions came from a specific campaign or promotion.

## Before you start

* Install the Cometly pixel (the small script that records where your visitors come from) on the site your link points to. See [Install and verify the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md).

## Add a custom parameter to your links

**1. Decide on your custom parameter**

Choose a unique identifier that makes sense for your campaign or promotion. For instance:

* `comet_custom=affiliate123` to track an affiliate.
* `comet_custom=summerpromo` for a summer promotion.
* `comet_source=ig&comet_custom=igbio` to track visits from your Instagram bio.

**2. Add the parameter to your links**

Append `?comet_custom=XYZ` to the URL of the page you are promoting. If the URL already has other parameters, add `&comet_custom=XYZ` after them.

* If your original URL is `https://www.yourwebsite.com`, the new link is `https://www.yourwebsite.com?comet_custom=XYZ`
* If your original URL is `https://www.yourwebsite.com?comet_source=google`, the new link is `https://www.yourwebsite.com?comet_source=google&comet_custom=XYZ`

**3. Share the updated link**

Share the link with your affiliates or partners, or use it in your campaigns. When someone clicks it, the custom parameter is passed through to Cometly.

**4. See the results in the Report Builder**

Click **Report Builder** in the sidebar and build a report on the metrics you care about (leads, trials, purchases and so on):

* Use the **Table** report type and set **Group By** to **URL Parameters**.
* Under **Filters**, add **URL Parameters** > **contains** > `summerpromo` (or whatever your custom parameter is).
* Leave **Sources** empty so all sources are included.
* Set the attribution model (the rule that decides which touchpoint gets credit for a conversion) to **First Touch**.
* Set the attribution window (the period of time during which an event can be credited to a source or ad) to **LTV**.

## Tips

* Use descriptive, unique names so tracking is easier. For example, use `comet_custom=blackfriday2025` instead of `comet_custom=test`.
* Test the updated link before you share it widely.

## Check it worked

Click your updated link yourself, then open the report you built in the **Report Builder**. With **Group By** set to **URL Parameters** and your **URL Parameters** filter in place, traffic from the link appears under your custom parameter.

## Frequently asked questions

### Can Cometly build the comet\_custom parameter for me?

Yes. In Cometly, go to **Setup** and open step 4, **Add URL parameters to your ads**. Choose **Custom Tracking** in the **Select integration** dropdown, enter a name under **Custom parameter name**, then click **Copy Parameters**. See [Custom URL parameter setup](https://docs.cometly.com/guides/url-parameters/custom-sources.md).

### What is the difference between the URL filter and the URL Parameters filter?

The **URL** filter looks at the host and path of the page a visitor landed on. The **URL Parameters** filter looks at the query parameters on the link, which is where `comet_custom` lives, so it is the one to use for custom parameters.

### Why use First Touch and LTV for a custom parameter report?

**First Touch** gives the visit that came through your link full credit over any later touchpoint. **LTV** has no time limit, so a conversion still counts when it happens long after the click.

## Next steps

* [URL versus URL Parameters filters](https://docs.cometly.com/guides/report-builder/url-vs-url-parameters-filters.md)
* [Track affiliate conversions](https://docs.cometly.com/guides/report-builder/affiliate-conversions.md)
* [Custom URL parameter setup](https://docs.cometly.com/guides/url-parameters/custom-sources.md)
* [Attribution models and attribution windows](https://docs.cometly.com/guides/analyzing-data/attribution-models-and-windows.md)
* [Build a report in the Report Builder](https://docs.cometly.com/guides/report-builder/build-a-report.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.