Adjust

Track app installs, user interactions, and attribution data using the Adjust iOS and Android SDKs via the Median JavaScript Bridge.

The Adjust Native Plugin integrates the Adjust iOS and Android SDKs into your app to enable advanced analytics and event tracking. You can register app installs, track user interactions, and retrieve attribution data. You can also trigger events and fetch attribution details directly from JavaScript using the Median JavaScript Bridge.

Use Automatic initialization unless you need to control exactly when Adjust starts (for example after consent or login). If you choose Manual, call median.adjust.intialize(...) before other Adjust bridge calls.

🚧

Adjust Environment

Prior to publishing your app, confirm that the Adjust environment is set to production in Median App Studio (equivalent to AdjustConfig.EnvironmentProduction in the native Adjust SDK). See Understanding the Adjust environment below.

Why use Adjust?

• Event tracking: Send custom events to Adjust from your app, including revenue and metadata.
• Attribution data: Retrieve attribution information when users install through Adjust-tracked campaigns or deep links.
• JavaScript Bridge: Initialize, track events, and fetch attribution via the Median JavaScript Bridge.
• Dual initialization: Automatically on app start or manually via a JavaScript Bridge method (select in plugin settings).

---

Prerequisites

• A Median.co app with JavaScript Bridge enabled
• Adjust SDK (iOS and Android) as provided by the plugin
• Adjust app token — In the Adjust dashboard, open AppView → All apps, select your app, then go to App information and scroll to App details. Your app token is listed there with your app name and reporting currency. Adjust assigns this token when you add the app; you paste it into the Adjust plugin in Median App Studio. Official steps: Get app token and choose reporting currency (Adjust Help Center).
• Set the Adjust environment to production before publishing (see Understanding the Adjust environment).

Understanding the Adjust environment

The Adjust SDK runs in either a non-production (testing) or production (live) mode. In Median.co's plugin, this is the Environment control (Development vs Production).

Before you publish to stores, switch Environment to Production so installs and events from end users are attributed correctly in the Adjust dashboard. Leaving Development enabled for a shipped app can send or classify traffic incorrectly relative to production reporting.

---

When to use this plugin

Adjust is essential for apps that need to:

---

What you'll do

1. Configure the plugin: Go to Plugin setup and set App Token, Environment, Initialization, and StoreKit Ad Network Attribution in Median App Studio.
2. Choose initialization: If you use Manual initialization, call median.adjust.intialize(...) after the bridge is ready (see intialize).
3. Track events: Use median.adjust.trackEvent with tokens from your Adjust dashboard (see trackEvent).
4. Read attribution (optional): Call median.adjust.attributionInfo when you need stored attribution (see attributionInfo).
5. Validate: Complete Testing Checklist and confirm Production before release.

---

Integration Guide

📘

Important considerations

• The boolean passed to median.adjust.intialize(true | false) enables or disables SKAdNetwork on iOS only; Android ignores this parameter.
• Event tokens are created in the Adjust dashboard, not in Median.

Plugin Setup

Enable the Plugin

1. Navigate to Native Plugins: In your Median dashboard, open your app in App Studio and go to the Native Plugins section.
2. Enable Adjust: Select Adjust from your list of purchased plugins and enable it.
3. Configure the plugin: Set App Token, Environment, Initialization, and StoreKit Ad Network Attribution in App Studio.

Median App Studio settings

Configure the Adjust native plugin in App Studio → Native Plugins → Adjust. These map to the Adjust SDK options described in the Adjust Developer Hub.

JavaScript mapping: median.adjust.intialize(true | false) applies when Initialization is Manual (call it to start the SDK). The optional boolean reflects StoreKit Ad Network Attribution on iOS. median.adjust.trackEvent and median.adjust.attributionInfo require a successfully configured SDK (App Token and Environment); see notes under each function below.

Configuration Options

Use Automatic initialization unless you need to control exactly when Adjust starts (for example after consent or login). If you choose Manual, call median.adjust.intialize(...) before other Adjust bridge calls.

---

JavaScript Bridge functions

Intialize plugin

Initialize the Adjust plugin manually. Takes an optional argument to enable or disable SKAN (iOS only; ignored on Android).

↔️Median JavaScript Bridge

JavaScript

// Initialize method takes an optional argument to enable or disable SKAN 
// This parameter is only relevant for iOS and will be ignored for Android

median.adjust.intialize(true | false);

Parameters:

Use this only when Initialization is Manual in App Studio. If Initialization is Automatic, the SDK starts without this call.

Sending Events to Adjust

Send a custom event to Adjust. Events can include revenue data and additional metadata as configured in the Adjust dashboard.

Example: Track a Revenue Event

↔️Median JavaScript Bridge

JavaScript

const adjustEvent = new AdjustEvent('abc123');
adjustEvent.setRevenue(0.01, 'EUR');
median.adjust.trackEvent(adjustEvent);

Parameters:

• Replace 'abc123' with your Adjust event token.
• Replace 0.01, 'EUR' with your desired revenue amount and currency code.

Median settings: App Token (required in App Studio so the SDK is bound to your Adjust app). Environment (Development vs Production) determines how traffic is classified. Event tokens are defined in Adjust, not in Median.

Retrieving Attribution Data

Retrieve attribution data for users who installed the app through an Adjust-tracked campaign or deep link.

↔️Median JavaScript Bridge

JavaScript

median.adjust.attributionInfo();

Return value: Attribution information stored by Adjust for the current user/install.

---

Testing Checklist

Use this checklist to confirm Adjust is working in your app:

Basic Functionality

• App Token is set in App Studio (from Adjust AppView → your app → App information → App details)
• Plugin is enabled in Native Plugins and Initialization (automatic or manual) matches how you start the SDK in code
• If using manual initialization, median.adjust.intialize(true | false) is called after the app and bridge are ready; SKAN boolean aligns with StoreKit Ad Network Attribution on iOS
• Environment is set to Production before publishing

Platform Testing

• median.adjust.trackEvent(adjustEvent) runs without errors with a valid Adjust event token
• Revenue events use the correct event token, amount, and currency code
• Events appear in the Adjust dashboard for the correct app

Configuration Testing

• App Token and Environment match your Adjust app and release stage
• Initialization choice (automatic vs manual) matches your code paths

User Experience

• median.adjust.attributionInfo() behavior matches expectations for organic vs campaign installs
• Plugin does not interfere with app navigation or core web flows

---

Troubleshooting

Adjust functions are undefined or not working

Ensure the JavaScript Bridge is enabled in your Median dashboard and that you're calling the functions after the deviceready event. Verify that the plugin is enabled in your app configuration. If you use manual initialization, call median.adjust.intialize() before other Adjust calls.

Events or revenue not showing in the Adjust dashboard

Confirm your event token ('abc123' in the examples) is replaced with a valid token from your Adjust dashboard. Check that the Adjust environment is set to production before publishing. Allow a short delay for events to appear in the dashboard.

Attribution data is missing or always organic

Attribution is populated when users install via an Adjust-tracked campaign or deep link. Organic installs (e.g. direct from the store) may return organic status or limited data. Ensure your campaign and deep link setup in Adjust is correct and that you're testing with a real install or re-engagement from a tracked link.

Wrong or missing revenue on events

Verify you're calling adjustEvent.setRevenue(amount, currency) with the correct numeric amount and 3-letter currency code (e.g. 'USD', 'EUR') before passing the event to median.adjust.trackEvent(adjustEvent).

📘

Still having trouble?

For Adjust SDK behavior outside Median.co, refer to Adjust’s developer documentation.