ClickFlare Parameters in Postback URLs

Understanding the Data Passed in Your S2S Postback URL

Written by Ervis

Updated 3 weeks ago

When using S2S postback tracking in ClickFlare, specific parameters must be included in the postback URL to ensure conversions are accurately recorded. These parameters allow ClickFlare to match conversions to the correct click and track additional details such as payout, transaction IDs, and custom values.

Below is a breakdown of all available parameters in ClickFlare postback URLs.

1. Required Parameter in ClickFlare Postback URLs

click_id Parameter (Mandatory)

The click_id parameter is required for tracking conversions in ClickFlare. It is used to pass the unique ClickFlare click ID, which identifies a specific visit and ensures the conversion is attributed to the correct campaign.

Note: ClickFlare uses two interchangeable macros/parameters for passing the click ID: {cf_click_id} and {click_id}. Both can be used in the offer URL and the postback URL, and ClickFlare will correctly process them regardless of which was used.

How Click ID Works in ClickFlare:

When a visitor clicks on an ad, ClickFlare assigns a unique click ID and appends it to the offer URL.
The affiliate network captures this click ID and stores it during the conversion process.
Upon conversion, the network sends the click ID back to ClickFlare via the postback URL.
ClickFlare matches the click ID with the original visit and records the conversion.

Example: Passing Click ID in the Offer URL

https://www.offer_link.com?s2={cf_click_id}

In this example:

{cf_click_id} is the ClickFlare token that dynamically inserts the unique click ID.
The affiliate network must pass the same click ID back in the postback URL.

Example: Correct Postback URL with Click ID

https://your_clickflare_domain.com/cf/cv?click_id={affiliate_network_clickid_token}

Important: If the click ID is missing or incorrect, ClickFlare will not be able to register the conversion

2. Optional Parameters in ClickFlare Postback URLs

payout Parameter (Optional) – Tracking Revenue

The payout parameter is used to track the revenue associated with each conversion. If your affiliate network provides a payout token, you can include it in the postback URL for automatic revenue tracking.

Example: Postback URL with Payout

https://your_clickflare_domain.com/cf/cv?click_id={clickid}&payout={payout_token}

{payout_token} should be replaced with the network’s token for revenue.
If omitted, ClickFlare will not automatically track revenue.

txid Parameter (Optional) – Unique Transaction ID

The txid parameter is used to track unique transaction IDs for each conversion. It is helpful for tracking upsells, multiple conversions per user, or fraud prevention.

Example: Postback URL with Transaction ID

https://your_clickflare_domain.com/cf/cv?click_id={clickid}&txid={transaction_id}

{transaction_id} should be replaced with the network’s unique transaction token.

ct Parameter (Optional) – Tracking Custom Conversion Types

ClickFlare allows tracking different types of conversions, such as leads, purchases, or trial sign-ups, using the ct (custom conversion) parameter.

Example: Postback URL with Conversion Type

https://your_clickflare_domain.com/cf/cv?click_id={clickid}&ct=sale

currency Parameter (Optional) – Defining Payout Currency

By default, ClickFlare uses the currency set at the offer level. However, if your affiliate network provides currency data, you can override this setting using the payout_currency parameter.

Example: Postback URL with Currency

https://your_clickflare_domain.com/cf/cv?click_id={clickid}&payout={payout_token}&payout_currency=USD

Replace USD with the correct currency code.
This ensures revenue is recorded in the right currency.

3. Additional Parameters for Custom Data

ClickFlare allows passing custom values using param1 to param20. These parameters can store extra information from the affiliate network, such as:

Traffic source data
Custom user attributes
Affiliate subIDs

Example: Postback URL with Custom Parameters

https://your_clickflare_domain.com/cf/cv?click_id={clickid}&param1={network_subid}&param2={user_device}

{network_subid} stores an affiliate’s subID.
{user_device} captures the user’s device type.

To enable additional parameters, enable the Include additional parameters in the postback URL toogle.

4. Summary Table of ClickFlare Postback Parameters

Parameter	Required?	Description	Example Value
`click_id`	✅ Yes	Click ID to match conversion	{clickid}
`payout`	❌ Optional	Revenue per conversion	{payout_token}
`txid`	❌ Optional	Unique transaction ID	{transaction_id}
`ct`	❌ Optional	Conversion type	sale, lead
`payout_currency`	❌ Optional	Conversion currency	USD, EUR
`param1-param20`	❌ Optional	Custom data fields	{network_subid}, {user_device}

FREQUENTLY ASKED QUESTIONS

Got questions? Find the answers below:

Q1: What happens if I don't include the click_id parameter in the postback?

A1: ClickFlare cannot track the conversion if the click_id is missing. Make sure your affiliate network correctly stores and passes this value back.

Q2: Can I use both {cf_click_id} and {click_id} macros?

A2: Yes, both macros work interchangeably in both offer and postback URLs.

Q3: How can I verify if my postback URL is working?

A3: Check the Conversion Logs in ClickFlare to see if conversions are being registered.

Related Resources

Did this answer your question?