Setting Button Actions
A button action is the action that occurs when a user taps a button in your In-App Automated message. You add buttons during the Content step of the In-App Automation composer, and you set button actions during the Actions step. You must associate an action for each button.
- Select a button action.
- (Optional) Set tag behavior.
- (Optional) Limit the display to once if the user taps the message.
- Repeat for each button.
- Click to move on to the next step.
It is configured in the same way as the other buttons, and they are presented in separate panes: Footer and Buttons. The actions available for the footer button are Adaptive Link, Deep Link, and Web Page.
Adaptive Link opens a mobile wallet pass. Select an Adaptive LinkA vendor-agnostic, shortened 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 that platform. from the list.
- Adaptive links must be configured before they will appear in the actions list. See: in Create adaptive links using the dashboard.
- Only adaptive links created in the dashboard will appear in the actions list.
App Rating prompts the user to rate the app in the app store. Optionally enter a custom message title and body.
App Rating display behavior differs by operating system and version:
- The Title and Body dialog appear for iOS 10 or below and Android only.
- iOS 11 will instead display its system dialog for app rating. Additionally, Apple limits app rating dialogs to three times in a 365-day period.
App rating prompts will process as configured by your message settings, but the displayed dialog is controlled by Apple, not Airship.
iOS requires that you provide your app’s Apple ID, which is used as the iTunes App Store Identifier. (Android and Amazon generate app store links automatically based on information already in your app, so no configuration is required.)
You can do this by adding the ID in your Airship project settings, or by editing your plist dictionary.
In your plist dictionary, add the following, substituting
1111111111 with the app’s actual ID:
A quick way to find the Apple ID is to copy the numbers at the end of the app’s iTunes URL. If the URL is
https://itunes.apple.com/app/id123456789, the Apple ID is
Another way is to locate your app in iTunes Connect and copy the Apple ID.
Deep Link opens a screen in your app or website. Select a deep link from the list.
- Deep links must be configured before they will appear in the actions list. See: Manage Deep Links.
- If you selected a deep link template, you can fill in each template segment.
The default action of a button is to dismiss the message, without any other effect. For example, a “Not Now” button allows a user to defer taking action and dismisses the message, which can be configured to reappear at a later time. An effective way to pair actions is to provide a “Not Now” button with the Dismiss Action, and an additional button with the Deep Link action, providing a direct link to your content.
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:
When you enter this URL in the Airship interface, the form parses it and previews the form your users see in the Message 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:
The interface treats all values for each field as a string.
Dismiss Message dismisses the In-App Message.
Location Opt-in opens the system prompt for location opt-in.
Push Opt-in opens the system prompt for push notification opt-in.
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 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.
Set a Tag
Set a tag on the device when the button is pressed. It’s also possible to remove a tag, or combine setting and removal actions on one button press.
- Click Set a tag.
- Select Add or Remove, then search for tags that exist in the system, or create a new tag.
The ability to set tags based on user actions is key to promoting new features. The suggested approach is to display messages regarding a feature if the tag does not exist, and to then set the tag to record either the fact that the user has acknowledged the message, or to record actual usage of the feature. You can set a tag when a user clicks a button on an In-App Message, or even upon In-App Message display, but recording actual feature usage requires some native code within the app. See:
Disable Multiple Display
Keep the message from displaying more than once if the user taps the message. Check the box to enable.
Use this for repeated goal-related messages, e.g., prompt to opt-in. You would want to prevent re-display when the user accomplishes the goal.