Native App Embedding

Where a native app is the destination, an Experience can be opened in a WebView that is initiated by the host app

If you want to integrate existing Monterosa apps into your native iOS (Swift) or Android (Kotlin) application, there are two routes:

1. Embed using the SDK: create and manage dynamic loading on your behalf

2. Manage your own WebViews: setup your own WebView handling

To discover the availability of an Experience or Event within the platform, please see Discovering Events Programmatically.

Embed using the SDK

To get access to the SDK please contact your account manager or raise a support ticket at [e-mail]

Monterosa / Interaction SDK manages dynamic WebViews on your behalf, making integration easier and more predictable. It handles sizing, loading and communications between parent app and the app.

Please refer to the Embedding Apps guide below for instructions:

Embedding Experiences

Manage your own WebViews

If you'd prefer to create and manage the WebView' yourself, you can do so as follows:

1. Grab your Embed URL from the Studio

2. Make sure the Experience is on-brand, hide the Experience's own header

3. Enable Javascript and data storage in your WebView

4. Integrate with your SSO, or other services

5. Optional: Ensure that the Experience can play inline in iOS by setting allowsInlineMediaPlayback in the WKWebViewConfiguration instance in your WKWebView.

6. Optional: Enable full screen HTML5 videos in Android by providing a custom WebChromeClient that supports it by implementing onShowCustomView and onHideCustomView methods.

Enable Javascript and data storage in your WebView

Monterosa Experiences require browser DOM storage and JavaScript enabled to function correctly, so you need to ensure both are enabled in your WebView configuration.

iOS

1. Enable JavaScript:

   • iOS 8 - iOS 14

   • iOS 15+

2. Enable data storage

Android