Messages Menu Guide

The Messages section of the dashboard contains message history, message personalization, logs, tools, and more.

Choose your project from the Urban Airship dashboard, click the Messages dropdown menu, and make your selection. Each section’s purpose and options are detailed below.

Messages Overview

Messages Overview is where you can view and manage your sent, pending, and draft messages. Four tabs organize your messages by status and type: History, Drafts, Scheduled, and Automated. Available message actions vary per tab.

History

The History tab lists messages that you have already sent. Please note that this only includes messages that were delivered immediately. Scheduled and Automated messages have their own tabs.

The default view is sorted by delivery date, newest messages first. Click the Delivery column header to toggle ascending/descending order.

  • Message: The message text.
  • Platforms: The platform(s) selected for delivery.
  • Audience: The audience selected for delivery. For any type shown in blue, hover to see its value(s).
  • Delivery: The date, time, and time zone when the message was delivered.

Click an action icon at the end of a message row.

Plus sign = Duplicate Message
Creates a copy of the message and opens it in its composer of origin. You must complete the composer steps in order to send the new message.
Eye = Preview Report
Expands the row, displaying metrics from the Message Report. Click the icon again to collapse the preview. Available metrics vary per message type. Click the question mark icon next to each for its definition.
Histogram = View Full Report
Opens the full Message Report. To return to the History list, click your browser’s Back button or the view all messages link above the report title.

Click Expand All and Collapse All to expose and hide Preview Reports for all listed messages.

Drafts

The Drafts tab lists messages that you saved instead of sending or scheduling.

The default view is sorted by creation date, newest messages first. Click the Delivery column header to toggle ascending/descending order.

  • Message: The message text.
  • Platforms: The platform(s) selected for delivery.
  • Audience: The audience selected for delivery. For any type shown in blue, hover to see its value(s).
  • Delivery: The messages’s delivery type, Immediately or Automated, or, for Scheduled messages, a date, time, and time zone.

Because the messages listed here are drafts, most will not have all of the column data populated. Any data that has not yet been specified is indicated with “–”.

Click an action icon at the end of a message row.

Trash can = Delete message
Deletes the message.
Pencil = Edit message
Opens the message in its composer of origin.

Scheduled

The Scheduled tab lists messages that are scheduled to be sent at a later date.

The default view is sorted by scheduled date and time, most recent date first. Click the Scheduled Date column header to toggle ascending/descending order.

  • Message: The message text.
  • Platforms: The platform(s) selected for delivery.
  • Audience: The audience selected for delivery. For any type shown in blue, hover to see its value(s).
  • Scheduled Time: The message’s future delivery date and time, and time zone.
  • Status: Pending is displayed for any message scheduled for a date and time that have not yet occurred. In Progress is displayed for a message that has started but not yet completed delivery by time zone.

Click an action icon at the end of a message row.

Pencil = Edit message
Cancels the scheduled delivery, saves the message as a draft, and opens the message for editing.

To delete one or more scheduled messages, check the box at the end of a row, then click the Delete Selected button that appears at the bottom of the list. After deletion, a confirmation banner will appear below the navigation header.

Automated

The Automated tab lists all active and paused Automated messages.

The default view is sorted by the date and time the Automated message was activated, most recent date first. Click the Started column header to toggle ascending/descending order. The list is also sortable by Message Name.

  • Message Name
  • Messages: The text of the alert.
  • Platforms: The platform(s) selected for delivery.
  • Trigger: The event type that triggers sending the message. Hover to see its value.
  • Started: The date, time, and time zone when the message was first activated.
  • Status: Whether the message is Active or Paused. Active messages have dropdown menu options to Pause or Cancel. Paused messages have dropdown menu options to Resume or Cancel. Cancel deletes the messsage.

Click an action icon at the end of a message row.

Pencil = Edit message
Opens the message for editing.
Plus sign = Duplicate Message
Creates a copy of the message and opens it for editing. You must complete the composer steps in order to send the new message.
Eye = Preview Report
Expands the row, displaying metrics from the Message Report. Click the icon again to collapse the preview. Available metrics vary per message type. Click the question mark icon next to each for its definition.
Histogram = View Full Report
Opens the full Message Report. To return to the History list, click your browser’s Back button or the view all messages link above the report title.

