Audience Menu Guide

The Audience section of the dashboard contains information about your app or website users, and tools to help you effectively target your messages.

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

Segments

Segments are predefined groupings of your audience that you can construct using combinations of Tags, Lists, Device Properties, and Location, using the Segments Builder.

Learn more in the Segments Builder Tutorial .

Lists

Use Audience Lists to create recipient groups based on either your own uploaded data or automatically generated lifecycle information.

Uploaded Lists must be in CSV format, with a maximum of 10 million rows and a maximum file size of 1.5 GB.

Lifecycle Lists capture app open, uninstall, notification, and dormancy information. Lifecycle List auto-generation may be disabled.

Uploaded

When you navigate to Audience » Lists, the default tab is Uploaded, where you will see either “no lists” or previously created Uploaded Lists.

Five attributes are displayed per list:

  • Name and description
  • Status: Ready indicates that your list may be used as a message recipient group. Processing indicates that our servers have not yet completed the upload. Failed indicates that your list failed to upload.
  • Devices: The number of channels associated with the list. Note that this count simply reflects the number of valid channel identifiers associated with a given list. Uninstalled channels may still be reflected in the channel count, meaning that sending to a list may result in a send count lower than the channel count. Read additional detail in Uploaded List Tutorial: Troubleshooting.
  • Created: The creation date of the list.
  • Last Modified: The date the list was last edited.

Lists are sortable by Name, number of Channels, Date Created, and Date Last Modified.

Attribute information may contain a combination of values from both the last uploaded list and the last successfully processed list. For example, if the processing step fails after you edit an existing list, the Status indicator will read Failed, but Devices and Last Modified will display information from the last successfully processed list.

You can create up to 100 Uploaded Lists per application. Because lists are static, they can become outdated very quickly. We encourage active curatation of lists, updating them with current data as frequently as possible.

Lists containing 100+ devices that have not been used for message delivery or updated in the past 90 days will be automatically deleted.

Create an Uploaded List

Learn how to create your own audience list using the Uploaded List Tutorial.

Lifecycle

Lifecycle Lists are automatically generated Audience Lists that capture data about your users’ app opens and notification receipts. This data can be used to target users based on app activity. For example, with Lifecycle Lists you have a built-in recipient list of all users who have opened your app in the past 7 days.

Navigate to Audience » Lists and click the Lifecycle tab. If it is your first time using Lifecycle Lists, click the Turn On button.


Once initially enabled, your first Lifecycle Lists will be available in 24 hours. The delay is necessary in order to populate the minimum data required for the shortest time interval: Last Whole Day.

You can turn off this feature at any time after your first lists are generated. At the top of the Lifecycle tab, toggle to disable.

List Types

  • First App Open: Opened the app for the first time within the given time interval.
  • Opened App: Opened the app within the given time interval.
  • Uninstalls: Devices that have been marked as uninstalled within the given time interval. Note that you must attempt to send a push to an uninstalled device before our system marks it as uninstalled. For details, please see Detecting Uninstalled Devices.
  • Sent Notification: Devices that have received a notification within the given time interval.
  • Direct Opens: Opened the app directly from a notification within the given time interval.
  • Dormant: Given a time interval X, the dormant list contains users that have not opened the app in the last X days, but did open the app at least once in the X days prior to not opening the app. Tooltips provided in the UI give actual values.

Android devices with faulty registrations may be included in the Uninstalls list regardless of whether or not they have an active installation of your app. Consequently, the Uninstalls list may contain a small number of devices that have not actually uninstalled your app.

See error “Unregistered Device” in Android’s Downstream message error response codes.


List Detail

Each list type has three time intervals: Last Whole Day, Last 7 Days, and Last 30 Days. Whole Day is defined as a period of time commencing and terminating at midnight UTC.

Each list type’s pane displays its name, definition, and the following per time interval:

  • Processing status indicator: A green circle with a check mark has hover text “Successfully processed.” A yellow triangle with an exclamation point has hover text “Failed to process. Please contact support@urbanairship.com.”
  • Time interval days, dates, and time zone.
  • Last Processed day, date, and time zone.
  • Download CSV link: See the Lifecycle List Tutorial for usage information.
  • Devices count: The number of channels associated with the list. As with Uploaded Lists, the Devices count includes both users who are opted-in and opted-out of push. For example, if you send a push to a list of 1,000 devices where 600 of the devices are opt-in, only 600 devices will receive that push, whereas an in-app message would go to all 1,000 devices. This distinction between a list’s Devices count (total devices) and opt-in devices is important to know when viewing a push-to-list’s Total Sends metric — Total Sends will correspond to opt-in devices rather than the Devices count.

