Create a scene

To get started, click   and select Scene. After completing a step, click   in the header to move on. Click   if you want to change the scene name or flag it as a test.

Settings

Enter a scene name. The name should represent the purpose of the scene, e.g., “Account Upgrade.” The name appears in reporting and Messages OverviewA view of all your project’s messages, with options for editing their settings, content, status, and more. .

After entering a name, you may configure optional features.

Audience

Select your scene audience:

• All Users: Display the scene to your entire audience.
• Test Users: Predefined recipient groups. After choosing Test Users, select from the Test Groups dropdown menu that appears. See: Preview and Test Groups.
• Target Specific Users: Create a recipient group based on available conditions. See: Target Specific Users: In-App Automation.

Content workflow

Configure the content of your scene. A preview updates as you type and make selections. Toggle the Light/Dark selector above the preview to see the appearance of elements with an assigned Color SetA named pair of hexadecimal color values supporting device Light and Dark modes. Color sets can be selected for any color field in a scene and when configuring the default appearance of surveys, scenes, and in-app automations. Dark mode is supported for scenes only. . Light Mode values appear in Dark Mode preview if no Dark Mode value was entered for a color set.

1. Select Start from Scratch or a template, then click Continue with selection. You cannot change your selection after continuing.

   

   You will then see the first screen in the scene.

   Click   Add screen to add another.

2. 

   Click Settings in the sidebar to choose the scene style and configure the dismiss button. Select a Color SetA named pair of hexadecimal color values supporting device Light and Dark modes. Color sets can be selected for any color field in a scene and when configuring the default appearance of surveys, scenes, and in-app automations. Dark mode is supported for scenes only. or enter a hexadecimal color value for the button color.

3. Configure the content and order of your screens. See Content configuration below.

   The left sidebar indicates the current screen, and you can switch back and forth between screens by selecting from the sidebar. Options:

   • Reorder — Click and hold  , then drag and drop in a new position.
   • Duplicate or Delete — Click  , then click   Duplicate or   Delete. If your scene has a single screen, you can duplicate but not delete.

   Click   to add elements. After adding an element, you can click   to edit, duplicate, or delete it. You can also click and hold  , then drag and drop in a new position.

   ---

   You can set a tag when the screen is displayed. Enable Set a tag, then enter the tag you want to set. Click to select from the list of existing tags, or click Create new tag: [entered tag].

   ---

   Edit the Design settings in the right sidebar to override your project-level design settings for the selected screen only. You can edit the appearance of its background, headers, body, and buttons.

   • For colors, select a Color SetA named pair of hexadecimal color values supporting device Light and Dark modes. Color sets can be selected for any color field in a scene and when configuring the default appearance of surveys, scenes, and in-app automations. Dark mode is supported for scenes only. or enter a hexadecimal color value.
   • To use media as the background for a screen, enter an HTTPS URL that will be accessible by your mobile audience. If your Airship plan includes CDN support, you can also upload media or select from previously uploaded media.

4. Click Done to save changes to all edited screens. You will then see a collapsed view of the screens in the scene. Click the arrows to page through multiple screens. Click Expand   to see screens side by side.

Content configuration

Refer to this information when configuring the content in a scene. See also: About scenes: Appearance and behavior.

Button group

Enter the button label text and select an action. If there are two buttons total, choose a button layout: separate, joined, or stacked. If your scene includes a question or NPS, you must configure a button using the Submit Responses action. Options:

• Accessibility description — Enter the text to be announced by assistive technology, such as screen readers. This overrides announcement of the button text.

• Event name — By default, the total clicks for all buttons in the scene are reported using Custom EventEvents that indicate that a user performed a predefined action, such as adding an item to a shopping cart, viewing a screen, or clicking an Unsubscribe button. Custom events can trigger automation, sequences, scenes, and surveys. You can code them into your app or website, or send them to Airship from an external source using the custom event API. Custom events contain properties that you can use to personalize messages. button_action. To differentiate the clicks for a specific button, enter an event name. This name is appended to the default. For instance, if you enter Cat socks55, the event name in reporting will be button_action--Cat socks55. Event names also support HandlebarsHandlebars is Airship’s templating language for personalization. Handlebars expressions use double curly braces wrapped around a content template, ranging from a simple variable, e.g., {{first_name}}, to complex evaluations of personalization data. .

