Many advertisers run their user-acquisition campaigns through an agency. With agency partners, the agency connects its own ad accounts (Meta, Google Ads, TikTok and AppLovin) to Swaarm, maps its campaigns to your offers, and Swaarm imports the campaign spend every hour. You see the same spend figures the agency sees, right next to your attributed installs and events.
For advertisers: how to add your agency as a partner and what you see afterwards.
For agencies: how to connect ad accounts, map campaigns to offers and set up event forwarding in the partner portal.
ℹ️ Commission: you pay your agency's commission directly, outside Swaarm. Swaarm imports and shows the ad spend only; it does not track or calculate the agency's fee.
How it works
The advertiser adds the agency as a partner with the account type Agency and gives it access to the offers it promotes.
The agency signs in to the partner portal and connects its ad accounts under Ad accounts.
The agency maps each campaign to the offer it promotes.
Every hour, Swaarm imports the spend of the mapped campaigns and books it on the mapped offer, under the agency partner.
Optionally, the agency sends the conversions it drove back to its own Meta, Google Ads, TikTok or AppLovin account, so its campaigns can optimise on them.
For advertisers
Add your agency as a partner
Go to Partners and create a new partner.
Enter the agency's Name and the other required details.
Under Account Type, select Agency.
Save the partner.
Give the agency access to the offers it runs campaigns for. The agency can only map campaigns to offers it has access to.
Invite the agency's users to the partner portal, as you would for any other partner.
ℹ️ Don't see "Agency" in the Account Type list? The Agency type is enabled per platform by Swaarm. Contact your Swaarm account manager or support and we'll switch it on for you.
What you see
What | Details |
Spend in your reports | Imported spend appears as Cost for the agency partner on the mapped offer, so you can compare it with installs, events and revenue in the same report. It is converted to your platform currency. |
Full transparency | You and the agency see the same spend figures. Nothing is marked up or hidden. |
No partner payouts | An agency's imported spend is money you pay to the ad networks, not money owed to the agency. Agency partners are therefore excluded from partner payments in Swaarm. |
For agencies: the partner portal
Once the advertiser has set you up as an Agency partner, sign in to their partner portal. You'll find a menu item called Ad accounts. It is only shown to agency partners.
The Ad accounts page lists every account you have connected:
Column | What it shows |
Account | The account name and its ID on the network. |
Network | Meta, Google Ads, TikTok or AppLovin. |
Currency | The account's currency. |
Mapped campaigns | How many of the account's campaigns are mapped to an offer. |
Status | Connected, or Needs reconnect with the reason the last import failed. |
Last import | When spend was last imported successfully. This timestamp is refreshed every few hours, even though spend is imported every hour. |
Connect an ad account
Go to Ad accounts and click Connect ad account.
Pick a network card. Cards marked Sign in connect through the network's own login. Cards marked API keys connect with keys you paste in.
Follow the steps for your network below.
Meta
Select Meta and click Continue to sign in.
Log in with the Meta account that manages your ad accounts and approve the access.
Every ad account that login can reach is connected. That's fine: only the campaigns you map to an offer are imported.
TikTok
Select TikTok and click Continue to sign in.
Log in with TikTok for Business and pick the advertiser accounts to share.
Every advertiser account you share is connected. Only the campaigns you map are imported.
Google Ads
Select Google Ads.
Enter your Google Ads account ID: the account you run the campaigns from, for example
123-456-7890. You can enter several IDs.Click Continue to sign in and log in with a Google user that can access those accounts.
Only the account IDs you entered are connected. Enter the client account that runs the campaigns, not a manager (MCC) account. If your Google user reaches the account through a manager account, that works too.
AppLovin (web campaigns)
AppLovin connects with API keys, which you find in AppLovin Ads Manager under Account › Keys.
Select AppLovin.
Fill in the fields below.
Click Connect. Swaarm checks the keys with AppLovin straight away.
Field | Description |
Account ID (required) | In AppLovin under Account › Go to settings: the number after your account name. |
Report Key (required) | Used to read your campaign spend. |
Campaign Management API Key (optional) | Lets Swaarm list all your campaigns with their status. |
Account Name (optional) | How the account is shown in Swaarm. Defaults to "AppLovin" plus the account ID. |
ℹ️ An ad account can belong to only one partner on a platform. If another partner already connected one of your accounts, it is skipped, and the confirmation message tells you how many accounts were connected and how many were skipped.
Map campaigns to offers
Nothing is imported until you map campaigns. Each campaign is mapped to the one offer it promotes. An offer can have many campaigns.
On the Ad accounts page, click Map campaigns next to the account.
For each campaign, choose the offer in the Offer column. The mapping is saved as soon as you pick it.
To remove a mapping, clear the offer.
Use the search box (name or campaign ID) and the Unmapped only switch to find campaigns quickly. An active campaign that isn't mapped yet is highlighted with "Active, but not mapped yet: its spend is not imported."
ℹ️ Tip: pick the right offer from the start. Spend that was already imported stays on the offer it was imported to. Changing the mapping later does not move it.
How spend is imported
Spend of your mapped campaigns is imported every hour.
Each run re-reads the last few days, so today's spend keeps catching up and later corrections by the network are picked up. When you map a campaign, its spend from the last few days is imported too. Older spend is not.
In the partner portal, the spend shows as Total Spend on your dashboard and offers. The advertiser sees the same amounts as Cost in their reports.
Set up event forwarding (optional)
To let your campaigns optimise on the conversions you drove, set up event forwarding per offer. Open the offer in the partner portal and go to the tab for your network: Meta, Google, TikTok or AppLovin. From the Map campaigns page you can jump there with the Event setup for this offer link under a mapped campaign.
Every tab shows a tracking link for the network. Use it as the website URL of your ads: it carries the network's URL parameters and click ID, which conversions are matched on. Then map the offer's events to the network's events.
⚠️ Only events you map are sent.
Tab | What you enter |
Meta | Dataset (Pixel) ID and Conversions API Access Token (generated for the dataset under Events Manager › Settings › Conversions API). Map each Offer Event to a Meta Event: a standard event, or a custom event name you type. |
Choose the connected Google Ads account, then map each Offer Event to a Conversion Action. Use New Conversion Action to create one in your account. The switch EEA, UK and Swiss users consented to ad data sharing tells Google whether those users gave consent. Leave it off unless you have that consent. This tab needs a Google Ads account connected under Ad accounts. | |
TikTok | Events API Access Token (generated in TikTok Events Manager for your web pixel) and Pixel ID (pick a pixel of your connected accounts, or type its code). Map each Offer Event to a TikTok Event. Fire Event sends one real event, which TikTok needs before it treats a pixel as active. |
AppLovin | Event Key and Conversion API Key (both under Account › Keys in AppLovin Ads Manager). Map each Offer Event to an AppLovin Event. |
Tokens and keys are stored securely and are never shown again after saving. Enter a new one only to replace it. Remove Settings stops sending conversions for that offer.
Reconnect an account
If an import fails, for example because a login expired or access was revoked, the account's status changes to Needs reconnect and the reason is shown underneath. Spend for that account is not imported until you fix it.
Click Reconnect next to the account. The connect dialog opens with the network already selected.
Sign in again (or enter fresh keys for AppLovin).
Your campaign mappings are kept. The next hourly import catches up on the last few days.
Disconnect an account
Click the disconnect icon next to the account and confirm. The account's campaign mappings are removed and no more spend is imported from it.
ℹ️ Spend that was already imported stays in the reports.
Troubleshooting
Symptom | What to check |
The advertiser can't select "Agency" as the Account Type | The Agency type isn't enabled on the platform yet. Contact your Swaarm account manager or support. |
The agency doesn't see Ad accounts in the menu | The partner's Account Type must be Agency. |
An offer is missing from the offer picker on Map campaigns | The agency needs access to that offer. The advertiser can grant it. |
"Skipped because another partner already connected it" | That ad account is already connected by another partner on this platform. It can belong to one partner only. |
No spend shows up | Check that the campaign is mapped to an offer and that the account status is Connected. Spend is imported hourly, so allow up to an hour after mapping. |
Status shows Needs reconnect | Read the reason under the status and click Reconnect. For AppLovin, copy the keys again from Account › Keys. |
Google: the account ID is rejected | Use the 10-digit ID of the client account that runs the campaigns (for example |
Google tab says "Connect a Google Ads account in Ad accounts to send conversions to it." | Connect the Google Ads account first. The tab then lets you choose it. |