Actions in the WYSIWYG editor

Associate actions with the buttons, images, and links in your messages.

When using the WYSIWYG editor for email, Rich PagesA landing page or Message Center message in your app that can include HTML, video, etc., and In-App AutomationMessages that are cached on users’ devices and displayed when your users meet certain conditions within your app, such as viewing a particular screen or opening the app a certain number of times., you can assign an action that occurs when a user taps a button, link, or image in the message. You can also use 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. to personalize the actions.

Configuring actions

Configuring actions for links is the same for all text in the WYSIWYG editor. Configuring actions for images and buttons differs for app and email content.

Buttons and images: App

Follow these steps to configure actions for buttons and images in landing page, Message Center, and in-app automation content.


  1. Select a button or image in your app content, then configure Action in the sidebar.

  2. Select and configure an action.

  3. (Optional) Enter an event name to differentiate the clicks for the button.

    By default, the total clicks for all buttons and images in the message 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, including 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. ua_button_tap. You can enter your own event name instead. This name is appended to the default. For instance, if you enter Cat socks55, the event name in reporting will be ua_button_tap-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..

  4. (Optional for landing pages only) iOS SDK 14.2+Android SDK 14.1+ Check the Landing page behavior box if you want the landing page to close after the selected action occurs. When the user reopens your app, the landing page will no longer be open.

  5. (Optional) Add or remove tags when a user taps the notification:

    1. Click Configure options.
    2. Select Add or Remove, then search for tags that exist in the system or create a new tag.

    Click Configure another option to add more tags.

Buttons and images: Email

Follow these steps to configure actions for buttons and images in email content.


  1. Select a button or image in your email content, then configure Action in the sidebar.

  2. Select and configure an action.

Follow these steps to add links in Heading and Text elements in app and email content.


  1. Select text in your message and click the Link option.
  2. Select and configure an action.
  3. Click Save.

App actions for buttons and images

Supported actions for app buttons and images.

ActionIn-App AutomationLanding page and Message Center
Adaptive Link
App Rating
Deep Link
Dismiss Message
Preference Center
Push Opt-in
Share
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 Wallet 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.

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:

App rating prompts will process as configured by your message settings, but the displayed dialog is controlled by Apple, not Airship.

 Important

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:

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

A quick way to find the Apple ID is to copy the numbers at the end of the app’s App Store URL. If the URL is https://apps.apple.com/app/id1195168544, the Apple ID is 1195168544.

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.

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 are example template URLs:

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

yourapp://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

yourapp://products/1872983490

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

Dismiss message

Dismiss Message closes the message.

Preference center

Preference Center opens an app preference center. Select a preference center from the list.

Push opt-in

Push Opt-in opens the system prompt for push notification opt-in. Device behavior differs depending on opt-in status:

  • If a user has not previously opted out, they will see the system prompt after clicking the button.
  • If a user previously opted out, the app settings will open after clicking the button, and they can opt in from there.

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.

Supported actions for:

  • Email buttons, links, and images
  • App (landing page, Message Center, in-app automation) links
ActionEmailApp (Links only)
Call phone number
Confirm subscription
Open unsubscribe page
Open website
Send email
Unsubscribe from all
Unsubscribe from current list

Call phone number

Call phone number initiates a call from the device. Enter a phone number.

Confirm subscription

Confirm subscription opts the user into email messaging when using Double Opt-InA process where users who sign up for messaging must confirm opting in before they can receive messages..

Enter the URL for your confirmation page or enter one of the following URLs for the default confirmation page. For the default page, use the URL that matches your data center location:

  • US: https://asemailmgmtus.com/opt-in/success.html
  • EU: https://asemailmgmteu.com/opt-in/success.html

See also: Email double opt-in links.

Open unsubscribe page

Open unsubscribe page opens a link to your custom unsubscribe page, where users can opt out of messaging. When using a custom unsubscribe page, you do not need to include an unsubscribe link for opting out of all messaging.

Enter the URL for your custom unsubscribe page.

Open website

Open website 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, then select whether the link should open in the same (current) tab or a new tab.

Send email

Send email creates a draft email in the device’s default mail client, with preset data defined here. Enter:

  • Mail To — Email address the message should be sent to
  • Subject — Text
  • Body — Text

Unsubscribe from all

Unsubscribe from all opts the user out of:

  • All commercial emails if used in a commercial email
  • All commercial and transactional email if used in a transactional email

This action is not recommended for transactional email.

Enter the URL for your confirmation page or enter one of the following URLs for the default confirmation page. For the default page, use the URL that matches your data center location:

  • US: https://asemailmgmtus.com/unsubscribe/success.html
  • EU: https://asemailmgmteu.com/unsubscribe/success.html

See also: Email unsubscribe links.

Unsubscribe from current list

Unsubscribe from current list unsubscribes the user from the Subscription List(s)An 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. specified when defining the message audience.

Enter the URL for your confirmation page or enter one of the following URLs for the default confirmation page. For the default page, use the URL that matches your data center location:

  • US: https://asemailmgmtus.com/unsubscribe/success.html
  • EU: https://asemailmgmteu.com/unsubscribe/success.html

See also: Email unsubscribe links.

 Important

Whenever you include an unsubscribe link for a specific list, you must also include an unsubscribe link for opting out of all messaging.