Segments Editor UI Reference

You can use segments to organize users into different groups with common sets of properties. Follow these steps to access the segments editor UI.

  1. Go to Site Administration and select the site that you wish to create segments for.

  2. Open the Site Menu (Site Menu), and navigate to PeopleSegments.

  3. Click Add (Add) to add new user segment.

At the top of the editor you can set the name, choose to Save the segments, or Cancel to discard the changes. In the Conditions section, you can view the current members of the segment as it is defined.

On the right side of the page, there’s a Properties menu with these options:

  • User
  • Organization
  • Session
  • Segments

You use the segment editor to create new segments.

Operations and conjunctions are combined with the properties to define criteria.

Operations and Conjunctions

Several types of information can be collected by the User Segment interface. Some data is entered in text boxes, while others use selectors to select specific criteria or tools like a date picker. Some fields use an operator, which, depending on the specific context lets you select the relationship between the user or agent data and the criteria.

  • equals

  • not equals

  • greater than

  • greater than or equals

  • less than

  • less than or equals

  • contains

  • does not contain

Depending on the nature of the criteria, the operator selection may contain different combinations. For example, the Date selection described below contains all the previously listed options except contains and does not contain, whereas the Email Address selection has equals, not equals, contains and does not contain.

In between each criteria and each category, you can define an And/Or conjunction. For And, all criteria must be true for the criteria to be satisfied. With Or, it is true if any of the defined criteria are true. You can also mix operators to create complex cases.

User Properties

User properties are user attributes you want to capture. This is made up of user metadata as defined in their accounts, but also contains certain group memberships (like roles and user groups) as well as information like the date the user profile was last modified. These user properties are available:

PropertyDescription
Date ModifiedProvides a date picker and a relationship selector to select the date that user information was last changed.
Email AddressProvides a text box to enter the email provided in the user’s profile.
First NameEnter the first name provided in the user’s profile.
Job TitleEnter the job title provided in the user’s profile.
Last NameEnter the last name provided in the user’s profile.
Regular RoleSelect a role that the user is a member of.
Screen NameEnter the users’ screen name.
SiteSelect a site that the user is a member of.
TeamSelect a team that the user is a member of.
UserSelect a specific user from a list.
User GroupSelect a user group that the user is a member of.
User NameThe full name of the user.
Note

To display content for guest users through segments, select the Signed In session property and set its value to False. This action effectively represents an anonymous user, fulfilling the same purpose as the guest role.

Since Liferay DXP 7.2 SP2+, these properties are also available for users:

PropertyDescription
Date of BirthProvides a date picker and a relationship selector to select the date of birth of the user.
TagEnter the tags that apply to the users.

Organization Properties

Organization properties is a selectable list of organizations to include in your segment. They contain similar criteria as the user selection, like Name and Date Modified. These organization properties are available:

PropertyDescription
Date ModifiedEnter the date that the organization information was last modified.
Hierarchy PathEnter the name of an ancestor organization.
NameEnter the name of the organization.
OrganizationSelect a specific organization.
Parent OrganizationSelect a specific parent organization.
TypeSelect the type of organization, if organization types have been defined.

Since Liferay DXP 7.2 SP2+, these properties are also available for organizations:

PropertyDescription
CountrySelect a specific country connected to the organization.
RegionSelect a specific region connected to organization.
TagEnter the tags that apply to the organization.

Session Properties

Session properties contains criteria based on the user’s activity, browser, and system information. You can use this to target the user’s device or OS, or for activity-based criteria like if a user entered the website through a specific campaign driven landing page. These session properties are available:

PropertyDescription
BrowserEnter a property from the browser.
CookiesEnter the name of a browser cookie.
Device BrandEnter the brand name of the device being used.
Device ModelEnter the model name of the device being used.
Device Screen Resolution HeightEnter the screen resolution height value.
Device Screen Resolution WidthEnter the screen resolution width value.
LanguageSelect the current language.
Last Sign In DateSelect the date of the user’s last sign in.
Local DateSelect the current date where the user is located.
Referrer URLEnter the URL that the user last visited.
Signed InSelect whether the user is signed in.
URLEnter the current URL.
User AgentEnter a user agent property.

Since Liferay DXP 7.2 SP2+, these properties are also available for the session:

PropertyDescription
HostnameEnter a virtual host name.
Request ParametersEnter the name and value of a request parameter.

Starting from Liferay DXP 7.4 U42+/GA42+, the following property is also available for the session:

PropertyDescription
IP Geocoder CountrySelect a country to match with the user’s IP address.

Segments Property

Available: Liferay DXP/Portal 7.3+.

With the segments property, you can combine existing segments into a new compound segment. The compound segment inherits the properties from the segments it is based on, and updates the members automatically. For more information, see Compound Segments.

Capabilities

Product

Contact Us

Connect

Powered by Liferay
© 2024 Liferay Inc. All Rights Reserved • Privacy Policy