Setting up level achieved events

Set up level achieved event tracking to monitor user progress and enhance in-app engagement strategies.

Read time 4 minutes

This article provides step-by-step instructions for setting up events by level with each attribution provider. Following these guidelines will help ensure your integration and data reporting work correctly, and will prevent completions from being missed.

Adjust
Adjust

  1. From the Adjust platform, select the right app and click on the app options button.
  2. Select Partner Setup > ironSource.
  3. Turn OFF the Attributed Only toggle.
  4. Turn ON Parameter Forwarding to send custom data to ironSource.

To forward additional level-based events, make sure the events are mapped correctly in the SDK.

  1. Click oEvent Linking and find the SDK event you'd like to send.
  2. Enter ironSource’s corresponding levelAchieved event.
  3. Select OK and save.
  4. Click Partner Parameter Mapping.
  5. Enter the SDK parameter name in the From App field.
  6. Enter ironSource’s ‘level’ parameter in the To ironSource field (the level parameter reports the level number that was achieved by the user).
  7. Select OK and save.

AppsFlyer
AppsFlyer

Setting up in-app events
Setting up in-app events

  1. In the AppsFlyer dashboard, select the app you want to edit.
  2. From the left-side bar, select Configuration > Integrated Partners.
  3. Search "ironSource" and click on the logo to open the configuration window.
  4. Click on the Integration tab and scroll down to the in-app event settings tab.
  5. Re-enter your ironSource advertiser ID and password.
  6. Set the In-app event postbacks toggle to ON.

Adding level events
Adding level events

  1. Click Add Event to map the in-app events you would like to send
  2. In the SDK event name field, select

If this option is missing, contact your AppsFlyer point of contact to map the event

  1. In the Partner event identifier field, select levelAchieved from the dropdown options.
  2. Select your sending option:
    • Only events attributed to this partner for events attributed to ironSource
    • Events attributed to any partner or organic to share all in-app events with ironSource
  3. Enable values and revenue for each event to be sent.
  4. Click Save Integration.

Branch
Branch

  1. Log into your Branch account.
  2. Under ironSource’s partner management section, click on Postback Config > Add New Postback.
  3. Select the levelAchieved event, and the postback URL should populate automatically.
  4. Check the Enable box to activate the event for sending.
  5. Check the All Events box to send non-attributed traffic to ironSource (for suppression purposes).
  6. Click Save.

Kochava
Kochava

  1. Log into your Kochava account
  2. From the left-side nav bar, select Apps & Assets > Partner Configuration.
  3. Under Media Partner, select ironSource.
  4. Under Custom Postback, select the "Level Complete" event created for this postback.
  5. Set the Event Status as Active.
  6. Make sure the event matching is mapped to Level Complete.
  7. Select Delivery Delay > Realtime Delivery.
  8. Select Retry Attempts > 3 Attempts.
  9. Select macros, and make sure that the {level\_number} macro exists.
  10. Click Save.

Singular
Singular

  1. Log into your Singular account.
  2. Go to left-side menu and click Attribution > Partner Configuration.
  3. Search for "ironSource" and select it from the list.
  4. In the Configuration window, select the app and platform (site) you would like to configure.
  5. Go to the App-specific Configuration section.
  6. Set the Send in-app Events to ironSource to All (for suppression purposes).
  7. Choose the events you’d like to send to ironSource:
    • In-app (SDK) event name - The name of the event as it is sent from your app through the Singular SDK integration
    • Event Name (the event name as recognized by ironSource) - levelAchieved
    • Set the Lookback to None
    • Check the Send Revenue box
  8. Save changes.

Tenjin
Tenjin

  1. Log into your Tenjin account.
  2. Go to Configure > Apps.
  3. Select the relevant app.
  4. Click + New Callback.
  5. Select ironSource from the list of partners.
  6. Choose ironSource Level Achieved event.
  7. Set the name of the callback (you can keep the default).
  8. Confirm that the Active box is checked (should be enabled by default).
  9. Add your ironSource advertiser ID and password.
  10. Save.