Click Expand All and Collapse All to expose and hide Preview Reports for all listed messages.

Search and Filter

Narrow down your list with Search and Filter.

  • Search: Enter a complete or partial message name.
  • Filter: Event triggers turn grey when selected. Options are:

First Open
Inactivity
Tags Added
Tags Removed
Location Entered
Locations Exited
Event
Status: Active and Paused turn grey when selected. Only one may be selected at a time.

Automation Limits

Below the message list, on the right side of the page is the Automation Limits status indicator and counter. Click the pencil icon to open your project’s Configuration settings. Click the Automation Limits tab, and make and save your desired changes.

Templates

See: Message Personalization Tutorial.

A/B Tests

A/B Tests is where you can view and manage your sent, draft, and scheduled A/B Tests. Three tabs organize your tests by status: History, Drafts, and Scheduled. Available test actions vary per tab.

Each tab’s default view is sorted by the creation date, newest test first, with the following columns.

  • Test Name: The name entered when creating the test.
  • Platforms: The platform(s) selected for delivery.
  • Audience: The audience selected for delivery. For Target Specific Devices, click to see its value(s).
  • Number of Variants
  • % of Total Audience Tested
  • Control Group: The percentage of the audience not receiving a test.
  • Delivery: The History tabs displays the date, time, and time zone when the message was delivered. The Drafts tab displays either delivery type Immediately, or a date, time, and time zone for tests with scheduled delivery.
  • Scheduled Time: The Scheduled tab displays the test’s future delivery date and time, and time zone.

History

The History tab lists tests that you have already sent.

Click an action icon at the end of a test row.

Plus sign = Duplicate
Creates a copy of the test and opens it for editing. You must complete the composer steps in order to send the new test.
Histogram = View Full Report
Opens the A/B Test Report. Click your browser’s Back button to return to the History list.

Drafts

The Drafts tab lists tests that you saved instead of sending or scheduling.

Because the messages listed here are drafts, most will not have all of the column data populated. Any data that has not yet been specified is indicated with “–”.

Click an action icon at the end of a test row.

Trash can = Delete test
Deletes the test.
Pencil = Edit test
Opens the test for editing.

Scheduled

The Scheduled tab lists tests that are scheduled to be sent at a later date.

Click an action icon at the end of a test row.

X = Delete Scheduled A/B Test
Deletes the test.
Pencil = Edit Scheduled A/B Test
Opens the test for editing.
Plus sign = Duplicate A/B Test
Creates a copy of the test and opens it for editing. You must complete the composer steps in order to send the new test.

Apple News

Apple News is where you can view the Apple News messages that were sent to your Apple News audience.

One year of message history is listed, newest first, with the following columns.

  • Message: The message text.
  • Story: The associated Apple News story’s title. Hover over the title to see its canonical URL, or click to follow the link.
  • Countries: The recipient country. One of All, United States, United Kingdom, or Australia.
  • Send Requested: The date, time, and time zone when the message composer steps were completed by clicking the Send Now or Send When Live button.

After sending a message via the Apple News composer, a delivery request is sent to Apple. Because Urban Airship does not manage the delivery process, the Send Requested date and time may differ from the actual delivery date and time.

Projects that have been inactive for over 30 days will have all message history removed.


Activity Log

The Activity Log is a unified list of all your messaging activity from both the UI and the API, excepting unicast and Automated messages.

Unicast pushes are not included because they could theoretically make the Activity Log unmanageable. For example, a large app could send millions of unicast pushes in a single day, causing the Activity Log to be flooded with these messages and obscuring any other useful information.

