Selecting Your Audience

You can send messages to your total audience or just a section of users.

When you create a message, you select your audience, which is both:

  1. The ChannelsA communication medium supported by the Airship service. Supported channels include app, web, email, SMS, and Open Channels. Within some channels there may be specific platforms with individual characteristics. Example platforms include Chrome for the web channel and Android for the mobile app channel. you want to send your message to.
  2. The users on those channels who you want to receive your message.

Your options for selecting channels and users varies based on the kind of message you want to set up.

ComposerAPI EndpointChannel SelectionUser Selection
Message/pushRequiredRequired
A/B TestUsed to send variants of a message to cross-sections of your audience. Each variant in the test returns data to help you determine the most effective ways to engage your audience. A/B tests support up to 26 variants and a control group per test./experimentsRequiredRequired
AutomationA set of conditions that your audience must meet before they receive a message./pipelinesRequiredDetermined by its TriggerAn event that initiates an automation or journey. and conditions.
JourneyA series of messages that is initiated by a single automation trigger. Airship sends messages in the series based on your timing settings, and you can also set conditions that determine the continuation of the series.Not supportedRequiredDetermined by its TriggerAn event that initiates an automation or journey. and conditions.
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. Messages sent using in-app automation can be styled as a banner, modal, or fullscreen.Not supportedApp channel only, so there is no channel selectorRequired. Determined by the selected users and its TriggerAn event that causes an In-App Automation message to appear to your audience. and conditions.
Apple NewsA news aggregator for iOS and MacOS. An Apple News notification is a push notification that links to an Apple News story. Apple News notifications are available to select publishers. If you are interested in sending Apple News notifications, please contact your Airship Account Manager.Not supportedApple News channel only, so there is no channel selectorN/A. Apple News messages are delivered through the Apple News app. This audience is defined by Apple.

In the Message, A/B Test, Automation, and In-App Automation ComposersA tool for creating messages via the dashboard. Composers are defined by what you can include and control: message types, delivery, and automation. , you select channels and/or triggers in the Setup and Audience steps. For Journeys, you make these selections in the Trigger step and when you create each message in the journey.

Automation example:

User selection is represented as:

  • All Users: Sends the message to your entire audience.

  • Target Specific Users: Create a recipient group based on metadata associated with individual users like tags, attributes, etc. See: Segmentation.

  • Test Users: Send to a predefined group of test users. Read about test groups below.

  • Upload Users: Upload a list of users just before sending the message. See: Audience Lists: Inline Lists.

Test groups

A test group is a reusable audience group that can be used as a recipient for test messages. Messages you send to a test group appear as tests in Messages Overview. By keeping a saved list of approved test users in Airship, you can be sure that your test messages only reach an approved, in-house list of users. You might limit your test group to company employees such as Product staff, Development team, etc.

You can create up to twenty test groups. Follow the steps in Manage Test Groups.

Selecting an audience in the API

In the API, you select the channels you want to send your message to with the device_types array, and the users you want to send your message to using the audience selector object.

Basic audience selection
{
    "device_types": [ "ios", "android", "sms" ],
    "audience": {
      "tag": "needs_a_greeting",
      "group": "new_customer"
    },
    "notification": {
        "alert": "Hello!"
    }
}