ClickFlare Parameters in Postback URLs

Understanding the Data Passed in Your S2S Postback URL
E
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:

  1. When a visitor clicks on an ad, ClickFlare assigns a unique click ID and appends it to the offer URL.
  2. The affiliate network captures this click ID and stores it during the conversion process.
  3. Upon conversion, the network sends the click ID back to ClickFlare via the postback URL.
  4. 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?