Clickwise in your tracker.
Add Clickwise as an affiliate network in your tracker. Your tracker puts its click ID in the Clickwise link, and the Clickwise postback sends it back with the commission, the currency and the status of every sale.
How it works
- Link. Your tracker adds its click ID to the Clickwise link in the
sub_idparameter:https://partners.clickwise.net/dl/YOUR_LINK_ID/?sub_id=<tracker token>(use&sub_id=when the link already has a?). - Postback. In the Clickwise portal, Settings > Postback: paste your tracker's postback URL from this page, method
GET. - Sale. Every sale on that click returns the tracker's click ID as
{subid}, with{commission}(what you earn),{currency},{transaction_id},{status}and{event}.
{subid} for the tracker's click ID. {click_id} is the Clickwise click ID, which your tracker does not know. Clickwise has no {clickid} macro: when you save a postback with an unknown macro, the portal lists it so you can fix it.Events and statuses
Your account has one postback URL and every sale event reaches it. Each sale sends created first; then approved or declined; an approved sale that is later cancelled sends reversed.
{event} | {status} | Meaning |
|---|---|---|
created | pending | The sale was recorded and is waiting for the merchant. |
approved | approved | The merchant confirmed the sale. |
declined | declined | The merchant rejected a sale that was never approved. |
reversed | declined | An approved sale was cancelled or refunded. |
Summary
| Tracker | Link parameter | Click ID in the postback | Payout | Status |
|---|---|---|---|---|
| Voluum | sub_id={clickid} | cid={subid} | payout={commission} | et={event} |
| RedTrack | sub_id={clickid} | clickid={subid} | sum={commission} | status={status} |
| Binom | sub_id={clickid} | cnv_id={subid} | payout={commission} | cnv_status={status} |
| Keitaro | sub_id={subid} | subid={subid} | payout={commission} | status={status} |
| BeMob | sub_id={clickId} | cid={subid} | payout={commission} | status={status} |
| ClickMagick | sub_id=[cmc_vid] | s1={subid} | amt={commission} | No status parameter |
Voluum
Offer URL (your Clickwise link with Voluum's click ID token {clickid}):
https://partners.clickwise.net/dl/YOUR_LINK_ID/?sub_id={clickid}
Postback URL (Clickwise portal, Settings > Postback, method GET). Replace YOUR_VOLUUM_DOMAIN with your own:
https://YOUR_VOLUUM_DOMAIN/postback?cid={subid}&payout={commission}&txid={transaction_id}¤cy={currency}&et={event}
| Field | Voluum parameter | Clickwise macro |
|---|---|---|
| Tracker's click ID | cid | {subid} |
| Payout | payout | {commission} |
| Currency | currency | {currency} |
| Transaction ID | txid | {transaction_id} |
| Status | et | {event} |
Statuses. Voluum has no status parameter: each event arrives as a custom conversion type (et=created, approved, declined or reversed). Voluum rejects a second postback only for the same click ID and the same conversion type. Voluum does not reverse revenue from a postback. Keep declined and reversed out of the Revenue column; correct revenue with Conversion Upload if you need to.
- Affiliate networks > Create > Other affiliate network. Name it Clickwise.
- Turn on "Append click ID to offer URLs" with the parameter sub_id, or end each offer URL with ?sub_id={clickid} yourself.
- Use the domain of your Voluum postback URL in the postback above.
- Settings > Custom conversions: add four types with the accepted values created, approved, declined and reversed. Suggested: created counts in Conversions and Revenue; approved, declined and reversed count in neither (they show the outcome of each sale). If you prefer to count only confirmed commission, put approved in Revenue instead of created.
- Add each Clickwise program as an offer under this network: the Clickwise link plus ?sub_id={clickid}.
Voluum documentation: Add an affiliate network · Postback parameters · Custom conversions
RedTrack
Offer URL (your Clickwise link with RedTrack's click ID token {clickid}):
https://partners.clickwise.net/dl/YOUR_LINK_ID/?sub_id={clickid}
Postback URL (Clickwise portal, Settings > Postback, method GET). Replace YOUR_REDTRACK_DOMAIN with your own:
https://YOUR_REDTRACK_DOMAIN/postback?clickid={subid}&sum={commission}¤cy={currency}&status={status}
| Field | RedTrack parameter | Clickwise macro |
|---|---|---|
| Tracker's click ID | clickid | {subid} |
| Payout | sum | {commission} |
| Currency | currency | {currency} |
| Status | status | {status} |
Statuses. status carries pending, approved or declined, the same words RedTrack uses. A reversal arrives as declined. Set the duplicate postback mode to "Edit conversion with new data" so a later status updates the same conversion instead of adding a new one.
- Offer sources > New From Scratch. Name it Clickwise.
- In the postback parameters, enter the Clickwise macros: clickid = {subid}, sum = {commission}, currency = {currency}, status = {status}. RedTrack builds the postback above with your domain.
- Duplicate postback mode: "Edit conversion with new data".
- Add each Clickwise program as an offer: the Clickwise link plus ?sub_id={clickid}.
RedTrack documentation: Adding offer source and offer · Conversion types, statuses and duplicates
Binom
Offer URL (your Clickwise link with Binom's click ID token {clickid}):
https://partners.clickwise.net/dl/YOUR_LINK_ID/?sub_id={clickid}
Postback URL (Clickwise portal, Settings > Postback, method GET). Replace YOUR_BINOM_DOMAIN with your own:
https://YOUR_BINOM_DOMAIN/click.php?cnv_id={subid}&payout={commission}&cnv_currency={currency}&cnv_status={status}&cnv_status2={event}
| Field | Binom parameter | Clickwise macro |
|---|---|---|
| Tracker's click ID | cnv_id | {subid} |
| Payout | payout | {commission} |
| Currency | cnv_currency | {currency} |
| Status | cnv_status | {status} |
| Event | cnv_status2 | {event} |
Statuses. cnv_status carries pending, approved or declined; cnv_status2 carries the event (created, approved, declined, reversed). Every postback counts a conversion and the last payout replaces the previous one (leave Upsell off). In Binom v2, start from the E-commerce status scheme: pending = lead, approved = sale, declined = reject, and set the payout to zero for declined.
- Affiliate networks > Create. Name it Clickwise.
- Offer URL parameter: sub_id={clickid}.
- Use your Binom domain in the postback above.
- Binom v2: attach a status scheme (pending, approved, declined) to the campaign.
- Add each Clickwise program as an offer under this network: the Clickwise link plus ?sub_id={clickid}.
Binom documentation: Postback URL · Status schemes (v2)
Keitaro
Offer URL (your Clickwise link with Keitaro's click ID token {subid}):
https://partners.clickwise.net/dl/YOUR_LINK_ID/?sub_id={subid}
Postback URL (Clickwise portal, Settings > Postback, method GET). Replace YOUR_KEITARO_DOMAIN and YOUR_POSTBACK_KEY with your own:
https://YOUR_KEITARO_DOMAIN/YOUR_POSTBACK_KEY/postback?subid={subid}&payout={commission}¤cy={currency}&tid={transaction_id}&status={status}&lead_status=pending&sale_status=approved&rejected_status=declined
| Field | Keitaro parameter | Clickwise macro |
|---|---|---|
| Tracker's click ID | subid | {subid} |
| Payout | payout | {commission} |
| Currency | currency | {currency} |
| Transaction ID | tid | {transaction_id} |
| Status | status | {status} |
Statuses. status carries pending, approved or declined; lead_status, sale_status and rejected_status teach Keitaro that these mean lead, sale and rejected. A later postback for the same subid and tid overwrites the conversion, so an approval or a reversal updates the same sale.
- Affiliate networks > Create (custom). Name it Clickwise.
- Offer parameters: &sub_id={subid}, or end each offer URL with ?sub_id={subid} yourself.
- Put your Keitaro domain and postback key in the postback above.
- Add each Clickwise program as an offer under this network.
Keitaro documentation: Affiliate networks · Postback
BeMob
Offer URL (your Clickwise link with BeMob's click ID token {clickId}):
https://partners.clickwise.net/dl/YOUR_LINK_ID/?sub_id={clickId}
Postback URL (Clickwise portal, Settings > Postback, method GET). Replace YOUR_BEMOB_ID.bemobtrk.com with your own:
https://YOUR_BEMOB_ID.bemobtrk.com/postback?cid={subid}&payout={commission}&txid={transaction_id}&status={status}
| Field | BeMob parameter | Clickwise macro |
|---|---|---|
| Tracker's click ID | cid | {subid} |
| Payout | payout | {commission} |
| Transaction ID | txid | {transaction_id} |
| Status | status | {status} |
Statuses. status carries pending, approved or declined. Turn on postback statuses for the network and match the values approved, pending and declined, with pending as the default status. BeMob's public docs show no currency parameter in the postback: set the offer currency in BeMob.
- Affiliate networks: create a custom network named Clickwise.
- Append the click ID to offer URLs with the parameter sub_id (BeMob fills it with {clickId}).
- Turn on postback statuses: approved, pending, declined.
- Use your BeMob tracking domain in the postback above.
- Add each Clickwise program as an offer: the Clickwise link plus ?sub_id={clickId}.
BeMob documentation: Create custom affiliate network · Postback statuses
ClickMagick
Offer URL (your Clickwise link with ClickMagick's click ID token [cmc_vid]):
https://partners.clickwise.net/dl/YOUR_LINK_ID/?sub_id=[cmc_vid]
Postback URL (Clickwise portal, Settings > Postback, method GET). Replace YOUR_CLICKMAGICK_USER_ID with your own:
https://www.clkmg.com/api/s/post/?uid=YOUR_CLICKMAGICK_USER_ID&s1={subid}&amt={commission}&ref={transaction_id}&cmc_currency={currency}
| Field | ClickMagick parameter | Clickwise macro |
|---|---|---|
| Tracker's click ID | s1 | {subid} |
| Payout | amt | {commission} |
| Currency | cmc_currency | {currency} |
| Transaction ID | ref | {transaction_id} |
Statuses. No status parameter. The first postback records the sale; ClickMagick ignores a repeat with the same ref and amount, so later events do not count it twice. A declined or reversed sale is not refunded from this postback (a refund needs a negative amount). Mark it refunded in the ClickMagick sales log.
- Use the token [cmc_vid] in your Clickwise links: the Clickwise link plus ?sub_id=[cmc_vid].
- Copy your user ID from the ClickMagick Postback URL tool into the postback above.
ClickMagick documentation: Tracking sales with an affiliate network · Affiliate sales via postback URLs
Before you go live
- The postback URL must be
httpson the standard port with a public hostname. A self-hosted Binom or Keitaro needs a valid certificate on its domain. - The portal's Send test button sends the sub-ID
test-subid: it proves Clickwise reaches your tracker, not that a conversion is attributed, because your tracker has no click with that ID. - To check the link, open your own tracker link once and look the click up by your tracker's click ID:
GET /api/v1/publisher/clicks/?sub_id=<tracker click ID>. - Every delivery is signed (
X-CW-Signature) and failed deliveries are retried; see the postback reference.