audience_segmentation

Property Manager name: Audience Segmentation Cloudlet
Behavior version: The v2025-01-13 rule format supports the audience_segmentation behavior v3.0.
Rule format status: GA, stable
Access: Read/Write
Allowed in includes: No (temporarily)

Allows you to divide your users into different segments based on a persistent cookie. You can configure rules using either the Cloudlets Policy Manager application or the Cloudlets API.

Option	Type	Description	Requires
`enabled`	boolean	Enables the Audience Segmentation cloudlet feature.		{"displayType":"boolean","tag":"input","type":"checkbox"}
`is_shared_policy`	boolean	Whether you want to use a shared policy for a Cloudlet. Learn more about shared policies and how to create them in Cloudlets Policy Manager.		{"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}}
`cloudlet_policy`	object	Identifies the Cloudlet policy.	`is_shared_policy` is `false`	{"displayType":"object","tag":"input","todo":true} {"if":{"attribute":"isSharedPolicy","op":"eq","value":false}}
`cloudlet_policy.id`	number	Identifies the Cloudlet.
`cloudlet_policy.name`	string	The Cloudlet's descriptive name.
`cloudlet_shared_policy`	string	This identifies the Cloudlet shared policy to use with this behavior. You can list available shared policies with the Cloudlets API.	`is_shared_policy` is `true`	{"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"isSharedPolicy","op":"eq","value":true}}
`label`	string	Specifies a suffix to append to the cookie name. This helps distinguish this audience segmentation policy from any others within the same property.		{"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"enabled","op":"eq","value":true}}
`segment_tracking_method`	enum	Specifies the method to pass segment information to the origin. The Cloudlet passes the rule applied to a given request location.		{"displayType":"enum","options":["IN_QUERY_PARAM","IN_COOKIE_HEADER","IN_CUSTOM_HEADER","NONE"],"tag":"select"} {"if":{"attribute":"enabled","op":"eq","value":true}}
		Supported values: IN_COOKIE_HEADER IN_CUSTOM_HEADER IN_QUERY_PARAM NONE
`segment_tracking_query_param`	string	This query parameter specifies the name of the segmentation rule.	`segment_tracking_method` is `IN_QUERY_PARAM`	{"displayType":"string","tag":"input","type":"text"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"segmentTrackingMethod","op":"eq","value":"IN_QUERY_PARAM"}]}}
`segment_tracking_cookie_name`	string	This cookie name specifies the name of the segmentation rule.	`segment_tracking_method` is `IN_COOKIE_HEADER`	{"displayType":"string","tag":"input","type":"text"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"segmentTrackingMethod","op":"eq","value":"IN_COOKIE_HEADER"}]}}
`segment_tracking_custom_header`	string	This custom HTTP header specifies the name of the segmentation rule.	`segment_tracking_method` is `IN_CUSTOM_HEADER`	{"displayType":"string","tag":"input","type":"text"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"segmentTrackingMethod","op":"eq","value":"IN_CUSTOM_HEADER"}]}}
`population_cookie_type`	enum	Specifies when the segmentation cookie expires.		{"displayType":"enum","options":["NEVER","ON_BROWSER_CLOSE","DURATION"],"tag":"select"} {"if":{"attribute":"enabled","op":"eq","value":true}}
	`NEVER`	Never expire.
	`ON_BROWSER_CLOSE`	Expire at end of browser session.
	`DURATION`	Specify a delay.
`population_duration`	string (duration)	Specifies the lifetime of the segmentation cookie.	`population_cookie_type` is `DURATION`	{"displayType":"string","tag":"input","type":"text"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"populationCookieType","op":"eq","value":"DURATION"}]}}
`population_refresh`	boolean	If disabled, sets the expiration time only if the cookie is not yet present in the request.	`population_cookie_type` is `DURATION`	{"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"populationCookieType","op":"eq","value":"DURATION"}]}}
`specify_population_cookie_domain`	boolean	Whether to specify a cookie domain with the population cookie. It tells the browser to which domain to send the cookie.		{"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}}
`population_cookie_domain`	string	Specifies the domain to track the population cookie.	`specify_population_cookie_domain` is `true`	{"displayType":"string","tag":"input","type":"text"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"specifyPopulationCookieDomain","op":"eq","value":true}]}}
`population_cookie_automatic_salt`	boolean	Whether to assign a salt value automatically to the cookie to prevent manipulation by the user. You should not enable if sharing the population cookie across more than one property.		{"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}}
`population_cookie_salt`	string	Specifies the cookie's salt value. Use this option to share the cookie across many properties.	`population_cookie_automatic_salt` is `false`	{"displayType":"string","tag":"input","type":"text"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"populationCookieAutomaticSalt","op":"eq","value":false}]}}
`population_cookie_include_rule_name`	boolean	When enabled, includes in the session cookie the name of the rule in which this behavior appears.		{"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}}

Updated about 1 month ago