Button Actions

Each button configured in the Actions step of the In-App Automation Workflow must be associated with an action and may also include tag actions. Each action and its settings, configuration, and requirements are detailed here.

Note

The actions available for the footer button are Deep Link and Web Page.

Actions

Dismiss Message

Dismiss Message dismisses the In-App Message.

Tip

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.

Deep Link opens to a configured screen within your app or on the web. The Deep Link must be configured before it will appear in the dropdown menu. See: Settings: Configuration: Deep Links. Select from the dropdown menu.

If you selected a Deep Link template, each template segment field will be available to fill in. If no deep links have been predefined, you will see a link to the configuration documentation.

Templates

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:

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

When you enter this URL in the Urban Airship interface, the form parses it and previews the form your users see in the Message Workflow. 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:

https://yourcompany.com/products/1872983490

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

Push Opt-in

Push Opt-in opens the system prompt for push notification opt-in.

Location Opt-in

Location Opt-in opens the system prompt for location opt-in.

Adaptive Link opens a mobile wallet pass. The Adaptive Link must be configured before it will appear in the dropdown menu. See: Adaptive Links: Setup and Modification. Select from the dropdown menu.

Note

Only Adaptive Links created in the dashboard will appear in the dropdown list.

Web Page

Web Page opens to 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.

Share

Share prompts the user to share the message on social networks. Enter the text you would like to accompany the share, including any promotional information, shortened links, hashtags, etc.

App Rating

App Rating prompts the user to rate the app in the app store. Optionally enter a custom message title and body.

Note

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 In-App Automation settings, but the displayed dialog is controlled by Apple, not Urban Airship.
Important

iOS requires that you provide your app's Apple ID, which is used as the iTunes App Store Identifier. You can do this via our dashboard, or by editing your plist dictionary.

Dashboard
From within your project, navigate to Settings » Configuration » iTunes ID, enter the Apple ID, then click the Save button.
Plist dictionary
Add the following to your plist dictionary, substituting 1111111111 with the app's actual ID:

<key>itunesID</key> <string>1111111111</string>

Android and Amazon generate app store links automatically based on information already in your app, so no configuration is required.

Tip

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 123456789.

Another way is to locate your app in iTunes Connect and copy the Apple ID.

Options

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.

  1. Click the Set a tag button.
  2. Select Add or Remove from the dropdown menu, then type ahead to find tags that exist in the system, or create a new tag.
Tip

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.


Tip

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.