Message Actions

Message actions determine what happens when a user interacts with your message.

When creating a Message, Automation, A/B Test, or Journey you must choose a message action. You also associate actions with buttons and rich pagesA landing page or Message Center message in your app that can include HTML, video, etc. .

Available actions differ depending on the message type or combination of message types. See Message Reference: Actions.

Each action and its settings, configuration, and requirements are detailed here.

Adaptive Link opens a mobile wallet pass. Select an Adaptive LinkA mobile wallet pass link that supports templates for both Google Pay and Apple Wallet. When a user taps the link, Airship determines the user’s platform and generates the right pass for the user. from the list.

  • Adaptive links must be configured before they will appear in the actions list. See: Adaptive Links Tutorial.
  • Only adaptive links created in the dashboard will appear in the actions list.

Deep Link opens a screen in your app or website. Select a deep link from the list.

Our Deep Link functionality supports URL templates, which expose a friendly interface to your users in our UI, while constructing the correct URL behind the scenes on the fly. You can specify substitution parameters by enclosing them in brackets. For example, if you want to define a Deep Link for a product page screen in your app (or on your mobile website), you can make the product ID number a substitution parameter. Here is an example URL:

http://yourcompany.com/products/{Product Id}

When you enter this URL in the Airship interface, the form parses it and previews the form your users see in the composer. It automatically identifies “Product Id” as the parameter name, and provides a field to substitute in the actual identifier. So if you had previously entered a product ID of 1872983490 for the above Product ID, the generated URL would be:

http://yourcompany.com/products/1872983490

The interface treats all values for each field as a string.

See: Manage Deep Links.

Dismiss Message

Dismiss Message closes the notification.

Home

Home opens your app’s home screen. For web push notifications it opens your Default Action URL. You can override the default URL by selecting the Web Page action and entering a different URL.

Landing Page

Landing Page opens a rich pageA landing page or Message Center message in your app that can include HTML, video, etc. that appears until it is closed. Follow the steps in Create Rich Pages. See also: Rich Page Reference.

 Note

The default behavior in the iOS SDK is to not display the landing page when the corresponding push notification is received while the app is in the foreground state. The logic behind this behavior is that you may not wish to interrupt or distract a user who is currently occupied with the app, only to ask them to visit a different part of the app.

If you need to display a landing page while the app is in the foreground state, replace the registry predicate associated with that action with one that allows foreground execution.

In the Airship SDK, this relative state between what the app is doing now and how the action was invoked is known as a situation, or more properly, UASituation . Other examples of situations besides foreground state include background push and app launched from push notification.

See UAActionArguments for more detail on the methods involved with this display behavior.

Message Center

Message Center opens a rich pageA landing page or Message Center message in your app that can include HTML, video, etc. that is saved in the user’s Message CenterA place in your app where you can display persistent rich messages, including HTML, video, etc. Similar to email, Message Center represents both the medium (the in-app inbox) and the message type (the messages you send to the inbox). inbox. Follow the steps in Create Rich Pages. See also: Rich Page Reference.

Share

Share prompts the user to share your message with apps, social media accounts, and other services. Enter the text you want to accompany the share, including any promotional information, shortened links, hashtags, etc.

Web Page

Web Page opens a web page or any valid-device level URL such as App Store or app protocol links. The web page opens in the device’s default browser. Enter a URL.