Optimizely

📘

Business and Enterprise plugin

The Optimizely integration is available on Median's Business and Enterprise plans. These plans include expert app development, advanced native plugin access, dedicated technical support, and guaranteed App Store publishing, everything organizations need to launch and maintain mission-critical mobile apps.

Book a call with the Median team to discuss your requirements and get started.

The Optimizely plugin lets you initialize the SDK and manage push-related actions through the Median JavaScript Bridge. The plugin focuses on identifying users and controlling push registration and permission state from your web layer, giving you full control over the Optimizely SDK initialization without relying solely on App Studio auto-configuration.

Why use Optimizely

• Bridge-first integration: Call Optimizely actions directly from JavaScript without native code changes.
• Push workflow coverage: Request notification permission, check permission status, and register for push from a single API.
• User identity support: Set user email or user ID for audience targeting before registering push tokens.
• Flexible async pattern: Use callback style or promises.

Prerequisites

• A Median.co app with JavaScript Bridge enabled
• Optimizely API key
• Deep linking setup if you want notification links to open directly in-app

Optimizely is essential for apps that need to:

What you'll do

Use this section as a fast navigation map into the full setup and implementation details:

1. Enable the plugin config: Go to Plugin setup and complete Enable the plugin.
2. Confirm runtime behavior: Review Configuration options for the active toggle behavior.
3. Implement bridge calls: Add core methods from JavaScript bridge functions.
4. Validate integration flow: Run the scenarios in Code examples.
5. Verify edge cases: Complete Testing checklist and use Troubleshooting.

Plugin setup

Enable the plugin

To enable this plugin, book a call with the Median team to discuss your requirements and get started.

Configuration options

Note: Notification links can open directly in the app when Deep Linking is configured.

JavaScript bridge functions

Initialize

Initialize Optimizely with an API key when not auto-configured in App Studio. For this function, provide a callback function or otherwise a promise is returned.

↔️Median JavaScript Bridge

// Using promises (recommended)
const result = await median.optimizely.initialize({ apiKey: 'YOUR_OPTIMIZELY_API_KEY' });
console.log('initialize result:', result);

// Using callback
median.optimizely.initialize({ apiKey: 'YOUR_OPTIMIZELY_API_KEY' }, function(result) {
    console.log('initialize callback:', result);
}, function(err) {
    console.error('Optimizely error (callback)', err);
});

Parameters:

Return value:

interface OptimizelyInitializeResponse {
    success: boolean;
}

Check if Initialized

Check whether the Optimizely SDK is already initialized. For this function, provide a callback function, or a promise is returned.

↔️Median JavaScript Bridge

median.optimizely.isInitialized({'callback': function});

Parameters:

Return value:

interface OptimizelyIsInitializedResponse {
    initialized: boolean;
    apiKey?: string;
}

Set Email

Identify the user by email address in Optimizely. Call registerPush after this to generate a new push token associated with the identified user. For this function, provide a callback function or otherwise a promise is returned.

↔️Median JavaScript Bridge

median.optimizely.setEmail({'email': '[email protected]', 'callback': function});

Parameters:

Return value:

interface OptimizelySetIdentityResponse {
    success: boolean;
}

Set User Id

Identify the user by a custom ID in Optimizely. Call registerPush after this to generate a new push token associated with the identified user. For this function, provide a callback function or a promise is returned.

↔️Median JavaScript Bridge

median.optimizely.setUserId({'userId': 'user-123', 'callback': function});

Parameters:

Return value:

interface OptimizelySetIdentityResponse {
    success: boolean;
}

Register For Push Notifications

Register the current user for push and generate a new push token. Call this after setting the user identity to ensure the token is associated with the identified user. For this function, provide a callback function, or a promise is returned.

↔️Median JavaScript Bridge

median.optimizely.registerPush({'callback': function});

Parameters:

Return value:

interface OptimizelyRegisterPushResponse {
    success: boolean;
}

Prompt for Push Notification Permission

Prompt the user to grant notification permission. For this function, provide a callback function, or otherwise a promise is returned.

↔️Median JavaScript Bridge

median.optimizely.requestPermission({'callback': function});

Parameters:

Return value:

interface OptimizelyPermissionResponse {
    granted: boolean;
}

Check Push Notification Permission Status

Check the current notification permission state without prompting the user. For this function, provide a callback function, or a promise is returned.

↔️Median JavaScript Bridge

median.optimizely.permissionStatus({'callback': function});

Parameters:

Return value:

interface OptimizelyPermissionResponse {
    granted: boolean;
}

Testing checklist

Use this checklist to ensure Optimizely is working correctly in your app:

Troubleshooting

📘

Still having trouble?

For issues related to Optimizely's own configuration, permissions, or platform-specific behavior outside Median.co, refer to Optimizely's integration documentation.