SaaSquatch Help Center

Create and manage intelligent segments of participants for your SaaSquatch programs. Improve personalization and ROI by using these segments to accurately promote each program to the correct group of users.

🔗 What is User Segment?

User Segmentation is the process of dividing your user-base into groups based on shared characteristics.

Common segmentation criteria include demographic factors like:

  • Age
  • Sex/Gender
  • Location
  • Job Industry
  • Place of employment
  • Income

You might also segment users based on a number of characteristics related to their relationship with your business like, for example:

  • Membership status
  • Subscription plan tier
  • Last purchase date
  • Signup date
  • Device

segment user cloud

By segmenting your users you can better understand their interests, follow their activity, and more accurately provide value that matches their needs.

🔗 Create a User Segment

  1. Head to your SaaSquatch account.
  2. In the left right corner of your SaaSquatch account select either your Live or Test tenant.
  3. Click "Participants" in the upper header of your SaaSquatch account.
  4. Select "Segments" in the lower header.
  5. Click the "+" symbol to the right of the Segment section.
  6. Type the name of the Segment you would like to add.
  7. Click Add to create that segment.
  8. Your new segment has been created.

🔗 Add single Participant to User Segment

  1. Head to your SaaSquatch account.
  2. In the upper left corner of your SaaSquatch account select either your Live or Test tenant.
  3. Click "Participants" in the upper header of your SaaSquatch account.
  4. Find the specific participant you would like to add to a User Segment.
  5. Click that user to load their user overview.
  6. In the bottom left of the user overview, click "Add Segment".
  7. Select the User segment you would like to include this participant in.
  8. All done. The user is now within that User Segment.

🔗 Remove single Participant to User Segment

  1. Head to your SaaSquatch account.
  2. In the upper left corner of your SaaSquatch account select either your Live or Test tenant.
  3. Click "Participants" in the upper header of your SaaSquatch account.
  4. Find the specific participant you would like to remove from a User Segment.
  5. Click that user to load their user overview.
  6. In the bottom left of the user overview, click the "x" to the right of the segment you would like to remove the participant from.
  7. The participant has been removed from the selected User Segment.

🔗 Bulk add Participant to User Segment

  1. Head to your SaaSquatch account.
  2. In the upper left corner of your SaaSquatch account select either your Live or Test tenant.
  3. Click "Participants" in the upper header of your SaaSquatch account.
  4. Select "Segments" in the lower header.
  5. Click "Import Users" to the right of the specific User Segment row you would like to add additional participants in.
  6. Choose an Import Type "Users".
  7. Using the example CSV, create a list of all participants you would like to be included in a specific User Segment.
  8. Click "Select & Upload" to choose the CSV file you have created and upload it to SaaSquatch.
  9. From the dropdown menu choose which User Segment to add the specific participants to.
  10. Click "Start Import" to assign the specific partipants to the selected User Segment.

Through the SaaSquatch portal you can make changes to a bulk list of users to add or remove them from segments in your SaaSquatch project.

🔗 SaaSquatch API and squatch.js Segmentation

The SaaSquatch REST API and squatch.js Javascript library can also be used to programatically manage which segments users are a member of.

This functionality can be accessed by including one or more of the following "Operations" (a combination of the name of the segment and an operator) in the user object of the API call or squatch.js method.

🔗 Operators

The following operators are the basis for the User Segmentation "Operations" used to manage which segments a user is a member of.

Operator Description Example
Add Providing just the segment key will attempt to add the user to the segment. If the user is already part of the segment then no action will be taken. mySegmentKey
Delete Including the segment key with a ~ in front of it will inform the SaaSquatch system to remove the user from the segment. If the user is already not part of the segment then no action will be taken. ~mySegmentKey
Clear Including a * key, with a ~ in front of it, will inform the SaaSquatch system to remove the user from all segments they are currently part of. ~*

🔗 Operations

The following Operations, built using the available Operators, enable you to manage which segments a user is a member of.

Operation Description Example
Add Adds a user to a segment. Any other existing segments will be retained. { "id" : "abc_123", ... "segments" : ["A"] }
Set Set the segment(s) for a user. Any other existing segments will be removed.

NOTE: Ordering does matter! To perform a set operation, the clear Operator (~*) should be included first.
{ "id" : "abc_123", ... "segments" : ["~*","A" ] }
Remove Remove a user from a segment. Any other existing segments will be retained. { "id" : "abc_123", ... "segments" : ["~A"] }
Clear Clear all segments configured for a user. { "id" : "abc_123", ... "segments" : ["~*"] }

You can find further details about using these Operations in our squatch.js Javascript library and SaaSquatch API methods in our documentation.