> ## 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 affiliate conversions

> Track affiliate conversions in Cometly: build a Report Builder report that shows the traffic and leads each of your affiliate links drives.

To track affiliate conversions in Cometly, you build a report in the Report Builder that only counts visits whose link carries your affiliate software's tracking parameter. The report shows the traffic and the events (the actions Cometly records, such as a **Website Visit** or a **Lead**) that came from affiliate links.

This lets you see how much of your traffic and how many of your leads come from affiliates, and which affiliate sent them. You can then decide which partners are worth more of your attention.

If you use affiliate tracking software such as [FirstPromoter](https://new.firstpromoter.com/) or [Rewardful](https://www.rewardful.com/), your affiliates get unique links with a tracking parameter at the end of the URL. For example:

* **FirstPromoter:** `?fpr=xyz`
* **Rewardful:** `?via=xyz`

These parameters show that the traffic and conversions came from an affiliate. In Cometly, you can filter on them to report on affiliate traffic and conversions, down to the individual affiliate.

## Before you start

* Install the Cometly pixel (the small script that records where your visitors come from) on the site your affiliate links point to. See [Install and verify the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md).
* Know the tracking parameter your affiliate software adds to affiliate links (for example `fpr` or `via`).

## Build the affiliate report

**1. Select the report type and metrics**

Click **Report Builder** in the sidebar, then:

* Choose the report type (for example **Area**).
* Under **Metrics**, add the events you want to analyze, such as **Website Visit** and **Lead**.

**2. Set the attribution model to First Touch**

Under **Attribution**, select **First Touch**. The attribution model is the rule that decides which touchpoint gets credit for a conversion. First Touch gives affiliate traffic full credit over any later touchpoint.

**3. Leave Sources empty**

Some affiliate traffic comes in under the Direct Traffic or Referral sources. Leaving **Sources** empty is the same as **All Sources**, so nothing is left out of the report.

**4. Add a URL Parameters filter**

This is the most important step.

1. Under **Filters**, add a filter and select **URL Parameters**.
2. Choose **contains**.
3. Enter the parameter your affiliate software uses:
   * **FirstPromoter:** `fpr`
   * **Rewardful:** `via`
   * For another tool, enter the parameter it adds to affiliate links.

The chart now shows only affiliate-driven traffic and conversions.

**5. Check the data against a contact**

Click a data point to see the contacts behind it, and open one to confirm that the affiliate parameter is on the URL of their visit.

## Optional: filter for one affiliate

To see the performance of a single affiliate, add a second condition to the same filter:

1. Click the plus button next to the filter you already have.
2. Select **URL Parameters**, choose **contains**, and enter that affiliate's code (for example `fpr=abc123`).
3. Make sure the two conditions are joined with **AND**, not **OR**. Click the connector to switch it.

## See a breakdown of all affiliates

To get a table that breaks down traffic and conversions by affiliate:

1. **Choose the Table report type.** A table gives a clearer breakdown than an area chart.

2. **Keep the same filter.** Leave the **URL Parameters** **contains** filter in place (for example `fpr` for FirstPromoter or `via` for Rewardful).

3. **Group by URL Parameters.** Under **Group By**, select **URL Parameters**. The report now has one row for each unique set of URL parameters, so each affiliate ID gets its own rows.

4. **Read the table.** Each row shows the affiliate's tracking parameters with its **Website Visit** and **Lead** counts. Click a number in a row to see the contacts behind it.

To keep the report, click **Add To Dashboard**.

## Check it worked

The report now shows only the visits and conversions whose link carries your affiliate parameter. Click a data point and open one of the contacts behind it: the parameter (for example `?fpr=`) is on the URL of their visit. In the **Table** report grouped by **URL Parameters**, each affiliate ID has its own rows.

## Frequently asked questions

### Why does my affiliate traffic show up as Direct or Referral in Cometly?

Cometly sets the source of a visit from the page the visitor came from. A click from an affiliate's website arrives as **Referral**, and a click with no referring page (a saved link, or a blocked referrer) arrives as **Direct / None**. That is why this report leaves **Sources** empty and finds affiliates by their URL parameter instead.

### 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 affiliate codes such as `fpr` and `via` live, so it is the one to use here.

### Can I track affiliates in Cometly without affiliate software?

Yes. Give each affiliate a link that ends in a `comet_custom` parameter (for example `?comet_custom=affiliate123`), then filter the report on that value with **URL Parameters** > **contains**. See [Custom URL parameter setup](https://docs.cometly.com/guides/url-parameters/custom-sources.md).

## Next steps

* [Track custom parameters](https://docs.cometly.com/guides/report-builder/custom-parameters.md)
* [URL vs. URL Parameters filters](https://docs.cometly.com/guides/report-builder/url-vs-url-parameters-filters.md)
* [Create grouped reports](https://docs.cometly.com/guides/report-builder/grouped-reports.md)
* [Attribution models and windows](https://docs.cometly.com/guides/analyzing-data/attribution-models-and-windows.md)
* [Customize your dashboards](https://docs.cometly.com/guides/dashboards/customize.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.