Headless Server Developer Manual / 8.2 Rules

8.2 Rules

Personalization rules are defined in the Blueprint extension p13n-studio (CMSelectionRulesForm).

Key	Key Value	Operator	Value	Example
location.city	-	=, !=	Hamburg, SanFrancisco, London, Singapore	location.city=\"Hamburg\"
keyword	String	<, <=, =, >=, >	per cent (0, ..., 1)	keyword.abc<0.10
referrer.url	-	!=, =, # (contains)	String	referrer.url#\"abc\"
referrer.searchengine	-	=, !=	google,bing,yahoo	referrer.searchengine=google
referrer.query	-	# (contains)	String	referrer.query#\"test\"
(resolved segment)	-	=, !=	true	(referrer.query#\"test\" and socialuser.gender=male)=true

Table 8.1. Generic Personalization rules

Key	Key Value	Operator	Value	Example
locationTaxonomies	Location tag content id	<, <=, =, >=, >	per cent (0, ..., 1)	locationTaxonomies.content:1002=0.04
subjectTaxonomies	Subject tag content id	<, <=, =, >=, >	per cent (0, ..., 1)	subjectTaxonomies.content:1214>=0.01
explicit.content	Subject tag content id	=, !=	1	explicit.content:1198!=1
explicit.numberOfExplicitInterests	-	<, <=, =, >=, >	Number >= 0	explicit.numberOfExplicitInterests>=2

Table 8.2. Taxonomy Personalization rules

Rules are configured without a timezone in Studio. A reference timezone should be defined for a project, for example CET, and evaluated client-side.

Key	Operator	Value	Example
system.date	<, =, >	Date	system.date=2020-10-22T00:00:00
system.dateTime	<, >	Date Time	system.dateTime>2020-10-22T17:17:00
system.dayOfWeek	<, =, >	1 (Sunday), ..., 7 (Saturday)	system.dayOfWeek=7
system.timeOfDay	<, >	Timestamp	system.timeOfDay>14:21:59

Table 8.3. Date/Time Personalization rules

Key	Operator	Value	Example
socialuser.gender	=, !=	male, female	socialuser.gender=female
es_check.numberOfComments	<, <=, =, >=, >	Number >= 0	es_check.numberOfComments<=1
es_check.numberOfLikes	<, <=, =, >=, >	Number >= 0	es_check.numberOfLikes<=3
es_check.numberOfRatings	<, <=, =, >=, >	Number >= 0	es_check.numberOfRatings>=4
es_check.userLoggedIn	=, !=	true	es_check.userLoggedIn=true

Table 8.4. Elastic Social Personalization rules

Key	Operator	Value	Example
commerce.usersegments	# (contains)	eCommerce User segment	commerce.usersegments#\"ibm:///catalog/segment/8000000000000001004\"

Table 8.5. Commerce Personalization rules

Key	Operator	Value	Example
sfmc.journeys	# (contains)	SFMC journey reference	sfmc.journeys#[sfmcJourneyReference]

Table 8.6. SFMC Personalization rules