The default view is of the last seven days, sorted by sent date, newest messages first, with the following columns.

  • Message: The name of the message. Click to open its Message Report. To return to the Activity Log, click your browser’s Back button or the view all messages link above the report title.
  • Sent: The date, time, and time zone when the message was sent.
  • Delivery Type: Experiments are groups of messages that are part of an A/B Test. All other messages are Engagement.
  • Platform: The platform(s) selected for delivery.
  • Audience: The audience selected for delivery. Click Details to see its value(s).
  • App Notification Sends: The number of notifications containing user-alerting elements (text, badge, sound) sent to users opted in to push.
  • Direct App Opens:
    • The number of app opens that directly resulted from this notification. Includes Landing Pages, Deep Links, URLs, and Event Tags.
    • The Direct App Open Rate, calculated as the percentage of Direct App Opens / App Notification Sends.
  • Influenced App Opens:
    • The number of app opens that directly or indirectly resulted from your notification. See the Push Influence Primer.
    • The Influenced App Open Rate, calculated as the percentage of Influenced App Opens / App Notification Sends.
  • Web Sends: The total number of web notifications sent to all devices.
  • Web Clicks:
    • The total number of web notifications clicked on by a user.
    • The Web Click Rate, calculated as the percentage of Web Clicks / Web Sends.
  • Rich Page Sends: The number of Message Center Rich Pages sent to all devices.
  • Rich Page Views:
    • The number of users who viewed this Message Center Rich Page at least once.
    • The Rich Page View Rate, calculated as the percentage of Rich Page Views / Rich Page Sends.

Not applicable to Web Notify: Influenced Opens, Rich page Sends, Rich page views.

View Options

You may change the date range and download a CSV file of the chosen range.

Date Range

Click the Last 7 Days dropdown menu to change the date range. Options are:

Last 7 Days
Last 2 Weeks
Last 30 Days
Last Month
Last 3 Months
Last 12 Months
Today
Yesterday
Custom Range

After selecting Custom Range, dates will appear to the left of the dropdown menu. Click each date and make your selection from the calendar that appears. The Activity list updates after you make each date selection.

Download CSV File

Data exported to the CSV file is limited to what appears in the displayed list. If the Show More button is at the bottom of the list, click the button until the desired number of entries are listed.

Click the Download CSV of Current View button. Download to your default download location is immediate.

Welcome Message

The Welcome Message feature is a default rich page that will appear in every new user’s Message Center upon opening the app for the first time.

Welcome Message is not supported for Web Notify at this time.

To implement this feature, you must have Message Center integrated with your application. Message Center ships with the SDK 7.0+. Otherwise, please see the rich push documentation for your chosen platform(s):

  1. Enter the Title of the rich page.
  2. Enter the HTML that will be the message body.
  3. Click the Save button.

If you no longer want to send a welcome message, click Delete welcome message. After deletion, a confirmation banner will appear below the navigation header.


RSS Feeds

You have the option to integrate an RSS Feed with your push messaging.

RSS Feeds are not supported for Web Notify at this time.

Add a New RSS Feed

  1. Enter the source URL.

  2. Enter the feed Template content, using values:

    {{ title }}: The title of the feed item.
    {{ description }}: The description of the feed item.
    {{ author }}: The author of the feed item.
    {{ url }}: The URL of the feed item.

  3. Click the Add Feed button.

The Template field contains the message content (in the form of a Push API request) for messages generated by this RSS Feed. The Template should be a message skeleton, rather than a specific push message. Using the provided values, you can create a generic message frame.

{
   "audience": "all",
   "notification": {
      "ios": {
         "alert": "New item! - {{ title }}"
      },
      "android": {
         "alert": "Android users - {{ title }}"
      }
   },
   "device_types": ["ios", "android"]
}

The example is a standard Push API request, with the one difference being the {{ title }} value. So if a feed item with the title “Mayor Runs for Re-election” is posted:

  • iOS users will receive the message “New item! - Mayor Runs for Re-election”
  • Android users will receive the message “Android users - Mayor Runs for Re-election”

Manage RSS Feeds

At the bottom of the page is a list of your currently active RSS Feeds.

To edit a feed’s URL or template, click its Edit button, make your desired changes, and click the Save Updated Feed button. To return to RSS Feeds, click the Messages dropdown menu and select RSS Feeds.

To delete a feed, click its Delete button.