Set up Scalarr

Scalarr is an Adjust module partner. Our integration lets Scalarr receive attribution and app event data through automated callbacks.

Use our basic setup instructions to turn on Adjust’s integration and send callbacks to Scalarr. Then, use our advanced setup instructions to customize what information Scalarr receives.

Basic setup

To turn on Adjust’s integration with Scalarr, follow these steps.

  1. Find your app and select your app options caret (^)
  2. Select Partner Setup > ADD PARTNERS
  3. Select Add (+icon) next to Scalarr
  4. Enter your API KEY (contact your Scalarr representative for help finding this)
  5. Optional: see advanced setup to customize your callbacks
  6. Select Save

Well done! Basic setup is complete. Scalarr will receive callbacks for these activities:

  • click
  • install
  • rejected install
  • session
  • event
  • reattribution

Advanced setup

Choose which data Scalarr receives from Adjust by customizing your setup.

Forward in-app revenue

Revenue forwarding lets Scalarr receive revenue amounts along with your revenue event data.

To forward in-app revenue to Scalarr, follow these steps.

  1. Find your app and select your app options caret (^)
  2. Select Partner Setup > Scalarr
  3. Turn on In-App Revenue Forwarding

Now Scalarr will receive the revenue amount for every tracked transaction.

 

Note: Link at least one revenue event to Scalarr before turning on Revenue Forwarding

 

Forward sessions

Adjust does not automatically send session callbacks due to the high volume of sessions.

To forward in-app sessions to Scalarr, follow these steps.

  1. Find your app and select your app options caret (^)
  2. Select Partner Setup > Scalarr
  3. Turn on Session Forwarding

Now Scalarr will receive your app’s session activity.

 

Forward custom data

Partner parameters (available in Adjust SDK version 4.0+) let Adjust collect custom data points from your app and send them to Scalarr.

Note: Before adding new partner parameters to the Adjust SDK, make sure no pre-existing partner parameters already fit your requirements.

To forward partner parameters to Scalarr, follow these steps.

  1. Set up partner parameters within the Adjust SDK (instructions for iOS and Android)
  2. In the Adjust dashboard, find your app and select your app options caret (^)
  3. Select Partner Setup > Scalarr
  4. Turn on Parameter Forwarding
  5. Select Partner Parameter Mapping
  6. In the FROM APP field, enter the name of your Adjust parameter (as written into the Adjust SDK). In the TO PARTNER field, enter your corresponding Scalarr name.
  7. Select Save

Now Scalarr will receive custom event details for each of your linked events.

 

Note: If you set up partner parameters within the Adjust SDK without turning on Partner Parameter Mapping, Adjust forwards the parameters as named in the Adjust SDK.

 

Forward app events

Event linking lets Scalarr receive app event data. You can link every app event in Adjust to a preset Scalarr name or a custom event name.

To forward app events to Scalarr, follow these steps.

  1. Find your app and select your app options caret (^)
  2. Select Partner Setup >Scalarr > Event Linking
  3. Find the event you want to link and update the field with a Scalarr event or your own custom name
  4. When you finish linking events, select OK
  5. Select Save

Now Scalarr will receive app event data for each of your linked events.

List of all parameters forwarded to Scalarr

Scalarr requires Adjust to send the following parameters (data points) with your callbacks:

Placeholder Information
{activity_kind} Type of user activity
{adgroup_name} Adgroup name, as taken from the tracker
{adid} Adjust device ID (all platforms)
{android_id} Android ID (Android only)
{app_id} Store App ID or Google Play Store
{app_name} Name of the app
{app_version} App version number (Android), build
{campaign_name} Campaign name, as taken from the tracker
{city} Device city
{click_attribution_window} Attribution window settings for device matching (hours)
{click_time} Attributed click timestamp
{connection_type} Internet connection type
{cost_amount} Cost of the user engagement (available for ad spend tracking only)
{cost_currency} ISO 4217 currency code of the cost data (available for ad spend tracking only)
{cost_type} The campaign pricing model (available for ad spend tracking only)
{country} Device two
{created_at} Activity timestamp
{creative_name} Creative name, as taken from the tracker
{currency} Original ISO 4217 currency code sent from Adjust SDK
{deeplink} Deeplink URL appended to click URL
{device_name} Device model number
{device_type} Device type
{engagement_time} Engagement timestamp
{gps_adid} Google Play Store advertising ID
{idfa_upper} Uppercase IDFA
{impression_attribution_window} Attribution window settings for impression matching (hours)
{impression_based} 1 if impression
{inactive_user_definition} Inactivity period required for reattribution (hours)
{install_begin_time} App download began timestamp (Android and Google Play Store only)
{install_finish_time} App download completion timestamp
{installed_at} Install (i.e., first app open) timestamp
{ip_address} Device IP address
{is_organic} 1 if organic traffic, 0 if non
{isp} Device internet service provider
{label} Value of the Adjust "label" parameter sent on click
{language} Device two
{last_time_spent} Length of user's last session, in seconds
{lifetime_session_count} Number of sessions recorded across entire user lifetime
{match_type} Attribution method
{network_name} Network name, as taken from the tracker
{os_version} Operating system version number
{partner_parameters} Custom partner parameters collected by the Adjust SDK or S2S request and transmitted to third party providers via postbacks
{random_user_id} Random user ID (per device)
{reattributed_at} Reattribution timestamp
{reattribution_attribution_window} Attribution window settings for reattribution (hours)
{referral_time} User landed on app Play Store page timestamp (Android and Google Play Store only)
{rejection_reason} Reason for a rejected attribution
{revenue_float} Revenue, as sent from Adjust SDK, in whole currency units
{revenue_usd} Revenue, in US dollars
{revenue} Revenue, as sent from Adjust SDK in cents
{sdk_version} Adjust SDK version (per app)
{store} Target store of click
{time_spent} Length of user's current session, in seconds
{timezone} Device time zone
{user_agent} Incoming raw user agent