The Appsflyer Audience Integration allows Appsflyer to sync audience files (lists of IDFA/GAID identifiers) directly to Swaarm via API - removing the need to manually upload CSV files for each retargeting campaign.
Appsflyer calls the following Swaarm endpoints to manage audience files:
Endpoint | What it does |
Syncs audience data | |
Creates a new audience file | |
Validates the audience file |
Setup
Step 1 - Add your Appsflyer Audience API key in Swaarm
Go to Organization → Settings → Connections → Appsflyer → Audience
Enter the API key - contact Appsflyer to obtain the API key for your partner account
Click Save
Step 2 - Find the offer's Audience API key
Each offer has its own Audience API key that the advertiser uses to link their Appsflyer audience to the correct offer in Swaarm.
Go to the Offer Details page
Click Show More (the expand arrows)
Copy the Appsflyer Audience API key
⚠️ The Audience API key is offer-specific - it cannot be universal. You need to share a separate key with the advertiser for each offer they want to sync audiences to. The advertiser enters this key in their Appsflyer account to select your network as the provider for that offer.
Step 3 - Test the integration
Before going live, test the integration to confirm Appsflyer can successfully reach Swaarm's endpoints:
Use a test offer in Swaarm (e.g. Offer id 2) and copy its Audience API key from Show More
Share the following with the Appsflyer team:
The three integration endpoints above (with your domain)
The test API key from the test offer
A preferred email address to receive the
PARTNER_PULL_KEYfrom Appsflyer
Appsflyer will run a test sync using the provided details
If the test is successful, the audience file will appear in Offer → Retargeting tab of the test offer
ℹ️ Once Appsflyer confirms the test is successful, they will send a PARTNER_PULL_KEY to the email address you provided. Keep this for reference.
Step 4 - Enable the Invalid User Identifier optimization rule in Swaarm
Configure a click optimization rule so that only users on the retargeting list can pass through. Without this rule, the retargeting list has no effect.
Go to Automation → Optimizations
Create a rule for Click: Invalid User Identifier
Scope it to the specific offer — do not set this rule globally
⚠️ Do not set this rule globally - it will block all traffic on any offer that does not have a retargeting list configured. Instead select specific offer/advertiser this rule should be applied to.