Segments

A segment is a grouping of audience members selected by unique or shared identifiers. Multiple identifiers can be combined within a segment.

You can build a segment using unique identifiers or by an identifier that may belong to or include multiple users, such as a tag, attribute, or event, and even other segments. See Segment Data on this page. See also: Segmenting Your Audience.

 Note

Create a new segment

Segments are sets of audience conditions organized in blocks. A block contains one or more conditions, providing a way to mix and match boolean operators. For example, you might use an OR operator for conditions in a block, and use an AND operator to join the blocks together.

  1. Go to Audience » Segments and click Create Segment.

  2. Enter a name and description, then click Save and continue. You will find your audience segment by name when creating messages.

  3. Search for or select segmentation data.

  4. Set the operator — True/False, Equals/Does not equal, etc. See next steps for configuring device properties, attributes, and events.

    • True/False determines whether to include users for whom the condition is true or false.
    • Predicted to Churn does not have operators.
  5. (Device properties only) Select an operator, search for or enter a value, then click outside the field or hit Enter on your keyboard to save the value. Repeat for multiple values. Multiple values are evaluated as a boolean OR. No configuration is required for operators Empty and Not Empty.

     Note

    • Equals and Does not equal are the default operators for device properties. To make all operators available, go to Settings » Configuration » Feature Settings and enable Segment Operators. This feature requires SDKs iOS 13.2.0+ and Android 13.0.0+.

    • When using the device property Application Version, SDK Version, or Device OS Version, only semantic versioning formatting is accepted, and anything after the third decimal place is excluded, e.g., 12.2.3-alpha is compared as 12.2.3.

  6. (Attributes only) Select an operator, then configure values or dates.

    TEXT and NUMBER attributes Click Add a value and enter a value in text or number format, then click outside the field or hit Enter on your keyboard to save the value. Repeat for multiple values. Multiple values are evaluated as a boolean OR.
    DATE attributes

    Configure a date or range. Availability and requirements depend on the operator.

    • Specific — Select a Year/Month/Day. With the Equals and Does not equal operators you can also use formats Day, Month, Month/Day, and Year/Month.
    • Relative — Specify the number of years/months/days/hours/minutes from today’s date.
    • Today — With the Equals operator, select Month/Day or Year/Month/Day. With the After and Before operators, Year/Month/Day is the only option and is preselected.
     Note

    For the Between operator, the end date is not inclusive, e.g., selection Between July 5 - July 17 includes dates July 5 to July 16.

  7. (Events only) Choose whether or not the event was performed, set the frequency of occurrence, and configure options.

    1. Select Performed event, First performed event, Last performed event, or Did not perform event.

    2. For Performed event and Did not perform event, select an operator and configure the frequency of the event.

    3. (Optional) Click Specify when to target when the event was performed, then select an operator and configure a date or range.

      Availability and requirements depend on the operator.

      • Specific — Select a Year/Month/Day. With the Equals operator you can also use formats Month/Day, and Year/Month.
      • Relative — Specify the number of years/months/days/hours/minutes from today’s date.
      • Today — Select Month/Day or Year/Month/Day.
       Note

      For the Between operator, the end date is not inclusive, e.g., selection Between July 5 - July 17 includes dates July 5 to July 16.

    4. (Optional) Filter events using numeric values associated with the events, or by key/value properties attached to the events. Filtering events this way can help you more precisely target your audience.
      1. Click Add Property and search for a property, or click Add Event Value.
      2. If applicable, select the operator you want to use to evaluate the value or property.
      3. Enter a value, then click outside the field or hit Enter on your keyboard to save the value. Repeat for multiple values. Multiple values are evaluated as a boolean OR.
      4. (Optional) Click Add Property or Add Event Value to add more filters.
      5. Select AND/OR to determine how to evaluate multiple filters and alternatives within each filter.
        • AND = all criteria must be met
        • OR = any criteria must be met
  8. (Optional) Add or edit conditions.

    • Click   to change your selection within a condition, e.g., change a tag from airship to starship.
    • Click   to add a condition to a block.
    • Click Add a block   and configure additional conditions.
    • Click   to duplicate or delete conditions and blocks:
      •   Duplicate a condition.
      •   Delete a condition. Deleting all conditions in a block deletes the block. After creating additional blocks, you can hover over a block and click Edit block   to make changes.
  9. Set the logic between conditions or blocks:

    • AND = all conditions must be met
    • OR = any condition must be met
  1. Click Save and exit.

Generate audience count

You can calculate the number of Channel IDsAn Airship-specific unique identifier used to address a channel instance, e.g., a smartphone, web browser, email address. included in segments you create in the dashboard.

 Note

  • Calculations can take multiple minutes to complete, depending on audience size and query complexity.

When creating segments using the Segment Builder and with the Target Specific Users option in the Message and A/B Test composers, click Generate Audience Count to see the counts for the segment and for each block in the segment. A progress bar appears until the calculation is complete. Click Regenerate Audience Count after adding or removing criteria.

After generating the count in the Segment Builder, click   /   to view the number of channel IDs per engagement channelA 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. for each block or the entire segment. The expanded view for the entire segment also lists the number of opted-in users per engagement channel. In the composers, the number of channel IDs and opted-in users per engagement channel for a segment are listed in the Audience section in the composer’s Review step.

For email, the audience count (within a block and for the segment) is the sum of channel IDs for transactional and commercial messages, and you can hover over the count to see the breakdown; Opted-in is for commercial messages only.

In Audience » Segments the count is displayed in the Audience Count column if it was already generated when creating the segment. Click Generate for any segment that does not already display its count. Counts will appear for 7 days, then you must click Generate again for a new count. A progress bar appears until the calculation is complete. Click   to see the number of channel IDs and opted-in users per engagement channel.

Send a message to a segment

In the dashboard, select Target Specific Users in the Audience step of the Message, A/B Test, and In-App Automation composers, then select your segment.

In the API, target specific users via the "audience" object. See: API: Audience Selection.

Manage segments

Go to Audience » Segments to view a list of your segments. All segments appear in this list, whether created using the API or dashboard.

  • Your last modified segment is listed first.
  • You can sort the list by Name, Date Created, or Date Last Modified.
  • You can search for segments by name.
  • Click Generate for any segment that does not already display its audience count.
  • Click   to see a segment’s description and targeted audience. Its number of channel IDs and opted-in users per engagement channelA 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. will also appear here if you generated the audience count.

Duplicate a segment

You may want to duplicate a segment as a starting point for a new audience segment, rather than starting from scratch.

 Note

Some complex segments created using the API cannot be duplicated in the dashboard.

  1. Go to Audience » Segments.
  2. Click   for a segment.
  3. (Optional) Enter a name and description for the new segment. The name is prefilled with “Copy of [original segment name]” and the description is the original segment’s description.
  4. Click Save and continue.
  5. Edit as you would a new segment.
  6. Click Save and exit.

Edit a segment

Segmentation data is evaluated at send time; if you schedule a message that targets a segment and then edit that segment, the scheduled message automatically uses the updated segment criteria. “Scheduled” includes recurring messages.

 Note

Some complex segments created using the API cannot be edited in the dashboard.

  1. Go to Audience » Segments.
  2. Click   for a segment.
  3. Edit as you would a new segment.
  4. Click Save and exit.

Delete a segment

 Warning

Deleting a segment that is in use may impact messaging.

  1. Go to Audience » Segments.
  2. Click   for a segment.

Segmentation data

You can create segments using the following audience criteria:

 Note

Lifecycle audience lists are not supported for web, email, SMS, or open channels.