- Property Manager name: Visitor Prioritization Cloudlet
- Behavior version: The
latest
rule format supports thevisitorPrioritization
behavior v3.6. - Rule format status: Beta, possible breaking changes
- Access: Read/Write
- Allowed in includes: Not available for
latest
rule format
The Visitor Prioritization Cloudlet decreases abandonment by providing a user-friendly waiting room experience. With Cloudlets available on your contract, choose Your services > Edge logic Cloudlets to control Visitor Prioritization within Control Center. Otherwise use the Cloudlets API to configure it programmatically. To serve non-HTML API content such as JSON blocks, see the apiPrioritization
behavior.
Option | Type | Description | Requires | |
---|---|---|---|---|
enabled | boolean | Enables the Visitor Prioritization behavior. | {"displayType":"boolean","tag":"input","type":"checkbox"} | |
cloudletPolicy | object | Identifies the Cloudlet policy. | {"displayType":"object","tag":"input","todo":true} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
cloudletPolicy.id | number | Identifies the Cloudlet. | ||
cloudletPolicy.name | string | The Cloudlet's descriptive name. | ||
userIdentificationByCookie | boolean | When enabled, identifies users by the value of a cookie. | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
userIdentificationKeyCookie | string | Specifies the name of the cookie whose value identifies users. To match a user, the value of the cookie needs to remain constant across all requests. | userIdentificationByCookie is true | {"displayType":"string","tag":"input","type":"text"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"userIdentificationByCookie","op":"eq","value":true}]}} |
userIdentificationByHeaders | boolean | When enabled, identifies users by the values of GET or POST request headers. | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
userIdentificationKeyHeaders | string array | Specifies names of request headers whose values identify users. To match a user, values for all the specified headers need to remain constant across all requests. | userIdentificationByHeaders is true | {"displayType":"string array","tag":"input","todo":true} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"userIdentificationByHeaders","op":"eq","value":true}]}} |
userIdentificationByIp | boolean | Allows IP addresses to identify users. | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
userIdentificationByParams | boolean | When enabled, identifies users by the values of GET or POST request parameters. | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
userIdentificationKeyParams | string array | Specifies names of request parameters whose values identify users. To match a user, values for all the specified parameters need to remain constant across all requests. Parameters that are absent or blank may also identify users. | userIdentificationByParams is true | {"displayType":"string array","tag":"input","todo":true} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"userIdentificationByParams","op":"eq","value":true}]}} |
allowedUserCookieEnabled | boolean | Sets a cookie for users who have been allowed through to the site. | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
allowedUserCookieLabel | string | Specifies a label to distinguish this cookie for an allowed user from others. The value appends to the cookie's name, and helps you to maintain the same user assignment across behaviors within a property, and across properties. | allowedUserCookieEnabled is true | {"displayType":"string","tag":"input","type":"text"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"allowedUserCookieEnabled","op":"eq","value":true}]}} |
allowedUserCookieDuration | number (0-600) | Sets the number of seconds for the allowed user's session once allowed through to the site. | allowedUserCookieEnabled is true | {"displayType":"number","max":[600],"min":[0],"tag":"input","type":"range"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"allowedUserCookieEnabled","op":"eq","value":true}]}} |
allowedUserCookieRefresh | boolean | Resets the duration of an allowed cookie with each request, so that it only expires if the user doesn't make any requests for the specified duration. Do not enable this option if you want to set a fixed time for all users. | allowedUserCookieEnabled is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"allowedUserCookieEnabled","op":"eq","value":true}]}} |
allowedUserCookieAdvanced | boolean | Sets advanced configuration options for the allowed user's cookie. | allowedUserCookieEnabled is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"allowedUserCookieEnabled","op":"eq","value":true}]}} |
allowedUserCookieAutomaticSalt | boolean | Sets an automatic salt value to verify the integrity of the cookie for an allowed user. Disable this if you want to share the cookie across properties. | allowedUserCookieEnabled is true AND allowedUserCookieAdvanced is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"allowedUserCookieEnabled","op":"eq","value":true},{"attribute":"allowedUserCookieAdvanced","op":"eq","value":true}]}} |
allowedUserCookieSalt | string | Specifies a fixed salt value, which is incorporated into the cookie's value to prevent users from manipulating it. You can use the same salt string across different behaviors or properties to apply a single cookie to all allowed users. | allowedUserCookieEnabled is true AND allowedUserCookieAdvanced is true AND allowedUserCookieAutomaticSalt is false | {"displayType":"string","tag":"input","type":"text"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"allowedUserCookieEnabled","op":"eq","value":true},{"attribute":"allowedUserCookieAdvanced","op":"eq","value":true},{"attribute":"allowedUserCookieAutomaticSalt","op":"eq","value":false}]}} |
allowedUserCookieDomainType | enum | Specify with | allowedUserCookieEnabled is true AND allowedUserCookieAdvanced is true | {"displayType":"enum","options":["DYNAMIC","CUSTOMER"],"tag":"select"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"allowedUserCookieEnabled","op":"eq","value":true},{"attribute":"allowedUserCookieAdvanced","op":"eq","value":true}]}} |
DYNAMIC | Use the dynamic incoming host header. | |||
CUSTOMER | Use a customer-defined cookie domain. | |||
allowedUserCookieDomain | string | Specifies a domain for an allowed user cookie. | allowedUserCookieEnabled is true AND allowedUserCookieAdvanced is true AND allowedUserCookieDomainType is CUSTOMER | {"displayType":"string","tag":"input","type":"text"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"allowedUserCookieEnabled","op":"eq","value":true},{"attribute":"allowedUserCookieAdvanced","op":"eq","value":true},{"attribute":"allowedUserCookieDomainType","op":"eq","value":"CUSTOMER"}]}} |
allowedUserCookieHttpOnly | boolean | Applies the | allowedUserCookieEnabled is true AND allowedUserCookieAdvanced is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"allowedUserCookieEnabled","op":"eq","value":true},{"attribute":"allowedUserCookieAdvanced","op":"eq","value":true}]}} |
waitingRoomCookieEnabled | boolean | Enables a cookie to track a waiting room assignment. | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
waitingRoomCookieShareLabel | boolean | Enabling this option shares the same | waitingRoomCookieEnabled is true AND allowedUserCookieEnabled is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"waitingRoomCookieEnabled","op":"eq","value":true},{"attribute":"allowedUserCookieEnabled","op":"eq","value":true}]}} |
waitingRoomCookieLabel | string | Specifies a label to distinguish this waiting room cookie from others. The value appends to the cookie's name, and helps you to maintain the same waiting room assignment across behaviors within a property, and across properties. | waitingRoomCookieEnabled is true | {"displayType":"string","tag":"input","type":"text"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"waitingRoomCookieEnabled","op":"eq","value":true},{"op":"or","params":[{"attribute":"allowedUserCookieEnabled","op":"eq","value":false},{"attribute":"waitingRoomCookieShareLabel","op":"eq","value":false}]}]}} |
waitingRoomCookieDuration | number (0-120) | Sets the number of seconds for which users remain in the waiting room. During this time, users who refresh the waiting room page remain there. | waitingRoomCookieEnabled is true | {"displayType":"number","max":[120],"min":[0],"tag":"input","type":"range"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"waitingRoomCookieEnabled","op":"eq","value":true}]}} |
waitingRoomCookieAdvanced | boolean | When enabled along with | waitingRoomCookieEnabled is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"waitingRoomCookieEnabled","op":"eq","value":true}]}} |
waitingRoomCookieAutomaticSalt | boolean | Sets an automatic salt value to verify the integrity of the waiting room cookie. Disable this if you want to share the cookie across properties. | waitingRoomCookieEnabled is true AND waitingRoomCookieAdvanced is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"waitingRoomCookieEnabled","op":"eq","value":true},{"attribute":"waitingRoomCookieAdvanced","op":"eq","value":true}]}} |
waitingRoomCookieSalt | string | Specifies a fixed salt value, which is incorporated into the cookie's value to prevent users from manipulating it. You can use the same salt string across different behaviors or properties to apply a single cookie for the waiting room session. | waitingRoomCookieEnabled is true AND waitingRoomCookieAdvanced is true AND waitingRoomCookieAutomaticSalt is false | {"displayType":"string","tag":"input","type":"text"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"waitingRoomCookieEnabled","op":"eq","value":true},{"attribute":"waitingRoomCookieAdvanced","op":"eq","value":true},{"attribute":"waitingRoomCookieAutomaticSalt","op":"eq","value":false}]}} |
waitingRoomCookieDomainType | enum | Specify with | waitingRoomCookieEnabled is true AND waitingRoomCookieAdvanced is true | {"displayType":"enum","options":["DYNAMIC","CUSTOMER"],"tag":"select"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"waitingRoomCookieEnabled","op":"eq","value":true},{"attribute":"waitingRoomCookieAdvanced","op":"eq","value":true}]}} |
DYNAMIC | Use the dynamic incoming host header. | |||
CUSTOMER | Use a customer-defined cookie domain. | |||
waitingRoomCookieDomain | string | Specifies a domain for the waiting room cookie. | waitingRoomCookieEnabled is true AND waitingRoomCookieAdvanced is true AND waitingRoomCookieDomainType is CUSTOMER | {"displayType":"string","tag":"input","type":"text"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"waitingRoomCookieEnabled","op":"eq","value":true},{"attribute":"waitingRoomCookieAdvanced","op":"eq","value":true},{"attribute":"waitingRoomCookieDomainType","op":"eq","value":"CUSTOMER"}]}} |
waitingRoomCookieHttpOnly | boolean | Applies the | waitingRoomCookieEnabled is true AND waitingRoomCookieAdvanced is true | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"op":"and","params":[{"attribute":"enabled","op":"eq","value":true},{"attribute":"waitingRoomCookieEnabled","op":"eq","value":true},{"attribute":"waitingRoomCookieAdvanced","op":"eq","value":true}]}} |
waitingRoomStatusCode | number | Specifies the response code for requests sent to the waiting room. | {"displayType":"number","tag":"input","type":"number"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
waitingRoomUseCpCode | boolean | Allows you to assign a different CP code that tracks any requests that are sent to the waiting room. | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
waitingRoomCpCode | object | Specifies a CP code for requests sent to the waiting room. You only need to provide the initial | waitingRoomUseCpCode is true | {"displayType":"object","tag":"input","todo":true} {"if":{"attribute":"waitingRoomUseCpCode","op":"eq","value":true}} |
waitingRoomCpCode.cpCodeLimits | array | Read-only. Describes the current usage limit for the CP code. | ||
waitingRoomCpCode.createdDate | integer | Read-only. UNIX epoch timestamp reflecting when the CP code was originally created. | ||
waitingRoomCpCode.description | string | Read-only. Additional description for the CP code. | ||
waitingRoomCpCode.id | integer | Unique identifier for each CP code. Initially, you get this value when creating a new CP code in PAPI. You can also assign a | ||
waitingRoomCpCode.name | string | Read-only. The name of the CP code you specify as the | ||
waitingRoomCpCode.products | array | Read-only. The set of products the CP code is assigned to. This reflects | ||
waitingRoomNetStorage | object | Specifies the NetStorage domain for the waiting room page. | {"displayType":"object","tag":"input","todo":true} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
waitingRoomNetStorage.cpCode | integer | Identifies a CP code assigned to this storage group. | ||
waitingRoomNetStorage.downloadDomainName | string | Domain name from which content can be downloaded. | ||
waitingRoomNetStorage.g2oToken | string | Signature Header Authentication key. | ||
waitingRoomNetStorage.id | integer | Unique identifier for the storage group. | ||
waitingRoomNetStorage.name | string | Name of the storage group. | ||
waitingRoomDirectory | string (allows variables) | Specifies the NetStorage directory that contains the static waiting room page, with no trailing slash character. | {"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
waitingRoomCacheTtl | number (5-30) | Specifies the waiting room page's time to live in the cache, | {"displayType":"number","max":[30],"min":[5],"tag":"input","type":"range"} {"if":{"attribute":"enabled","op":"eq","value":true}} |