Import your joined AWIN programmes as offers and receive AWIN transaction notifications as conversions - so stats, payouts, and budgets stay in sync automatically.
⚠️ Before you start:
On AWIN, you are the publisher: you join advertiser programmes and earn a commission when your traffic converts. Swaarm reads those programmes over the AWIN API and tracks conversions from AWIN's transaction notifications.
Setup Checklist
# | What | Where |
1 | Get your AWIN API token and Publisher ID | AWIN dashboard → API credentials |
2 | Add the Awin network and sync | Integrations → Networks |
3 | Set AWIN's transaction notification URL | AWIN advertiser tracking settings |
4 | Approve publishers, review payouts & budgets | Offer management (as usual) |
Step 1 - Add the Awin Network
Navigation path: Integration → Network → +Create
Enter the following:
Parameter | Value |
Api Key | Your AWIN OAuth2 API token (used to read programmes and commission groups) |
Publisher | Your numeric AWIN Publisher ID |
Click Save, then run a sync. Swaarm imports every programme in the joined relationship as an offer - including name, description, logo, tracking link, and country - and creates its events from the programme's commission groups.
ℹ️ The imported tracking link already appends &clickref={id} and &clickref2= so your click ID, publisher id and sub id are passed to AWIN.
{publisher.id}_{publisher.subId}
More about configuring offer fields in the Network setting here.
Step 2 - Point AWIN Transaction Notifications at Swaarm
In your AWIN advertiser / tracking settings, set the transaction notification (server-to-server) URL to:
https://<your-tracking-domain>/integrations/awin/postback
⚠️ Replace <your-tracking-domain> with your tracking domain!
How Offers & Events Are Imported
Each commission group on a programme becomes one event in Swaarm. The event's Adv. EventType ID is set to the AWIN commission group ID - this is the key that links an incoming transaction to the correct event. Don't change it manually.
Commission group type | Event payout |
Fixed ( | Fixed WeGet = the group's |
Percentage ( | Revenue-share event - WeGet is taken from the commission AWIN reports per transaction |
A few things to note:
A programme with any percentage group is flagged as revenue-share. Fixed-group events on the same programme still pay their fixed WeGet — fixed takes priority.
A programme with no commission groups still imports, with a single default event based on its advertised commission range.
How Conversions Are Tracked
For each transaction notification, Swaarm decodes clickRef to recover the original click and offer, then creates one conversion per commission group:
AWIN field | Used for |
| The original click / offer |
Commission group | The event (matched to Adv. EventType ID) |
Commission group | The sale amount = your revenue for that group |
| Currency of the amounts |
On a revenue-share offer, the sale amount is the WeGet - so a percentage event earns exactly the reported commission, and TheyGet follows your margin. Fixed-group events use their stored WeGet. More about revenue share here.
ℹ️ If a group has no commissionAmount, Swaarm falls back to the group's sale amount, then the transaction-level commission - so a missing field never drops the conversion.
⚠️ AWIN notifications fire when a transaction is validated, which can be days after the sale. This is expected behaviour on AWIN's side.
Troubleshooting
1) No offers imported
Check that your Api Key and Publisher ID are correct
Confirm you have joined programmes in AWIN
Check that your AWIN token hasn't expired
2) Offer has no events
That programme exposed no commission groups in the API
Add commission groups on AWIN (or configure events manually) and re-sync
3) No conversions arriving
Confirm the transaction notification URL is set to
…/integrations/awin/postbackon the correct tracking domainConfirm traffic went through the imported offer link, so
clickrefis present
4) Wrong event credited
The transaction's commission group
idmust match the event's Adv. EventType IDRe-sync to realign if commission groups changed on the AWIN side
FAQ
Why does one transaction create several conversions?
A transaction can be split across commission groups (e.g. by product category). Each group is a separate event with its own commission - so each becomes its own conversion in Swaarm.
Do I set payouts manually?
Fixed commission groups import with a fixed WeGet. Percentage groups take WeGet from the commission reported on each transaction. TheyGet is derived from your offer margin (or an explicit TheyGet if set).
Does re-syncing overwrite my edits?
Sync refreshes programme and event data from AWIN. Your configured margins and explicit payouts are preserved.