Download a Lifecycle List

Learn how to download and use a Lifecycle List using the Lifecycle List Tutorial.

Sending to Lists

Select the radio button for Target Specific Users when defining your audience in the A/B Tests or Message composer. See Target Specific Users for detail.

To send to a list via the API, see the Static Lists API documentation.

If a Lifecyle List or Uploaded List is processing, you will not be able to send to the list until processing has finished.

If you edited an Uploaded List and it is still processing, you can still send to the list, but the recipients will be from the pre-edited version.


Test Devices

When selecting your audience in the A/B Tests or Message composer, you have the option Test Devices, which is a predefined recipient group. Once you are satisifed with a trial message sent to Test Devices, just change the audience type and send your live, production message.

By keeping a saved list of approved test devices in the Urban Airship dashboard, you can be sure that during testing messages will only reach the specific devices on your list. You might limit these to company employees such as Product staff, Development team, et cetera.

The Test Devices feature is supported on Android and iOS devices, and requires an Enterprise Edition account. Only Administrators can create a Test Devices list. See the Team Access settings for more information about user roles.


Setting Up Test Devices

Enter up to 100 comma-separated Device Tokens and Android Channels, then click the Save button. Only registered device identifiers that have not been uninstalled can be entered.

Administrators may edit and save changes to the Test Devices list at any time.

Sending to Test Devices

Select the radio button for Test Devices when defining your audience in the A/B Tests or Message composer.

How to Find Your Device Identifier

Mobile Devices

You must build into your app a mechanism to expose the device identifier to the console:

You can view the console with these tools:

iOS

Android

If you didn’t write the device identifier to the console, you can use the steps here to help retrieve it: Using Charles Proxy to profile an Urban Airship Implementation.

Web Browsers

To access your web channel ID, you will need to open the Developer console in your browser and paste in a small amount of code. Instructions for Google Chrome and Mozilla Firefox are provided.

  1. Open the console via keyboard shortcut or the menu.

    Google Chrome Keyboard Shortcuts: In macOS you can go directly to the console with Cmd+Opt+J. In Windows, the shortcut is Ctrl+Shift+J.

    Google Chrome Menu: Click the three dots to the right of the address bar, select More tools… » Developer tools, then select the Console tab.

    Mozilla Firefox Keyboard Shortcuts: In macOS you can go directly to the console with Cmd+Opt+K. In Windows, the shortcut is Ctrl+Shift+K.

    Mozilla Firefox Menu: Click the three horizontal lines to the right of the address bar, click the Developer icon, then select Web Console. It will open to the Web Console tab.

  2. Paste UA.then(sdk => {console.log(sdk.channel.id)}) in the console, then hit Enter. The resulting line is the channel ID.

Device Lookup

Information about an individual device can be found by looking up a Channel ID, Named User ID, or Device Token. Enter a device identifier into the search bar.

If a valid identifier was entered, you will see a display with information about associated devices. This example shows the results for a Named User ID search, including Created and Last Modified dates for the Named User itself, as well as information for each device associated with the Named User.

Depending on the ID type queried and data available, results may include:

Channel ID, Named User ID, or Device Token
Installation, Opted In, and Background status indicators
Created date
Last Registration date
Aliases
Push Address
Tags
Timezone
Language Country
Language
[OS] Model
[OS] Version
[OS] UA SDK Version
[OS] App Version
Location Enabled status
Push Notification Opt-in status
Background Enabled status
Channel Type
Web SDK Version
Browser Name
Browser Type
Browser Version

Device Tokens

A device token is an identifier for the Apple Push Notification System (APNS) for an iOS device (iPhone or iPad).

This page lists all iOS device tokens associated with your app and returns the following information per device token:

Created date
Last Registration date
Status
Alias
Tags

See: Apple’s APNS documentation.

Android Channels

Channels are a type of Urban Airship push identifier for Android, Windows 8, and Windows Phone 8 devices. When an end user runs your application for the first time after installing it, a Channel is created and returned to Urban Airship. As of the Android 5.0 SDK, Airship Push Identifiers (APIDs) are known as Android Channels.

This page lists all Android Channels associated with your app and returns the following information per Android Channel:

Created date
Last Registration date
Status
Alias
Tags
FCM Registration ID

See the Channels Primer.