ironSource

This guide explains how to set up the ironSource UA data grabber in the Magify analytics system.

The grabber enables automated import of user acquisition data such as campaign spend, impressions, clicks, installs, and other key performance metrics directly from your ironSource platform into your analytics pipeline.

Getting Started

1. Navigate to Configurations > Integrations > UA Grabbers in the Magify interface.
2. Find ironSource in the list and click Add Grabber to create a new data source.
3. A configuration form will open.

This form is used to connect Magify to your ironSource platform by providing the required credentials (Secret Key, Refresh Token) and a custom integration name.

Each field in the form is described below.

Name

A descriptive name for the grabber configuration. Helps identify the data source among other integrations.

Recommended format: ironSource Grabber [CompanyName]

Optional field – recommended to fill in for easier navigation.

Organization

Select your organization from the dropdown list.

Secret Key and Refresh Token

The Secret Key and Refresh Token are authorization credentials required for secure access to user acquisition (UA) data via the ironSource (LevelPlay) API.

• Secret Key – a unique key used to identify and authenticate the client making API requests.
• Refresh Token – used to obtain a valid Access Token, which is required for authenticated API requests. Since the Access Token has a limited lifespan, the Refresh Token ensures continued access.

These credentials are required to configure a UA grabber in the Magify system for automated retrieval of advertising campaign metrics, including spend, impressions, and installs.

How to find them:

1. Go to the ironSource Platform.
2. In the bottom-left corner, click the profile icon, then select Account.
3. Navigate to the API tab at the top of the page.
4. Copy the values from the following fields:
   • Secret Key
   • Refresh Token
5. Paste these credentials into the corresponding fields in the Magify interface to complete UA grabber setup.

Is Enabled

Enable this option to start collecting data immediately. If left unchecked, the configuration is saved but inactive.

Saving the Configuration

Once all required fields are filled in, click Save to complete the setup. The enabled grabber will then begin collecting data from ironSource according to the configured schedule.

By default, each grabber is set to load data for one day upon creation.

If you need to collect data for a longer period (e.g., for initial setup or data recovery), please contact us. We can manually adjust this value for you.