If you buy traffic on PropellerAds and send it to your offers through a Swaarm publisher, Swaarm can import what you spend there. Once a day it reads the spend of your PropellerAds campaigns and books it as that publisher's cost on the offer each campaign promotes. Your reports then show spend, revenue and profit side by side, down to the PropellerAds zone.
How it works
You create a publisher in Swaarm for your PropellerAds traffic (or use an existing one) and add your PropellerAds API token to it.
You map each PropellerAds campaign to the Swaarm offer it sends traffic to.
Every day after 06:00 UTC, Swaarm reads the spend of the mapped campaigns for the last three full days (UTC), per campaign, zone and country.
The spend is booked as the publisher's cost (payout) on the mapped offer, on a private event called Cost. It adds no revenue and no conversions.
ℹ️ Corrections are picked up automatically: Swaarm re-reads the last three days on every import and books only the difference to what it already booked. If PropellerAds corrects a day, Swaarm follows. Nothing is ever booked twice, even if you run the import by hand several times.
Before you start
A PropellerAds API token. In your PropellerAds account, open your Profile and copy the API token. The token gives read access to your campaigns and statistics.
The zone in the tracking link. PropellerAds reports spend per zone, and Swaarm books each zone's spend as the publisher's Sub ID. To see conversions and cost for the same zone, pass PropellerAds' zone ID macro in the
pub_sub_idparameter of the Swaarm tracking link you use in the campaign. See PropellerAds' list of tracking macros for the exact macro.
Set up the cost import
Go to Publishers and open the publisher that carries your PropellerAds traffic.
Open Management > Cost Import > PropellerAds..
Paste your PropellerAds API token and click Save. Swaarm checks the token with PropellerAds right away and tells you if it is rejected.
Click Map campaign. Pick a PropellerAds campaign (the list is loaded from your PropellerAds account) and the Swaarm offer it promotes. Repeat for every campaign you want to import.
Click Save.
The next daily import picks up the mapped campaigns. To import right away, click Import now. A summary shows the days imported, the spend PropellerAds reported and what was booked in this run.
Where you see the cost
In your reports the imported spend shows as the publisher's payout (cost) on the mapped offer, on the event Cost.
ℹ️ Group by Sub ID to see it per PropellerAds zone, or by country.
Each day's cost is booked at 12:00 UTC of that day.
The Cost event is private: publishers never see it in their portal or postbacks.
Publisher payments: imported cost counts towards the publisher's payout like any other cost. PropellerAds bills you directly, so you will usually not create Swaarm payments for this publisher.
Status, pausing and changes
Status shows Connected, or Error with the reason (for example an expired token). Last import shows when the cost was last imported.
Replace the token: paste the new one and save. Leave the field empty to keep the stored token. Swaarm never shows a stored token again.
Pause: turn off Enabled. Cost that was already imported stays.
Re-map a campaign to another offer: cost imported earlier stays on the old offer; new spend goes to the new one.
Delete removes the token and the mappings. Cost that was already imported stays in your reports.
Good to know
Spend is imported in USD, the currency of PropellerAds advertiser accounts.
Days are UTC days. Spend for today appears the next day, once the day is complete.
Only spend of mapped campaigns is imported. A day older than three days is not re-read, so a correction PropellerAds makes after that is not picked up.



