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 examplecomet_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.
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=affiliate123to track an affiliate.comet_custom=summerpromofor a summer promotion.comet_source=ig&comet_custom=igbioto 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 ishttps://www.yourwebsite.com?comet_custom=XYZ - If your original URL is
https://www.yourwebsite.com?comet_source=google, the new link ishttps://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=blackfriday2025instead ofcomet_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 wherecomet_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
- Track affiliate conversions
- Custom URL parameter setup
- Attribution models and attribution windows
- Build a report in the Report Builder