Segments (ex Filters)

Creating Segments

Finally, we are all set to create our first targeted push! 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.
Segments are pools of the app subscribers complying with the conditions you specify – those who have the specific tags' values assigned to their devices and/or user IDs.

Build Segment

To build a Segment by setting up the conditions (tags values to apply), go to the Segments (Filters) section of Pushwoosh Control Panel and press Create Segment button; then, choose the Build Segment option from the dropdown menu.
Each segment is described by a set of Conditions which are Tags and values users have on their devices. Choosing an operator, you choose between two options: intersection or joining those sets of users who comply with the conditions of the segment.
  • AND – builds a segment of users who comply with all the conditions set at a time
  • OR – users who comply with any of the conditions will be included in the segment
To set conditions for the segment, select a tag and its operator (refer to the Tags guide for more detail on tags and operators). Then, start typing the value you'd like to use as a segment condition or choose the value from the drop-down list.
Each segment can be described with several Conditions. To add a condition, press the button and select the tag to be added.
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 – so, add the In-App Purchase tag with the corresponding operators and values, and here they are.
To create segments via API, please refer to the /createFilter API Reference section.

Import Segment

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.
Please make sure your CSV size is less than 100 MB.
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.
Processing the CSV file might take some time. You can leave the page; after the import is completed, the Segment will appear in the Segments list.
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, as well as Push Tokens and devices' types:
Hwid
Push Token
Type
Type (humanized)
Age
Application Version
City
Country
Device Model
Email Segment Name
First Install
Gender
In-app Product
In-app Purchase
Jailbroken
Language
Last Application Open
Last In-app Purchase date
Name
OS Version
PW Channels
Push Alerts Enabled
SDK Version
Subscription Segments
Unsubscribed Emails
WishList
146.....Hl23f
146.....Hl23f
10
Safari
27
us, new york
us
Safari 12.0.1
2020-02-19
en
2020-07-15
1
3.15.1.0
true
01D...3C8
eeeb2fd....fc3547
1
iOS
18
1.11.1.0
in, bengaluru
in
iPhone SE
2018-11-26
outwear_01
24
0
en
2018-11-26
2018-11-26
Anna
12.1.0.0
5.8.0.0
2D732-BB981, 7EC43-1531A
C90...79ae5
eQFKk......DwJSv
11
Chrome
36
us, chicago
us
Chrome 81
2020-08-24
en
2020-08-24
1
3.15.1.0

Sending Targeted Pushes

Now that you know how to do all the prep work for segmenting your audience, you’re all set to send highly targeted pushes to some of your users but not others. Remember, the more targeted your push notifications are, the more likely your audience will be to act on those pushes. Audience segmentation using Pushwoosh Tags and Filters is the key to effective user engagement and a powerful marketing strategy.
To send a one-time push notification to a Segment, press the Send Push button for the segment you'd like to target. You'll be taken to the One-time push section, where that segment is already selected in the Segmentation parameters.
To send targeted messages via API, please refer to the /createMessage or /createTargetedMessage API Reference section.
Last modified 1mo ago