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 side bar, select Configuration > Integrated Partners
  4. Search ‘ironSource’ and click on the logo to open the configuration window

AppsFlyer setup

  1. Go to the Active integrations tab, and turn on the Activate Partner toggle
  2. Enter your advertiser ID and password, taken from the ironSource platform
  3. Set the ‘Install view-through attribution’ section to OFF
  4. 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.

AppsFlyer setup 6

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.

AppsFlyer setup 7

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

AppsFlyer Attribution Link

API setup

Cost API

  1. Set the ‘Get cost data’ section to ON
  2. Add the API Credentials with your ironSource username, secret key, and bundle ID
  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

Get cost data page on AppsFlyer

Note:

These credentials are different from those used in the previous steps. Follow these steps to retrieve your secret key:

  1. Log into your ironSource account
  2. Click on your avatar in the top right corner and select My Account
  3. Find your username under the ‘User info’ tab and your secret key under the Reporting API tab

Reporting API tab

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

Secret key and refresh token

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

Ad revenue tab on AppsFlyer

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

AppsFlyer permissions tab