Overview
Every advertiser onboarding follows the same core steps:
Step 1 - Create the advertiser in Swaarm
Step 2 - Configure tracking (direct postback or MMP)
Step 3 - Share your Swaarm postback URL with the advertiser
Step 4 - Test the integration end-to-end
Step 5 - Go live
There are two independent choices to make when onboarding an advertiser:
How offers get into Swaarm - pulled automatically via API, or created manually
How conversions come back to Swaarm - via the advertiser's tracker postback, or via an MMP postbacks
Mix and match based on what the advertiser supports. Start with Step 1 regardless of which combination applies.
Step 1 - Create the advertiser
Go to Advertisers → +Create and fill in the required fields.
FIELD | NOTES | REQUIRED? |
Name | Internal name - visible only to your team | YES |
Account Type | Choose account type | YES |
Status | Set to Active before going live | YES |
Account Manager | Assign the AM responsible for this advertiser | YES |
Sales Manager | Assign the SM responsible for this advertiser | NO |
Country | Select Advertiser's entity origin | YES |
Address | Add entity address | NO |
Phone | Add phone | NO |
Tax Number | Add tax number | NO |
Tags | Use tags to group Advertisers | NO |
Migration ID | Added automatically, if the Advertiser was imported via migration | YES (if migrated) |
Note | Add internal note | NO |
Step 2 - Choose how offers get into Swaarm
Option A - Pull offers via API (network adapter)
Use this when the advertiser's tracker supports an API integration with Swaarm. Swaarm will automatically import their available offers.
Check if an adapter exists
Go to Integration → Networks and search for the tracker or network by name in Adapter field:
Don't see it? See how to request a new network adapter →
2. Configure the adapter:
Select the network and enter the credentials provided by the advertiser (typically an API key, in some cases domain, or your affiliate ID). Refer to the Specific adapter guide → for the exact fields required.
ℹ️ Once credentials are saved and sync enabled, Swaarm will automatically pull available offers. Go to Offers Approval and confirm they've been imported within a few minutes.
Option B - Create offers manually
Use this when the advertiser doesn't support API integration, or when you need to set up a specific offer that isn't available via the feed.
Go to Offers → Create and configure the following:
FIELD | NOTES | REQUIRED? |
Advertiser | Select Advertiser from the list | YES |
Tracking URL | Add tracking URL | YES |
Platform | Select iOS, Android, or Web | YES |
Countries | Select 1 or more countries | YES |
Events & payouts | Add events and payouts | NO |
Budget | Add caps | NO |
Status | Set to Active before going live | YES |
ℹ️ Adding Swaarm macros to the tracking URL: The tracking URL must include Swaarm's click ID macro, so conversions can be matched back to clicks. See the full list of click macros for the advertiser tracking link →
Step 3 - Choose how conversions come back to Swaarm
Option A - Tracker postback
Use this when the advertiser fires conversion postbacks directly from their tracker platform. Share the following postback URL with the advertiser and ask them to fire it on every conversion event:
https://track.{yourdomain}.swaarm-clients.com/postback?click_id={click_id}&event_id={event_id}Parameter | What to tell the advertiser | REQUIRED? |
click_id | Must pass the Swaarm click ID value from the tracking link. This is how Swaarm matches conversions to clicks. | YES |
event_id | The ID of the conversion event (e.g. install, purchase). Must match the event IDs configured in the offer. | YES |
payout | Dynamic payout amount, if applicable. | NO |
Option B - MMP integration
Use this when the advertiser uses a Mobile Measurement Partner (Appsflyer, Adjust, Kochava, etc.) to track their app installs and events. Instead of the advertiser configuring a postback manually, you set up the postback URL inside the MMP platform - the MMP then forwards conversion data to Swaarm automatically.
Step 4 - Test the integration
Always test end-to-end before connecting real publisher traffic.
Ask the advertiser to share a link to a test offer (or use Test Offer ID 2)
Set this as the tracking URL if creating the offer manually
Connect a test publisher (Test Pub ID 2)
Generate the publisher tracking link and share it with the advertiser
Ask the advertiser to fire a test conversion using that link
Go to Reports → Conversion Report and confirm the conversion appears
✅ Integration confirmed when: the test conversion appears in the Conversion Report with the correct event ID and status 'Approved'.
Before going live
Advertiser status is set to Active
Offer status is set to Active
Postback URL confirmed by the advertiser (or MMP is configured)
Click ID parameter is correctly mapped
Event ID mapping is confirmed
Test conversion appears in the Conversion Report