AppsFlyer Import Stats

How to import and view your AppsFlyer agency account stats into Swaarm.

Updated over a week ago

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:

  1. All imported stats will count towards your Usage and will be therefore billed.

  2. If you do not set up everything mentioned below (Offer, Publisher, Targeting etc.) then the data will not be imported.

  3. There is no undo button after you start importing data, so ensure everything is set up correctly.


AppsFlyer Account Configuration

  1. Go to Organization > Settings in Swaarm

  2. Click on Connections Tab and then Stats Import

  3. Click Add Account

  4. Add a Name for your AppsFlyer Agency account

  5. Copy & paste your AppsFlyer Agency account API token

    1. 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

  1. Create a New Offer

    1. Creating a new offer, rather than updating a pre-existing offer, allows for a better and clean import of stats

      1. This helps with filtering and viewing imported data across Swaarm, without impacting or mixing stats of an already existing offer in Swaarm

  2. Configure the correct Country targeting

    1. 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

      1. 📝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

        1. Even though they are the same campaign in your agency account, you still need multiple offers in Swaarm to import stats accurately

  3. Set the correct Leadflow

    1. 📌Recommendation: Enable Private and Requires Approval boxes

      1. This will restrict publishers from directly sending the traffic to an offer without any approval

  4. Create paid Events as it is in AppsFlyer

    1. Check that the Adv Event Type ID is the same as the AppsFlyer Event Name

  5. Set Offer Status to Pending for now

    1. ⚠️Note: Once your publishers are approved to the offer, then set Offer Status to Active to start importing stats

  6. Click on AppsFlyer Tab

  7. Click Add Configuration

  8. Input the App ID

    1. This App ID helps us map the AppsFlyer stats to sync to this offer

  9. Select AppsFlyer Account

    1. All of your AppsFlyer's accounts that are configured in Swaarm Organization Settings will be shown in the Accounts options

  10. Choose the Import Offset

    1. The import offset determines the latest date till which the data is synced from AppsFlyer

      1. Our recommendation and the default setting for import offset is 2 days

        1. 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

      2. Maximum offset that can be set is 30 days

      3. 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

  11. Click Save

⚠️Remember

  1. Traffic will be imported based on the offer's country and OS configuration.

    1. For Example: If you choose Android & Germany, only traffic from Androids in Germany will be added to the offer.

  2. Once your publishers are approved on the offer, then set Offer Status to Active to start importing stats

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.

  1. Go to the Publisher Details page

  2. Click Edit in the top right

  3. Click on the AppsFlyer Tab

  4. Input the Media Source of the publisher that is used by them in AppsFlyer link while sending traffic to the AppsFlyer agency account

    1. ✏️Note: You can find the Media Source name in AppsFlyer Partner Reports

    2. You can add multiple Media Sources

      1. It will attribute the traffic from all those media sources to this publisher

  5. 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.

Did this answer your question?