Segments

Segments are pools of app subscribers complying with the conditions you specify. These are users who have the specific tags’ values assigned to their devices and/or user IDs.

Having set up all the necessary Tags that identify your target app users, we can now create a Segment and send a push notification to specific users.

To build a Segment by setting up the conditions, go to the Segments (Filters) section of Pushwoosh Control Panel.

Press Create Segment button, then choose Build Segment from the dropdown menu.

Each segment is described by a set of Filters that can be represented by:

• Tags and their values
• Events
• Existing segments
• Filter Groups (these are compound filters that can include combinations of tags, events, and/or existing segments)

When creating a Filter Group, you can apply logical operators to define how conditions work together:

• AND: includes users who meet all the specified conditions
• OR: includes users who meet any of the specified conditions
• AND NOT: includes users who meet the first group of conditions, but exclude those who also meet the second group

These operators help you combine or filter out users based on their behavior or attributes.

1. To build a segment by Tags, hit Tag in the Add filter by section.

2. Select a tag you’d like to use (pick it from the drop-down list or start typing).

3. Then, hit Add value and select the value you’d like to use as a segment condition (you can pick it from the drop-down list or start typing).

4. If you set several Tags as a segment condition, select an operator you’d like to use (AND/OR):

By setting several filters within one segment, you create a Filter Group. Within it, the operator should be the same (=either AND or OR is applied to all filters). To change operators, click on one of them:

You can use one tag several times to build more sophisticated segments based on various combinations of conditions. For example, you might need a segment of users who have bought a coat in your app and haven’t bought gloves. For this, add the In-App Product tag with the corresponding operators and values, and here they are.

Please refer to the Tags guide for more detail on Tags.

Pushwoosh enables you to create segments based on the anniversary of a specific date tag. This allows you to target users whose significant dates, like birthdays or first installs, occur on the same day each year.

For this do the following:

1. Navigate to the Segments section and click Create Segment → Build Segment
2. Select the tag relevant to your anniversary (e.g., First Install or user’s birthday).

3. Choose the condition Anniversary and specify the date condition:

• Today: Users whose anniversary date matches today’s date.

• Is in N days: Users whose anniversary is in N days.

• Is N days past: Users whose anniversary is N days past.

Configuring a segment to include users a certain number of days before or after the anniversary date allows for pre- or post-anniversary engagements.

4. Refine your segment further by adding more filters.

Once you’ve created a segment, you can set up a recurring customer journey based on this segment to celebrate your users’ special dates. Learn more

1. To build a segment by Events, hit Event in the Add filter by section.

2. Select an event from the drop-down list.

3. Then indicate conditions for the selected event: the number of times it happened and a time frame.

4. If you set several Events as a segment condition, select an operator you’d like to use (AND/OR).

You can use the Segment filter to include users who already belong to one or more existing segments. This allows you to reuse previously defined logic instead of recreating complex conditions from scratch.

To do this:

1. When creating a new segment, click Add filter by → Segment.

2. Select one or more existing segments to include.

3. If you add multiple segments, choose how they should be combined using a logic operator:

   • Select AND to include users who belong to all selected segments.
   • Select OR to include users who belong to any of the selected segments.

Suppose you’ve already created a segment named Active Users (users who opened the app in the last 7 days).
If you want to target only premium subscribers from this group, create a new segment with the following filters:

• Segment filter: select Active Users
• Tag filter: set subscription_type = premium

As a result, your new segment will include only premium users who were recently active.

For advanced segmentation, you can use compound filters:

You can set both Tags and Events at the same time and choose an operator (AND/OR) for them. In this example, the segment includes all the users who bought linen or lyocell trenchcoat in the app and successfully checked out (with any purchase) more than once in the last 30 days:

To build more advanced and targeted segments, combine multiple filter groups in one segment using different logic operators:

• AND: includes users who meet all conditions from both groups
• OR: includes users who meet at least one of the groups’ conditions
• AND NOT: includes users from the first group but excludes those who meet the second group’s conditions

This segment includes users who meet either of the following:

• Bought a linen trenchcoat at least once in the last 30 days

  or

• Added mom jeans to their wishlist and added at least 3 items to their cart in the last 30 days

This segment is designed to target high-spending users who are not part of the loyalty program.

• Included: Users in the High-spending segment
• Excluded: Users in the Loyalty members segment

Enable this option to target a user across all their devices, not just the one that matched the segment condition. This ensures they receive your messages on every platform they use.

• Enabled: If any of the user’s devices meet the condition (e.g., purchase event, tag, behavior), all their devices across platforms are included in the segment.

• Disabled: Only the devices that meet the condition are included in the segment.

You can now create audience segments faster using AI-powered natural language input. Instead of manually setting conditions, simply describe your target audience. The system will generate a matching segment for you.

To create a segment:

1. Go to the Segments > Create Segment.

2. From the dropdown, select Craft Segment with AI.

3. In the prompt window that appears, enter a natural language description of the segment you want to create. For example: “Users who added items to their cart but didn’t complete the purchase in the last 7 days, and are located in the US or Canada.”

4. Click Generate. The AI will interpret your prompt and create a segment based on your criteria.

You can upload the CSV file to create a Segment of users with no need to specify filtering conditions.

The CSV file you’re uploading should contain UserIDs or HWIDs registered for the project you’re creating a Segment for. If the CSV file does not contain any User ID or HWIDs, it won’t create any Segment. If User IDs or HWIDs contained in the CSV are not registered for the project, they will be skipped while importing the Segment.

In the Tags section, you can find the CSV import default tag. To all the user IDs or HWIDs contained in the CSV, the name of the CSV file is assigned as a value for that tag.

In the Segments list, you’ll see the number of users in a Segment, the last time the Segment size was refreshed, and the conditions the Segment is built with.

To get the up-to-date Segment size, choose the Refresh Segment Size option of the three-dots menu. If you’d like to download the CSV of the segment, press Refresh & Export to CSV. When the CSV is ready to download, the download icon appears in the CSV column.

The downloaded CSV file will contain the Tag values assigned to every device in that segment. It also includes Push Tokens and devices’ types:

Segmentation Language is a syntax to define and apply specific conditions or filters when segmenting your audience.

The Copy Seglang option allows you to copy the underlying logic of a segment you’ve created. The copied Segmentation Language can then be used in API calls, such as the createmessage API method or API-based customer journey entries, to replicate the same segmentation logic.

If you want to create a new segment similar to an existing one, use the Clone segment option:

To deliver your messages as rapidly as possible, you might need High-Speed Delivery segments. High-Speed Delivery segments keep updated every 10 minutes so that at the moment you launch messages to such a segment, that segment doesn’t need to be refreshed; thus, no extra time is spent on preparing the message launch.