Event Segmentation

Event Segmentation

Airship API support for Event Segmentation.

With this release, you can now activate specific events for segmentation in our updated Events configuration page and then target users by event activity via the Airship API.

Event segmentation is supported in our Push and A/B Testing APIs. Create ad-hoc, scheduled, or A/B Test messages targeting users based on:

  • Whether they have or have not performed a specific event
  • When they first or last performed a specific event
  • The presence and/or values of properties associated with the events

Use event segmentation in combination with all other segmentation capabilities (tags, attributes, lists, etc.).

Event segmentation opens up a new dimension of targeting based on user behaviors. Here are just a few use cases:

  • Target users who have opened your app 3 times in the past 7 days.
  • Target users who have made purchases 5 or more times.
  • Send a message to a user who viewed a specific type of product on your website.
  • Send a message to users who have clicked a link in an email within the last 30 days.

You can also target users further based on event properties, using comparison operators to filter down to a highly specific audience.

Here’s an example API request for a message targeting users who have performed the screen_view event more than 2 times in the last 3 days where the screen_name property was equal to “contact_us”.

   "audience": {
      "activity": "screen_view",
      "operator": "greater",
      "value": 2,
      "after": 3,
      "precision": "days",
      "where": {
         "property": "screen_name",
         "operator": "equals",
         "value": "contact_us"
   "device_types": [
   "notification": {
      "android": {
         "alert": "Need to reach us? Give us a call today"
      "ios": {
         "alert": "Need to reach us? Give us a call today"

We’re excited to bring this additional capability to our customers. After releasing AttributesMetadata that you can use for audience segmentation. Attributes differ from tags in that when evaluating users with attributes, Airship uses operators, e.g., equals, less than/greater than, contains, before/after, to determine whether or not to target a user. Supported attribute types are TEXT, NUMBER, and DATE. earlier this year, event segmentation was the next most requested segmentation feature. Thank you for your continued feedback, and keep an eye out for an update to our Segment Builder soon, which will bring this new capability to our dashboard as well.

Learn More

To learn more about Airship events, take a look at our new Events Guide.

In the guide, you’ll learn the differences between our out-of-the box, predefined, and custom events, as well as their associated properties.

Head over to our Event Segmentation API Reference to begin constructing audiences based on events.