Adjust

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

Setting up ironSource

  1. Log into your Adjust account
  2. Select your app and click on the app options button

Adjust app setup

  1. Select Partner Setup > Add Partners

Adjust Partner Setup

  1. Select ironSource from the list of partners and click the add icon (+)
  2. Enter your advertiser ID and password from your ironSource account
  3. Click Save

Adjust Partner setup with advertiser ID and password

Attribution settings

  1. Select the app and click on the app options button
  2. Select All Settings
  3. Select Attribution

Adjust setup 4

  1. Turn Device Matching and Probabilistic Matching ON for both Click based and Impression based attribution

Adjust 5

  1. Choose your desired lookback window for each attribution type

Adjust setup 6

Setting up attribution links

  1. Select the app and click on the app options button
  2. Select Tracker URLs

Adjust setup 8

  1. Select New Trackers and enter a tracker name
  2. Under Network, select ironSource
  3. Click on Quick Create to use ironSource’s templates or Customize to edit the links

Adjust setup 9

  1. Save and copy the links to the ironSource platform

Postback settings

Basic settings

  1. Select an app and click on the app options button
  2. Select Partner Setup > ironSource
  3. Turn OFF the Attributed Only toggle
  4. Turn ON Session Forwarding to send to ironSource appOpen events (recommended for suppression purposes)
  5. Turn on the In-App Revenue Forwarding toggle to send to ironSource information about in-app purchases 
  6. Turn on the Parameter Forwarding toggle to send to ironSource custom data 

Adjust setup 11

Advanced settings

To forward additional in-app events, make sure the events are mapped correctly within the SDK by following these steps:

  1. Select the app and click on the app options button
  2. Select Partner Setup > ironSource > Event Linking
  3. Find the SDK event you’d like to send and enter ironSource’s corresponding event from the following list:
    • levelAchieved
    • tutorialCompleted
    • inAppRegistered
    • Custom1
    • Custom2
    • Custom3
    • Custom4
    • Custom5
    • Custom6
  1. Select OK and save

If you’re sharing levelAchieved, inAppPurchase, appRegistered, or tutorialCompleted events, you’ll need to share the parameters for those events in the Parameter Mapping page. Once you have mapped the events and parameters in Adjust’s SDK, follow these steps:

  1. Select the app and click on the app options button
  2. Select Partner Setup > ironSource
  3. Turn on Parameter Forwarding
  4. Select Partner Parameter Mapping
  5. Enter the SDK parameter name in the From App field, and ironSource’s corresponding parameter in the To ironSource field

The following parameter names are accepted in the To ironSource field:

Parameter name Details Mandatory/optional
level The level number that the user achieved (e.g. 1, 2, 3…) Mandatory for levelAchieved
format The registration format used in a registration event (e.g. Facebook, email, Twitter, etc.) Optional for appRegistered
tutorialCompleted Whether the tutorial was completed in a tutorialCompleted event (true/false) Optional for appRegistered
amount The amount of money that the user spent on the purchase (e.g. 3.99) Mandatory for inAppPurchase
currency Currency of the purchase (e.g. USD) Mandatory for inAppPurchase
numOfItems Number of items purchased (e.g. 3) Optional for inAppPurchase
itemName Name or ID of the item purchased (e.g. coins) Optional for inAppPurchase