Skip to main content
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.

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

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.

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

Still have questions or need a hand? We’re happy to help. Reach our team at support@cometly.com.