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

Open your project from the dashboard, then click Audience 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.

For detail about each list type, see: Audience Lists.

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.

Warning

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 curation of lists, updating them with current data as frequently as possible.

Warning

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 or Use static lists.

Lifecycle

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

Note

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

See: Audience Lists: Lifecycle.

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 Test and Message workflows. See Target Specific Users for detail.

To send to a list via the API, see the Static Lists API documentation and Use static lists.

Note

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 Groups

Important

Test Devices was renamed to Test Groups. Changes:

  1. You can now maintain multiple lists of test users.

  2. If you had an existing Test Devices list, it is now a Test Group named devices.

Send trial messages to Test Groups. First create a group of test users, then send them the trial message. Once you are satisfied with the trial message, just change the audience selection and send your live, production message.

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

Edit or delete existing test groups by clicking the pencil and trash can icons.

Note

Only Administrators can create Test Groups. See the Team Access settings for more information about user roles.


Creating Test Groups

  1. Click Create Test Group.

  2. Enter a name for the group of test users, then click Create, or cancel to discard.

  3. Click Add Test User, then enter a User Name and User Identifier.

    • User Name: Either provide a personal name or description to identify this user.
    • User Identifier: Enter a channel ID or email address.
  4. Click Add, or cancel to discard.

Edit or delete existing test users by clicking the pencil and trash can icons.

Sending to Test Groups

Select Test Users when defining your audience in the Message or A/B Test workflows or when testing an Email Template, then select from the Test Groups dropdown menu.

Select Test Devices when defining your audience in the In-App Automation workflow, then select from the Test Groups dropdown menu.

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 field. Results update as you type.


If a valid identifier was entered, information about associated devices is displayed below the search field. This example shows the results for named user ID kristina, including Created and Last Modified dates for the named user itself, as well as information for the device associated with the named user.


Click the device pane to open a modal window containing detail about the device, organized on tabs: Channel Detail, Channel Tags, Device Properties, and Tag Groups.


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

Note

If you are a Predictive Send Time customer, Optimal Send Time data is included in results.

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: Channels.