• Tags and subscription list opt-in/out — Add or remove a TagMetadata that you can associate with channels or named users for audience segmentation. Generally, they are descriptive terms indicating user preferences or other categorizations, e.g., wine_enthusiast or weather_alerts_los_angeles. Tags are case-sensitive. or opt a user in to or out of a Subscription ListAn audience list of users who are opted in to messaging about a specific topic. Users can manage their opt-in status per list using a preference center. when they tap the button. See: Button options.

• Fix at bottom on scroll — Check this option to keep buttons visible at the bottom of the screen when the user scrolls.

List

Provide media that serves as the bullet and enter text for the list item.

1. Enter an HTTPS URL that will be accessible by your mobile audience. If your Airship plan includes CDN support, you can also upload media or select from previously uploaded media.
2. Enter text for the list item.
3. Click Add another and repeat steps for each list item.

Media

Enter an HTTPS URL that will be accessible by your mobile audience. If your Airship plan includes CDN support, you can also upload media or select from previously uploaded media. 10 media elements maximum per screen.

You can enter alternative text that can be announced by assistive technology, such as screen readers. Alternative text, also known as alt text, is a textual description of an image or video that is used when a person can not see or access the visual image to help them understand its meaning.

NPS

Scenes support a single NPS survey. NPS requires iOS and Android SDKs 16.9+.

1. Enter question text.
2. Enter range label text. E.g., Not at all likely and Extremely likely.
3. (Optional) Check the Required checkbox to make answering the question a requirement for submitting responses.

Question

Scenes support up to 10 questions. Questions require iOS and Android SDKs 16.9+.

1. Select a question type: Single Choice, Multiple Choice, or Open Text.

2. Enter question and answer text. To reorder your content click and hold   and drag and drop in new positions in the screen or question element.

3. (Optional) Check the Required checkbox to make answering the question a requirement for submitting responses.

4. (Optional for Single Choice and Multiple Choice questions) Check the Randomize order checkbox to present the answers in random order when the survey is viewed in the app. The answer order is ignored if you check Randomize order.

5. (Optional for Single Choice questions) Enable Store as Attribute to store responses as text or number AttributesMetadata that you can use for audience segmentation. Attributes differ from tags in that when evaluating users with attributes, Airship uses operators, e.g., equals, less than/greater than, contains, before/after, to determine whether or not to target a user. Supported attribute types are TEXT, NUMBER, and DATE. , then:

   1. Search for and select an attribute.
   2. Enter a value next to each answer. The value entered must match the attribute type (text or number). If empty, the response is not stored as an attribute. You must add attributes to your project before you can use them in surveys. You cannot use the same attribute in multiple questions in a single survey.

Text

Select Header, Body, or Footer and enter text. For Footer, also select and configure its ActionA configurable behavior that occurs when a user interacts with your message, e.g., opening a web page. : Home, Deep Link, Adaptive Link, or Web Page. 15 text elements maximum per screen.

Media library

If your Airship plan includes CDN support, you can also upload media or select from previously uploaded media when configuring background media in the Design settings or List and Media content.

1. Select Upload and click Insert Media.

2. Click Choose file and select a file to upload, or select from previous uploads.

   • The default sort order is most recent upload first.
   • You can search by file name or keyword.
   • A file preview appears after upload or selection. Click   to preview audio and video files.

3. (Optional) Add or edit keywords for the file to help organize your uploads.

   • Enter a term in the search field below the preview and select from results, or click Add keyword: [term].
   • Click   to remove a keyword.

4. Click Insert selected media.

See also: Media library. Contact Support  if you are interested in enabling CDN media hosting.

Behavior

Configure the trigger that will cause the scene to appear to users. You can also configure cancellation events and display conditions.

Review

Review your scene before making it active. For scenes with more than one screen, click the arrows to page through each screen’s preview and summary. Toggle the Light/Dark selector above the preview to see the appearance of elements with an assigned Color SetA named pair of hexadecimal color values supporting device Light and Dark modes. Color sets can be selected for any color field in a scene and when configuring the default appearance of surveys, scenes, and in-app automations. Dark mode is supported for scenes only. . Light Mode values appear in Dark Mode preview if no Dark Mode value was entered for a color set.

Click Finish to make the scene active. If you exit before clicking Finish, the scene is still a draft and not yet active.