
- The offer URL sends the ClickFlare click ID to Awin in
clickref2. - The postback URL sends it back to ClickFlare with every transaction, together with your commission and Awin’s transaction ID. Awin calls this a Transaction Notification.
clickref2, how to handle program currencies, and what happens when an advertiser validates or declines a transaction.
At a glance
To set up Awin with ClickFlare:- Set the domain and reporting time.
- Create the Awin affiliate network.
- Build the tracking link in Awin.
- Create the offer in ClickFlare.
- Turn on Transaction Notifications.
How the data flows
!!!clickRef2!!! on the way out. The link parameter is lowercase (clickref2); the macro is camel case (!!!clickRef2!!!). Awin macros are wrapped in three exclamation marks.What you’ll need
- An active ClickFlare account with your own tracking domain set up. Shared domains get flagged by networks and blocked by browsers. See Tracking domains.
- An Awin publisher account, approved in the advertiser programs you want to promote.
- Access to Transaction Notifications in Awin. If you don’t see it under Toolbox, raise a support ticket with Awin to request access.
What the AWIN template contains
ClickFlare has an AWIN affiliate network template. It fills in the Awin macros ClickFlare needs.
Setup
Everything in ClickFlare is done from inside the campaign editor. Create the offer and the affiliate network inline as you go.Set up your own tracking domain
trk.yourdomain.com. The postback URL is built on this domain, so changing it later means updating the callback in Awin too. See Tracking domains.Report conversions by postback time
Create the campaign
Create the Awin affiliate network
- Search for AWIN and pick the AWIN template.
- Name it, for example “Awin”. Transaction Notifications are set once for your Awin account, so one affiliate network covers every Awin program.
- Check that Click Id is
!!!clickRef2!!!, Payout is!!!commission!!!and Transaction ID is!!!transactionId!!!. - Leave Event Type empty.
- Under Conversion tracking, select your own Tracking Domain and keep S2S Postback URL as the tracking method.
- Set Payout currency to the currency your Awin programs pay in. If they pay in several currencies, see Programs in other currencies.

Build the tracking link in Awin
{cf_click_id} in ClickRef2. Braces are on Awin’s list of approved ClickRef characters. Check the generated link: it must contain {cf_click_id} with the braces as typed. If the braces were encoded as %7B and %7D, fix them by hand in the offer URL.If you build the link yourself, put the ClickRefs before the destination URL, as Awin asks. The destination is the part that holds the advertiser’s page.clickref2, not clickref. Only the first ClickRef (ClickRef1) is visible to advertisers. ClickRef2 keeps the ClickFlare click ID in your own reports only, and leaves ClickRef1 free for a label you don’t mind advertisers seeing.Create the offer in ClickFlare
- Name the offer, for example after the advertiser.
- Select the Awin affiliate network you just created.
-
Paste the Awin link into Offer URL. It must contain
clickref2={cf_click_id}, either from the Link Builder or added by hand before the destination URL.
clickref2={cf_click_id} to the end of the link. That puts it after the destination URL, not before it as Awin recommends, so prefer the Link Builder or adding it by hand, and leave the toggle off. Use one or the other, not both.Set the payout to Auto so ClickFlare uses the payout value from the notification.Turn on Transaction Notifications in Awin
Add a lander (optional)
Save the campaign and launch
ClickRef rules
Awin applies a few rules to ClickRef values. The ClickFlare click ID meets them, but keep them in mind if you add your own labels in the other ClickRefs:- Awin links take up to six ClickRefs:
clickrefandclickref2toclickref6. Keep the click ID inclickref2and use the others for labels such as a placement or creative. - Keep each value under 50 characters, or the Click Reference report won’t show it in full.
- Don’t use
#,+,",;,&,|or'in a ClickRef value. - Awin’s Click Reference report shows ClickRef1 only. Data from the other ClickRefs is available in exports and through Awin’s Publisher API.
Programs in other currencies
!!!commission!!! is a plain number in the advertiser program’s currency. Awin programs run in many currencies, so a single Payout currency on the affiliate network can be wrong for some of them.
Awin’s !!!transactionCurrency!!! macro returns the program currency as a three-letter code, such as GBP or EUR. Add it to the postback with ClickFlare’s payout_currency parameter, which overrides the network’s currency per conversion:
param1=!!!merchantId!!! records the advertiser program ID with each conversion. ClickFlare accepts param1 to param20.
Pending, approved and declined transactions
Awin sends a Transaction Notification when it records a transaction. At that point the commission is pending. The advertiser then validates it during the program’s validation period:- Approve: the commission becomes payable.
- Amend: the advertiser corrects the order value or commission group, which changes the commission.
- Decline: the commission is cancelled, for example because the order was returned or broke the program terms.
!!!transactionId!!!, and ClickFlare replaces the earlier conversion with the one received last instead of counting it twice.
Verify the setup
Click through the campaign
clickref2= followed by a real ClickFlare click ID, not the literal text {cf_click_id}.Test the postback by hand
https://trk.yourdomain.com/cf/cv?click_id=REAL_CLICK_ID&payout=1&txid=test1. The conversion should show on the campaign. This tests ClickFlare’s side only.Wait for a real transaction
txid. Check the transaction in Awin’s reports too, with ClickRef2 holding the same click ID.Troubleshooting
Transactions show in Awin but not in ClickFlare
Transactions show in Awin but not in ClickFlare
- Notifications are off. Check Toolbox → Transaction Notifications. The ClickFlare URL must be saved there.
- The call-back method is POST. Switch it to GET. With POST, the macros in the URL aren’t replaced.
- ClickRef2 is empty in Awin. The offer URL is missing
clickref2={cf_click_id}, or the lander CTA links straight to Awin instead of using the ClickFlare click URL. - The click ID went into another ClickRef. If the link uses
clickrefbut the postback reads!!!clickRef2!!!, ClickFlare gets an empty value. Both sides must use the same ClickRef. - The postback uses an unusual port. Awin sends notifications on ports 80 and 443 only. Use a normal
https://tracking domain.
ClickFlare receives a literal macro or cf_click_id
ClickFlare receives a literal macro or cf_click_id
- A literal
!!!clickRef2!!!means Awin didn’t replace the macro. Check the spelling, and copy macros exactly as Awin writes them, including the capital R inclickRef2. - A literal
cf_click_idmeans the offer URL in ClickFlare has the token without braces. It must be{cf_click_id}.
The payout is too high
The payout is too high
!!!transactionAmount!!! (the sale amount) instead of !!!commission!!!. Change Payout in the affiliate network, then update the Call-back URL in Awin.The payout is in the wrong currency
The payout is in the wrong currency
!!!commission!!! is in the program’s currency. Add payout_currency=!!!transactionCurrency!!! to the postback, as shown in Programs in other currencies.FAQ
Does ClickFlare integrate with Awin?
Does ClickFlare integrate with Awin?
Do I need a separate postback for each Awin advertiser?
Do I need a separate postback for each Awin advertiser?
Can I use clickref instead of clickref2?
Can I use clickref instead of clickref2?
clickref to clickref6 works if the offer URL and the postback use the same one. clickref2 is the better choice because advertisers can see ClickRef1 but not the others. If you change it, change Click Id in the affiliate network to the matching macro, for example !!!clickRef3!!!.How fast do Awin transactions reach ClickFlare?
How fast do Awin transactions reach ClickFlare?
Can I send the conversion back to my traffic source?
Can I send the conversion back to my traffic source?