Skip to main content

Set up an offer

An offer is the campaign unit in Swaarm - it ties together an advertiser, a tracking URL, targeting, payouts, and the publishers approved to run it. This article walks you through the full setup flow from creation to connecting a publisher.

Updated today

ℹ️ Before you start

Make sure the advertiser is already created and their postback integration is tested. Create and configure an advertiser →


Step 1 - Create the offer (General tab)

Go to Offers → Create+ in the top right corner. The General tab is the only tab visible until you save - the remaining tabs appear once the required fields are filled in and saved.

Fill in the required fields:

FIELD

NOTES

Advertiser

Select Advertiser from the list

Tracking URL

Add tracking URL

Platform

Select iOS, Android, or Web

Countries

Select 1 or more countries

Status

Set to Active before going live

⚠️ 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 →

Click Save. The remaining tabs will now appear.

ℹ️ For a detailed breakdown of every field see the Offer settings reference →


Step 2 - Configure events

Go to the Events tab and create at least one conversion event. For CPI offers this is typically an install. For CPA offers, add one or more post-install events.


Step 3 - Set payouts

Go to the Payouts tab and define your revenue and costs.

Field

Notes

WeGet (Revenue)

Amount you receive from the advertiser per conversion

TheyGet (Cost)

Amount you pay to the publisher per conversion

Margin

Set a % and Swaarm calculates TheyGet automatically

ℹ️ Need different rates per country or per publisher?


Step 4 - Set a budget (optional)

Go to the Budgets tab to cap conversions, clicks, impressions, or revenue on this offer. Choose between a soft cap or a hard cap.


Step 5 - Configure targeting (optional)

Basic GEO and platform targeting is set in the General tab. For more granular control - by state, city, OS version, device type, or carrier — go to the Targeting tab.


Step 6 - Approve a publisher

Go to the Publishers tab on the offer and click Add Publisher. Publishers can only send traffic once approved, unless the offer visibility is public.

When approving you can also set:

  • Publisher-specific payout — overrides the default for this publisher

  • Publisher-specific cap — limits conversions from this publisher


Step 7 - Generate the publisher tracking link

Once the publisher is approved, go to Offers → [Offer name] → Publishers tab, generate the link, and share it with the publisher.


Before going live

  • Offer status is set to Active

  • Tracking URL includes Swaarm macros

  • Payouts are set

  • Publisher is approved on the offer

Did this answer your question?