Import AppsFlyer Stats
AppsFlyer has held a significant role in advertising. We know that managing several platforms can be challenging. Swaarm solved the challenge by enabling you to import your data from your AppsFlyer Agency accounts. As well as, displaying combined results of AppsFlyer & Swaarm stats on the dashboard, reports, and more.
Importing these stats allows you to view all of your campaign performances together on one platform, Swaarm. Therefore reducing the need to switch between accounts or manually calculate totals.
⚠️PLEASE NOTE BEFORE:
All imported stats will count towards your Usage and will be therefore billed.
If you do not set up everything mentioned below (Offer, Publisher, Targeting etc.) then the data will not be imported.
There is no undo button after you start importing data, so ensure everything is set up correctly.
AppsFlyer Account Configuration
Go to Organization > Settings in Swaarm
Click on Connections Tab and then Stats Import
Click Add Account
Add a Name for your AppsFlyer Agency account
Copy & paste your AppsFlyer Agency account API token
You can add multiple agency accounts
Now that we have configured the AppsFlyer account in Swaarm, we will set up a new offer to map AppsFlyer stats to.
Offer Mapping
Create a New Offer
Creating a new offer, rather than updating a pre-existing offer, allows for a better and clean import of stats
This helps with filtering and viewing imported data across Swaarm, without impacting or mixing stats of an already existing offer in Swaarm
Configure the correct Country targeting
If you have different payouts per country, you will need to create multiple offers and assign a country and the related payout for each offer
📝For Example: Create an offer A with a payout of $2 for the US and Offer B with a payout of $1.50 for Germany
Even though they are the same campaign in your agency account, you still need multiple offers in Swaarm to import stats accurately
Set the correct Leadflow
📌Recommendation: Enable Private and Requires Approval boxes
This will restrict publishers from directly sending the traffic to an offer without any approval
Create paid Events as it is in AppsFlyer
Check that the Adv Event Type ID is the same as the AppsFlyer Event Name
Set Offer Status to Pending for now
⚠️Note: Once your publishers are approved to the offer, then set Offer Status to Active to start importing stats
Click on AppsFlyer Tab
Click Add Configuration
Input the App ID
This App ID helps us map the AppsFlyer stats to sync to this offer
Select AppsFlyer Account
All of your AppsFlyer's accounts that are configured in Swaarm Organization Settings will be shown in the Accounts options
Choose the Import Offset
The import offset determines the latest date till which the data is synced from AppsFlyer
Our recommendation and the default setting for import offset is 2 days
For example: the latest data that will be available in Swaarm will be from 2 days ago in order to avoid partial data from the previous day
Maximum offset that can be set is 30 days
The data starts importing from the month you are currently in, so if you begin syncing July 5th, it will sync from July 1st to the 30th and nothing from June will sync
Click Save
⚠️Remember
Traffic will be imported based on the offer's country and OS configuration.
For Example: If you choose Android & Germany, only traffic from Androids in Germany will be added to the offer.
Once your publishers are approved on the offer, then set Offer Status to Active to start importing stats
Offers configured for Appsflyer API stats cannot be setup with Budgets and Targeted Payouts
Now that we have configured the offer mapping set up in the platform, we have to map the traffic that comes to the offer to the publisher.
Publisher Mapping
To attribute the stats to the correct Publisher, go to the Publisher Details page to map the Media Source.
💡 Publisher Setup Recommendation
Just like the Offer Mapping, we suggest you create a new publisher dedicated for the AppsFlyer data mapping purpose. Do not add any postback, contacts, etc. to keep things clean.
This helps with filtering and viewing imported data across Swaarm, without impacting or mixing stats of an already existing publisher in Swaarm.
Go to the Publisher Details page
Click Edit in the top right
Click on the AppsFlyer Tab
Input the Media Source of the publisher that is used by them in AppsFlyer link while sending traffic to the AppsFlyer agency account
✏️Note: You can find the Media Source name in AppsFlyer Partner Reports
You can add multiple Media Sources
It will attribute the traffic from all those media sources to this publisher
Approve the Publisher on the mapped offer you are importing stats from
💡 Dynamic PIDs
If you enter the publisher ID as "XYZ*" with a * at the end, then it will consider all PIDs that start with XYZ as a media source and map to the respective publisher.
After Mapping
Once everything above is configured, stats begin to import from AppsFlyer. All the stats including: impressions, clicks, installs and events will be synced to Swaarm for the respective mapped entities. As a result, Swaarm will show the aggregated stats in the entire platform (every stats page i.e. dashboard, management tables, performance charts, etc.) of all the events that were tracked in Swaarm + all the events that were synced from the AppsFlyer accounts.
⚠️ WARNING
If you delete the API token from the settings page, it will remove the AppsFlyer configuration from the offer as well.
Reports
When you look through the conversion reports you will see the conversions as Approved and Passed, but these will not be fired to your publishers. For these conversions, you will see that under "__AppsflyerImport" under the Pub. Sub Sub ID field in order to indicate that they were synced from Appsflyer. You can edit conversions just like a normal offer as well.
For Explorer, you can filter under Pub Sub Sub ID - "__apps". Pub Name and Pub Sub ID will show the media sources you linked from the steps above.
Last Sync
You can see the last sync for your data under the AppsFlyer Tab in Settings next to the Agency API token you connected.
