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.
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}
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}¶m1={network_subid}¶m2={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.