Send Push Notification To Contact Using Airship

Overview

Use your existing Airship integration to send push notifications right from Simon, triggered by segments and events.

To get started, create a flow (one-time, triggered, or recurring) or a Journey, then choose Send Push Notification To Contact:

257

Configuration Parameters

Title, Action, and URL

1120
ParameterDescription
Name (Journeys Only)Optionally, update the name to display in the Journey block. Keep in mind each block must have a unique name, in case you're using this action in other parts of your Journey.
Note (Journeys Only)Optionally, add a note to remind yourself why you placed the action here.
Message TitleOptionally, include a message title. This appears in bold when customers receive their notification on their mobile device. You can use any of the custom contexts described below.
Message ActionYou have three options here:

Home Screen : Customers click to be taken to your Airship client app homepage. (This link is configured via your Airship Default Action URL).

Opens to a deep link : Links to a location in your native iOS or android mobile app. If you select this, enter your desired Deep Link URL in the field that appears below the drop down. You can use any of the custom contexts described below.

Opens to a web page: When clicked from the message, opens a webpage in a mobile browser (like Safari on Apple iPhone). If you select this, enter your desired Web Page URL in the field that appears below the drop down.

Message and Preview

Compose a message using plain text and Custom context basics. A realtime preview displays in the right pane.

901
  • From the Contact Tab, select any contact properties in Simon to personalize the push. For example, you could choose a first name property to personalize your greeting to the receiver.
  • From the Lookup Tab, select any previously created lookups to use in your message content.
  • From the Blocks Tab, select any existing content blocks you want to use in your message.

Select Suppression

You can keep contacts that fall into a specific Airship Segment or Airship Tag by selecting a suppression type and then choosing the respective Segment name or entering the Tag name. You can choose include either one Segment or one Tag to suppress by.

Note, in a Journey you need to toggle this option on to see the Segment or Tag option.

575

Frequency Cap (Flows Only)

Choose a frequency cap. Your options are a combination of:

  • Max Sends per Period: Your push notification will send this many times per the period you choose in the right drop down. You can choose 1, 2, 3, 4, 5 or Unlimited sends (per the period you choose to the right).
  • Period: You can choose 1, 7, 14, 30, 60, 90, 180, 365 days, or N/A for no boundaries.
812

Flow Metadata

You can add metadata in a flow to be sent to Airship. We do send some default metadata for you including:

  • SD_FN\tFIRST_57_FLOW_NAME
  • SD_FID\tFLOW_ID
  • SD_FVN\tFIRST_55_FLOW_VARIANT_NAME
  • SD_FVID\tFLOW_VARIANT_ID
461

Metadata Value Pairs

You can copy the name/value pairs from a previous flow by selecting the flow name from the drop down, or you can add new pairs:

  1. Click Add.
  2. Include a Name and Value.
  3. Toggle the Bell on/off to alert if there's empty Custom context basics.
  • Click Edit to select and preview the value directly from Contacts, Lookups, or Blocks.
  • You can add an unlimited number of metadata name/value pairs. Any metadata you add here flows through the channel and then back to Airship where they're called Campaign Categories .

Journey Metadata

Airship supports custom metadata via Custom context basics and Airship’s Campaign Categories feature. In addition, the following campaign categories are populated by default when you use this action in a Journey:

  • SD_FN\tFIRST_57_CAMPAIGN_NAME
  • SD_FID\tCAMPAIGN_ID
  • SD_FVN\tFIRST_55_VARIANT_NAME
  • SD_FVID\tVARIANT_ID

🚧

Note

Airship is very strict with the number and size of campaign categories. You can only have 10 campaign categories; we use four, so only six remain for the you to define after.

Campaign categories can only be 64 characters long; we truncate flow and flow variant names to meet this criteria (as well as your defined campaign categories).

Journey History Metadata

See Journey History Metadata.


Send A Test (Optional)

Optionally, but recommended, send a test to preview what your message will look like. Include an email you can check, then click Send.

1124

Click OK to save your settings, then complete the flow as usual or review Journeys 2 Guides.


How this Action Functions by Flow

Channel actions behave differently when used in different flows. The table below describes this action's functions for each flow type.

Flow TypeFunction
One-TimePush notifications sent in batches of 100 max
Triggered (Recommended)Sends a Push Notification when a newly added contact joins a segment or and event triggers the flow
Stream N/A
RecurringSends a Push Notification to all newly added contacts on a scheduled basis

Related Documents