Embedded Content

Embedded Content overview

Embedded Content allows you to present SceneA mobile app or web experience of one or more screens displayed with fully native UI components in real time, providing immediate, contextual responses to user behaviors. Scenes can be presented in full-screen, modal, or embedded format using the default swipe/click mode or as a Story. They can also contain survey questions. content directly within your app’s screens, creating inline experiences that feel native to your app’s flow. Unlike modal or fullscreen Scenes that appear as overlays, Embedded Content is integrated directly into your app’s existing views, making it ideal for promotional banners, contextual messaging, and personalized content cards.

Components

There are three primary components that work together to display Embedded Content:

Once the Scene is triggered for display and matches the specified audience conditions, its content is available to users when visiting a screen that contains the AirshipEmbeddedView.

Behavior

Embedded Content behavior is the same as In-App AutomationsMessages cached on users’ devices and displayed when users meet certain conditions within your app, such as viewing a particular screen or opening the app a certain number of times. and modal and fullscreen Scenes:

• The content displays only within the app.
• When the app is terminated, the content is not automatically dismissed. It continues to display in the next app session.

The view is populated with the content from all active Scenes with the matching ID, sorted based on priority. When an embedded view loads content, the highest priority Scene that is queued for display will be shown. The same content will be shown across app and web sessions until it is dismissed by the user or is no longer available. The view will then show the next Scene with the highest priority from the display queue.

Airship first prepares the content when the triggering event occurs and then refreshes it upon every app open or web session start. This ensures that users always experience the most up-to-date message. So, after updating active Embedded Content, users will see the latest version the next time they open the app or load the app or web page containing the view.

When to use Embedded Content

Use Embedded Content when you want to:

• Display contextual messages - Show relevant content inline with your app’s existing UI, such as promotional banners on a home screen or product recommendations within a shopping flow.
• Create persistent experiences - Unlike modals that interrupt the user flow, Embedded Content integrates seamlessly into your app’s layout.
• Personalize content - Use audience targeting and Scene capabilities to show different content to different users in the same view location.
• Test and iterate - Update content remotely without requiring app updates, allowing you to test different messages and layouts quickly.

Consider using modal or fullscreen Scenes instead when you need to:

• Capture immediate attention with an overlay
• Display important announcements or critical actions
• Show content that requires full user focus

Creating Embedded Content view styles

Before Embedded Content can be displayed in your app, you need to create an Embedded Content view style in your Airship project settings:

1. Navigate to Settings → Content Types → Embedded Content View Styles
2. Click Create View Style
3. Assign a unique ID (e.g., home_banner, product_promo)
4. Configure any default styling or behavior
5. Save the view style

Your app developers will use this ID when implementing the AirshipEmbeddedView in your app code.

Creating Scenes with Embedded Content

Once you have created view styles, you can create Scenes that use them:

1. Create a new Scene in Messages → Scenes
2. In the Presentation section, select Embedded Content
3. Choose the View Style you created earlier
4. Design your content using the Scene composer
5. Configure targeting, triggers, and other settings
6. Save and activate the Scene

For more information on creating Scenes, see About Scenes.

Requirements

Developer integration

For technical implementation details, see the platform-specific SDK integration guides:

• Apple (iOS/tvOS) Embedded Content Integration
• Android Embedded Content Integration
• React Native Embedded Content Integration
• Web Embedded Content Integration