AppsFlyer

This guide will help you configure ironSource as an integrated partner with AppsFlyer.

Setting up ironSource

1. Log into your AppsFlyer account
2. Select the app you want to edit
3. On the left sidebar, select Configuration > Integrated Partners
4. Search ‘ironSource’ and click on the logo to open the configuration window

5. Go to the Active integrations tab, and turn on the Activate Partner toggle
6. Enter your advertiser ID and password, taken from the ironSource platform
7. Set the ‘Install view-through attribution’ section to ON
8. Set the ‘Re-engagement view-through attribution’ section to OFF
   

Setting up postbacks

Default postbacks

For install events, select the sending option Events attributed to any partner or organic to share all install events with ironSource, for device suppression purposes.

Under in-app event settings, re-enter your ironSource advertiser ID and password.

In-app event postbacks 

1. Turn on the In-app event postbacks toggle
2. Click on Add Event to map the in-app events you would like to send
3. In the ‘SDK event name’ field, select the SDK event you would like to report
4. In the ‘Partner event identifier’ field, select the corresponding ironSource event from the following list:
   • levelAchieved
   • tutorialCompleted
   • inAppRegistered
   • custom1
   • custom2
   • custom3
   • custom4
   • custom5
   • custom6
5. Select your sending option: Only events attributed to this partner for events attributed to ironSource, or Events attributed to any partner or organic to share all in-app events with ironSource
6. Enable the values and revenue to be sent for each event

To integrate your conversion value map with ironSource, make sure all in-app events mapped by conversion values are also shared with ironSource. If you’re using an ad revenue CV map, make sure you map the “af_skad_revenue” in-app event to custom10.

Revenue postbacks

1. Click on Add Event to map the revenue events you would like to send
2. In the SDK event name field, select the following SDK events:
   • af_purchase for in-app purchases
   • af_ad_revenue for user generated ad revenue events
3. In the ‘Partner event identifier’ field, select the corresponding ironSource event:
   • inAppPurchase for in-app purchases
   • adRevenue for user generated ad revenue events
4. Select your sending option:
   • Select Events attributed to any partner or organic to share all in-app events with ironSource
   • Select Only events attributed to this partner for events attributed to ironSource
5. Enable the values & revenue to be sent for each event

Attribution link settings

ironSource is integrated with AppsFlyer and the basic links are already set. 

Here’s how to add more parameters to the links:

1. Go the Attribution link tab
2. Click Add parameter
3. Set the Retargeting settings section to OFF
4. Set the click-through attribution and view-through attribution windows (the default lookback window is 7 days for clicks and 1 day for impressions)
5. Copy the attribution links and use them in your ironSource campaigns

API setup

Cost API

1. Set the ‘Get cost data’ section to ON
2. In another tab, log in to your ironSource account:
   1. Select My Account
   2. Find your username under the User Info tab and your secret key under the Reporting API tab
3. Click on the ‘Test Connection’ button to make sure that the integration is working properly.
4. Once the message ‘API connection verified’ displays, click Save Cost

Ad Revenue API (for ironSource mediation partners)

1. Set the Get Ad Revenue Data section to ON
2. Select Attribute Revenue > User level
3. Enter your ironSource API credentials as they appear on the ironSource platform

4. Click Test Connection to make sure the integration is working properly
5. Once the message ‘API connection verified’ appears, click Save Ad revenue

ironSource admin permissions

Granting permissions to an ironSource admin user can be helpful if you experience any issues with attribution and account settings. This will allow ironSource’s support team to view your partner configuration settings and quickly resolve possible setup issues.

Here’s how to add an ironSource admin user:

1. Turn on the Ad network permissions toggle
2. Turn on the Configure integration and Configure in-app event postbacks toggles