Configure content elements

Configure content elements after adding them to a screen. For each element, configure its settings in the center panel and its design properties in the right sidebar.

Button or Button Group

Add a single button or up to five buttons in a group. When using multiple buttons in a screen, add single buttons if you want to place content between them, and use a button group to keep buttons together.

After configuring the first button in a group, select Add button for more. One Button Group is allowed per screen.

Set for each button:

For the Button Group element, set the Layout if there are two buttons total. This determines if buttons appear separate, joined, or stacked. Three or more buttons are automatically stacked.

In the sidebar, first select a button style configured in your brand guidelines, and then configure the design properties.

Container

Create a Container for other content elements. By default, screen elements are stacked vertically, and you can drag them into your preferred order. When you place elements in a Container, you can arrange them vertically or horizontally. Containers also support nesting, so you can do things like place images side by side.

Immediately after selecting Container, select an element to add to that container. Use the breadcrumbs above the content elements to navigate between nested containers and back to the root screen.

To fix a container at the bottom of a screen, see Add content elements. Containers do not support NPS.

In the sidebar, configure Background color and Background media using the same steps as the screen background.

Custom View

Embed a Custom ViewA native view from your mobile or web application embedded into a Scene. Custom Views can display any native content your app exposes, so you can reuse that existing content within any screen in a Scene. into a screen. Since the actual content of a native view is unknown by the device preview, the preview displays a placeholder.

Set for the Custom View element:

Email

Email collection: iOS SDK 18.13+Android SDK 18.5+
Email registration: iOS SDK 19.1+Android SDK 19.2+

Add a field to register a submitted email address as a channel or only collect it as data. You must also configure a Button or Media (image only) using the Submit Responses action. Use a Text element to add a title for the field and provide disclosures. See also Providing disclosures and other required information.

Email addresses submitted through this element are validated, collected, and optionally registered as channels:

• Validation — Email addresses are validated when the Submit Responses and Validate Form actions occur. For valid formats, see Validate Form in Actions for in-app experiences.

• Collection — Collected email addresses are available in Performance AnalyticsA customizable marketing intelligence tool that provides access to reports and graphs based on engagement data..

• Registration — When registering an address as a channel, the address is associated with the ContactAny user in your project. Contacts are identified as either an Anonymous Contact or a Named User. Airship can set targeting data on these identifiers, which are also used to map devices and channels to a specific user. viewing the Scene, and the channel is automatically opted in to both transactional and commercial messaging.

  Registration using this field is handled the same as other email registration methods. For example, registered addresses appear in Contact Management and emit the same Real-Time Data StreamingA service that delivers user-level events in real time to your backend or third-party systems using the Data Streaming API. events.

  To require double opt-inA process where users who sign up for messaging must confirm opting in before they can receive messages. before the user is opted in to commercial messaging, enable the double opt-in option and create an AutomationA set of conditions that your audience must meet before they receive a message. or SequenceA series of messages that is initiated by a trigger. Airship sends messages in the series based on your timing settings, and you can also set conditions that determine its audience and continuation. Sequences can be connected to each other and to other messaging components to create continuous user experiences in a Journey. using the Double Opt-In trigger that sends users an email with an opt-in link. No further setup is required, but users must complete the double opt-in process by following the link in your email. You may want to add text within the Scene that informs users of the opt-in type.

  For double opt-in, you can also set event property key-value pairs to differentiate opt-in sources and trigger messages depending on where users opted in. This is recommended so you can trigger a specific message. For example, in an app Scene, you could set a key-value pair to source:app and then create an Automation or Sequence using the Double Opt-in trigger where the event property source is equal to app. In a web Scene, you could instead use source:website, or you may want to use source:store or another meaningful ID.

  See Commercial vs. Transactional Email and Double Opt-In in the Email platform Getting Started documentation.

Set for the Email element:

In the sidebar, first select an input style configured in your brand guidelines, and then configure the design properties.

List

Add a bulleted list where the bullet is an image you provide. After configuring the first list item, select Add another for more.

Set for each list item:

In the sidebar, first select a text style configured in your brand guidelines, and then configure the design properties.

Media

Add an image or video. 10 media elements maximum per screen.

Set for the Media element:

NPS

Add a Net Promoter Score (NPS)  survey. The survey presents a question with a 0-10 answer scale that measures how likely users are to recommend your brand or product. Use it to gauge overall sentiment (relational NPS) or feedback on a specific experience like booking a flight (transactional NPS).

Scenes support a single NPS survey. You must also configure a Button or Media (image only) using the Submit Responses action. NPS is not supported in Story mode.

The device preview only displays settings for the unselected state, so you should verify the appearance of the selected state by testing on an actual device.

Set for the NPS element:

In the sidebar, first select a text style configured in your brand guidelines, and then configure the design properties.

Question

Add a question with a field where users can enter their own answers, or add a single or multiple choice question with answers users can select.

Scenes support up to 10 questions. You must also configure a Button or Media (image only) using the Submit Responses action. Questions are not supported in Story mode.

Set for the Question element:

To configure storing as attribute:

1. Toggle to enable.
2. Search for and select an attribute.
3. Enter a value next to each answer. The value must match the attribute type (text or number). If empty, the response is not stored as an attribute. You cannot use the same attribute in multiple questions in a single Scene.

The design properties for the question and answers are in separate sections. In the sidebar, first select a text or input style configured in your brand guidelines, and then configure the design properties.

SMS

Add a field to register a submitted phone number as a channel or only collect it as data. Channel registration requires selecting a sender IDAn originating phone number or string identifier used to indicate who an SMS message comes from. Members of your audience subscribe (opt in) to each sender ID they want to receive messages from. to associate with the channels. Collection requires selecting which countries can submit phone numbers. The selected countries, or the country code associated with the sender ID, are listed in a dropdown menu and represented by the country’s flag. If more than one country is available for the field, the user must select one before entering their phone number.

You must also configure a Button or Media (image only) using the Submit Responses action. Use a Text element to add a title for the field and provide disclosures. See also Providing disclosures and other required information.

• Validation — Phone numbers are validated when the Submit Responses and Validate Form actions occur. For valid formats, see Validate Form in Actions for in-app experiences.

• Collection — Collected phone numbers are available in Performance AnalyticsA customizable marketing intelligence tool that provides access to reports and graphs based on engagement data..

• Registration — Registering a phone number as a channel automatically triggers the double opt-inA process where users who sign up for messaging must confirm opting in before they can receive messages. process, and the phone number is associated with the ContactAny user in your project. Contacts are identified as either an Anonymous Contact or a Named User. Airship can set targeting data on these identifiers, which are also used to map devices and channels to a specific user. viewing the Scene. See Register SMS Users in Getting Started and Double Opt-In in Opt-In/Out Handling in the SMS platform documentation.

  Registration using this field is handled the same as other SMS registration methods. For example, they appear in Contact Management and emit the same Real-Time Data StreamingA service that delivers user-level events in real time to your backend or third-party systems using the Data Streaming API. events.

Set for the SMS element:

In the sidebar, first select an input style configured in your brand guidelines, and then configure the design properties.

Text

Add a string of text. Scenes support up to 15 Text elements per screen.

When using a Text element as the label for an input field, set it as the field’s accessibility description. See Accessibility description in Email, SMS, and Text Input.

Set for the Text element:

In the sidebar, first select a text style configured in your brand guidelines, and then configure the design properties.

Text Input

Add a single-line text input field. You must also configure a Button or Media (image only) using the Submit Responses action. Use a Text element to add a title for the field.

Set for the Text Input element:

In the sidebar, first select an input style configured in your brand guidelines, and then configure the design properties.