Guide Conditions
Rule conditions determine if a rule action is applied to your website. To add a rule condition, click Condition to see a list of conditions and condition samples, or use the Search field and start typing the name of a condition. Synonyms are included in the search so you don't need to know the exact condition name to find the one to add. You can define a rule to use a single condition or set multiple conditions for a rule. Guide requires all conditions to be met to apply the rule action.
Rule conditions are evaluated either statically or dynamically:
-
Statically: Rule conditions are evaluated on page refresh.
-
Dynamically: Rule conditions are evaluated when something changes on a page or when the visitor interacts with the page.
Chat Is Online
Use the Chat Is Online condition to limit an engagement based on when chat agents are or are not available. If you select multiple skills, Guide checks for available agents with all of the skills Used to automate delivery of interactions based on agent skills, abilities, and knowledge.
-
Toggle the Active/Inactive button to determine if you want agents available or unavailable for your rule criteria.
-
In the Search for queue/skills to add text box, start typing the names of the skills the agents should have. If you select multiple skills, the agents must have all skills.
Examples:
-
If agents are available for the chat skills identified, offer the visitor a template with the chat channel.
-
If agents are unavailable for the chat skill, offer the visitor a template with alternative channels for assistance, such as a bot or email.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
No |
Browser and SDK |
Dynamically |
Time In Queue |
Current Page
Use the Current Page condition to limit an engagement based on the web page the visitor is on.
- In the Select operator drop-down, select an operator. Use Equals to match an exact page URL. Use Contains to match a portion of the URL, such as the domain name.
- In the Type in url field, enter the URL or portion of URL to match. When using the Equals, operator, you must specify a complete URL.
- To add multiple URL values, click Add URL. When multiple values are set, only one of the URL values must be a match.
Examples:
-
When a visitor is on your checkout page, offer a proactive offer.
-
When a visitor is on any page with nice in the URL, offer a chat template.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
No |
Browser |
Statically |
Time Spent on Current Page |
Custom Variable
Use the Custom Variable condition to limit an engagement based on when a visitor variable relayed by JS API from the website meets the criteria specified.
- In the Variable input text field, enter the visitor variable name.
- In the Select operator drop-down, select the operator to use.
- In the Value input text field, enter the value that the variable should be for this condition.
- To enter multiple possible values, click Add value.
- To add another custom variable, click Add custom variable. If you set multiple variables, they must all match for the actions to execute.
Example:
-
When the visitor's shopping cart total is greater than $100, offer a proactive offer. This assumes you have created a variable for cart value.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Dynamically |
Custom Condition |
Date and Time
Use the Date and Time condition to limit an engagement according to the schedule you define.
-
Define when the actions should or should not run:
-
To define when the actions should run, select Include selected days and times.
-
To define when the actions should not run, select Exclude selected days and times.
-
- Define whether to run the actions on certain days of the week or over a time period:
- Use Day of the week, to select specific days of the week.
- Use Date range, to select a time period.
- Use the Choose time slot options to specify time periods for the condition, such as 09:00 to 12:00 and 13:00 to 16:00.
Examples:
-
Monday through Friday, 9:00 AM through 5:00 PM, display a template that offers a live chat option. For all other times, offer a template with a bot that addresses common requests.
-
On the week before a user conference, display a proactive offer with conference details.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
No |
Browser and SDK |
Dynamically |
Chat Is Online |
Device Type
Use the Device Type condition to limit an engagement based on the type of device that the visitor is using.
-
Select a device type. Options are:
- Mobile
-
Tablet
-
Desktop
You can select more than one device. The Desktop device also includes laptops.
Examples:
-
When a visitor is using a desktop, display a multi-channel template.
-
When a visitor is using a tablet or mobile device, offer a single channel template.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
No |
Browser and SDK |
Statically |
Browser |
Element Clicked
Use the Element Clicked condition to limit engagements based on if a visitor clicks on an area of your website. The area must be mapped by using the Engagement Mapper.
-
In the Select drop-down, select one or more mapped elements.
All mapped elements appear.
-
Use the Search field if needed to find a specific mapped element.
Examples:
-
When a visitor clicks the button to remove all items from the shopping cart, display a proactive offer that includes a discount code and a chat button.
Requires Guide license? | Where available | How Evaluated | See also |
---|---|---|---|
Yes |
Browser |
Dynamically |
Field Is Edited |
External API Call
Use the External API Call condition to limit an engagement based on when an external API endpoint returns true.
-
In the URL Address field, enter the URL of the external API endpoint to use.
Examples:
-
When a Salesforce API request returns true, display a proactive offer.
Requires Guide license? | Where available | How Evaluated | See also |
---|---|---|---|
Yes |
Browser and SDK |
Dynamically |
Custom Variable |
Visitor Tags
Use visitor tags to track certain visitors.
Excluded Visitor Tags
Use the Excluded Visitor Tags condition to limit engagements based on the tags that a visitor does not have. Visitors that don't have the tags you specify are shown the engagement.
Tags are assigned to visitors through an engagement rule that uses the Add tag to visitor action.
-
In the Search for add tags field, start typing the name of the tag.
-
Select the tag or tags to use.
Examples:
-
When a visitor does not have the ReturningVisitor tag, display a proactive offer.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Statically |
Included Visitor Tags |
Included Visitor Tags
Use the Included Visitor Tags condition to limit engagements based on the tags that are assigned to visitors. Visitors that have the tags you specify will see the engagement.
Tags are assigned to visitors through an engagement rule that uses the Add tag to visitor action.
-
Start typing the name of the tag in the Search for add tags field.
-
Select the tag or tags to use.
Example:
-
When a visitor has the ReturningVisitor tag, display a proactive offer.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Statically |
Excluded Visitor Tags |
External Referrer
Use the External Referrer condition to limit an engagement based on the website that sent a visitor to your site.
- Select an operator for the rule. To use a full URL, select Equals in the drop-down. To use a partial URL, select Contains.
- In the Type in url field, enter a site that sends visitors to your page.
- To include other possible referring URLs, click Add url.
Example:
-
When a visitor is sent to your website from a marketing campaign, display a proactive offer.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Dynamically |
Visited Pages |
Field Is Edited
Use the Field Is Edited condition to limit engagements to when a visitor is typing text in a mapped field. The field must be mapped by using the Engagement Mapper.
-
In the Select drop-down, select one or more mapped fields to monitor for visitor typing.
If you do not see the mapped field, you may need to map it by using the Engagement Mapper.
-
Select an operator.
-
Select the value that the visitor types in the field or fields. Click Add value to specify alternative values for the fields.
Example:
-
When the visitor edits the Coupon field and enters an expired or invalid coupon code, display a proactive offer with a new code.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Dynamically |
Element Clicked |
Menu Item Clicked
Use the Menu Item Clicked condition to limit engagements based on a visitor selecting a menu item. The menu must be mapped by using the Engagement Mapper.
-
In the Menu Item drop-down, select one or more mapped menu items. If you do not see the mapped menu to use, you may need to map the menu by using the Engagement Mapper.
-
Select an operator.
-
Enter a value.
-
Click Add value to add multiple options that the visitor can type in the menu.
Example:
-
When a visitor selects an item from a menu, display a proactive offer.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Dynamically |
Element Clicked |
New and Returning Visitors
Use the New and Returning Visitors condition to limit engagements based on whether the visitor is new to your website or is a returning visitor.
To execute the actions just for new visitors:
-
Select the New Visitors box.
-
Click Save.
To execute the actions just for returning visitors:
-
Select the Returning Visitors box.
-
Set the requirements for returning visitors. Set how many visits they made and within how many days the visits took place. The maximum time span is 365 days.
A visit is counted when the visitor navigates to a page on which Guide is embedded. A visit ends after 30 minutes of inactivity.
-
Click Save.
If you select both the New Visitors and Returning Visitors boxes, the engagement rule fires if the visitor is new or meets the returning visitor requirements.
Note that visitor data is stored in the browser. If a visitor switches browsers, they are considered a new visitor.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Statically |
Visited Pages |
Page Element Exists
Use the Page Element Exists condition to limit engagements based on when a mapped element appears on a page. This condition requires the use of the Engagement Mapper.
-
Select one or more mapped elements from the drop-down list. If you select more than one mapped element, they must all appear on the page.
Examples:
-
When the Discount field appears on a page, display a proactive offer that includes the latest discount code.
-
When an error message appears when filling out a form, display a proactive offer with a chat button.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Dynamically |
Element Clicked |
Proactive Action Grace Period
Use the Proactive Action Grace Period condition to limit engagements based on the last time a proactive action was used. Use this to pause offering another proactive action. Any actions in this engagement rule that would be run during this time frame are skipped. The maximum grace period for proactive actions is 30 days.
-
In the first field, enter a number of days from 0-29.
-
In the second field, enter a number of hours from 0-23.
-
In the third field, enter the number of minutes from 0-59.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Dynamically |
Probability of Execution |
Probability of Execution
Use the Probability of Execution condition to limit engagements based on a percentage of time.
-
Drag the slider to a percentage between 0 and 100%. 100% means the action executes every time. 0% means the action never executes.
Examples:
-
To only run the actions 50% of the time, drag the slider bar to 50.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Dynamically |
Proactive Action Grace Period |
Rage Clicking
Use the Rage Clicking condition to limit engagements based on when a visitor is struggling and starts rage clicking on a page that meets the specified URL criteria.
- In the drop-down, select an operator. Use Equals to match an exact page URL. Use Contains to match a portion of the URL, such as the domain name.
- In the Type in url field, enter the URL or portion of URL to match. When using the Equals, operator, you must specify a complete URL.
-
Click Add url to specify multiple pages.
Example:
-
When a visitor rage clicks on the return policy page, display a proactive offer. For example, it might include a chat button and a portal of CXone Expert articles with details on return options.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Dynamically |
Element Clicked |
Scroll Depth
Use the Scroll Depth condition to limit an engagement based on how far down a page a visitor scrolls. Use the slider to select a percentage.
-
Drag the slider to a percentage between 0 and 100%. 100% means the visitor scrolls to the bottom of the page. 50% means the visitor scrolled down at least half of the page.
Examples:
-
When a user scrolls down more than 50% of any page, display a proactive offer.
-
Use this with the Current Page condition to limit the page on which the scroll depth is evaluated.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Dynamically |
Time Spent on Current Page |
Time
Use the time conditions to create criteria related to time, including the average queue wait time or how long a visitor spends on a page or your website.
Time in Queue
Use the Time in Queue condition to limit engagements based on the average queue wait time (over the past hour) for the selected skills.
-
Select the skills to use when determining the average wait time.
-
Select an operator such as Greater than or Lower than.
-
Enter the wait time in minutes and seconds. The maximum wait time you can specify is 30 minutes and 0 seconds.
Example:
-
When the average wait time is less than 2 minutes, display a template that includes the Chat button. Create a second rule that if the wait time is more than 2 minutes, display a different template that does not include the Chat button.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
No |
Browser and SDK |
Dynamically |
Chat Is Online |
Time Spent on Current Page
Use the Time Spent on Current Page condition to limit engagements based how much time a visitor spends on a page. If the visitor switches pages, the timer is reset to 0.
-
Enter the number of seconds the visitor is on a page.
-
To limit the action to specific pages, also add the Current Page condition.
Example:
-
If a visitor spends more than 3 minutes on a page, display a template with multiple channels.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser and SDK |
Dynamically |
Time Spent on Page |
Time Spent on Page
Use the Time Spent on Page condition to limit engagements based on when a visitor’s time on the selected pages meets the criteria specified here. Time continues accumulating when the visitor navigates to any of the selected pages:
- Select an operator for the condition. For example, to use a full URL, select Equals in the drop-down. To use a partial URL, select Contains.
- In the Type in url field, enter the URL for the page.
- To include other pages, click Add url and repeat adding an operator and a URL.
- Select an operator and then choose the number of seconds to stay on the pages for the action to be offered.
Example:
-
When a visitor spends more than 5 minutes on a page pertaining to the services you offer, display a proactive offer with a chat button.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser and SDK |
Dynamically |
Time Spent on Current Page |
Time Spent on Site
Use the Time Spent on Site condition to limit engagements based on the total time a visitor spends on your website over the number of days specified.
-
Select an operator for the condition. For example, Lower than or Equals.
-
Enter the number of minutes for the visitor to spend on your website.
-
Enter the number of passed days.
Example:
-
When a visitor spends greater than 60 minutes on your website over the past 4 days, display a proactive offer with a discount.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Dynamically |
Time Spent on Page |
UTM
The UTM conditions let you use the digital marketing campaign parameters that are passed in a URL to determine when to offer a Guide engagement.
UTM Campaign
Use the UTM Campaign condition to limit engagements based on the value of the visitor's UTM Campaign parameter.
-
Select an operator for the condition. For example, select Equals.
-
Enter a campaign name.
Example:
-
When a visitor's UTM campaign setting is set to social, show them a proactive welcome offer.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Statically |
External Referrer or Included Visitor Tags |
UTM Content
Use the UTM Content condition to limit engagements based on the value of the visitor's UTM Content parameter.
-
Select an operator for the condition. For example, select Equals.
-
Enter the content name.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Statically |
External Referrer or Included Visitor Tags |
UTM Medium
Use the UTM Medium condition to limit engagements based on the value of the visitor's UTM Medium parameter.
-
Select an operator for the condition. For example, select Equals.
-
Enter a medium name.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Statically |
External Referrer or Included Visitor Tags |
UTM Source
Use the UTM Source condition to limit engagements based on the value of the visitor's UTM Source parameter.
-
Select an operator for the condition. For example, select Equals.
-
Enter a source name.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Statically |
External Referrer or Included Visitor Tags |
UTM Terms
Use the UTM Terms condition to limit engagements based on the value of the visitor's UTM Term parameter.
-
Select an operator for the condition. For example, select Equals.
-
Enter a term name.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser |
Statically |
External Referrer or Included Visitor Tags |
Visitor Fingerprints
These conditions are all based on data stored in a visitor's browser.
Browser
Use the Browser condition to limit an engagement based on the browser that the web visitor is using.
- Select one or more of the listed browsers.
- Select Other to add a browser not on the list.
- Click Add value to add additional browsers.
Examples:
-
When a visitor is using the Safari browser, offer a template with just chat.
-
When a visitor is using the Chrome browser, offer a template with chat and customer portal.
Requires Guide license? | Where available | How Evaluated | See Also |
---|---|---|---|
No |
Browser |
Statically |
Browser Version |
Browser Version
Use the Browser Version condition to limit an engagement based on the browser version number that the web visitor is using.
- Select an operator for the condition. For example, Equals or Contains.
- Enter the version number to use as criteria.
Example:
-
When a visitor is using a no longer supported version of a browser, display a proactive offer that includes a link for updating their browser.
Requires Guide license? | Where available | How Evaluated | See also |
---|---|---|---|
No |
Browser |
Statically |
Browser |
Country
Use the Country condition to limit an engagement based on the web visitor's browser country setting.
-
Expand the Country drop-down.
-
Select at least one country.
If you select multiple countries, the visitor's browser can be set to any of those countries.
Example:
-
When the visitor's browser country setting indicates France, display a customer portal template that offers French articles.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
No |
Browser |
Statically |
Language
Use the Language condition to limit engagements based on the visitor's browser language setting.
-
In the Language drop-down, select a language.
-
Optionally, in the Country drop-down, select a corresponding country to fine-tune the language setting.
Example:
-
When the visitor's browser language setting indicates French and the country is Canada, display a customer portal template that offers French Canadian articles.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
No |
Browser and SDK |
Statically |
Location |
Location
Use the Location condition to limit engagements based on the visitor's browser location setting.
-
In the Location field, enter a location.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
No |
Browser |
Statically |
Language |
Operating System
Use the Operating System condition to limit engagements based on the type of operating system that the visitor is using.
- Select one or more of the listed operating systems.
- Select Other to add an operating system not on the list.
- Click Add value to add additional operating systems.
Examples:
-
When a visitor is using the Windows, operating system, offer a template with fewer channels.
-
When a visitor is using the iOS operating system, offer a template with more channels.
-
Use this condition with the Operating System Version condition to identify visitors with specific operating system and operating system version combinations.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
No |
Browser and SDK |
Statically |
Operating System Version |
Operating System Version
Use the Operating System Version condition to limit engagements based on the version number of the operating system that the visitor is using. Typically, you would also specify the Operating System.
-
From the Contains drop-down, select an operator such as Equals or Contains.
-
Add an operating system version number.
-
Click Add value to include an alternative operating system version number.
Example:
-
When a visitor's operating system is Chrome and the operating system version is 125.0.6422.141, offer a proactive offer.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
No |
Browser and SDK |
Statically |
Operating System |
Visited Pages
Use the Visited Pages condition to limit engagements based on a page that a visitor has previously viewed or is currently viewing within a visit.
A visit continues until the visitor is inactive for 30 minutes. At that point, the visit is closed. If the visitor starts interacting with your website again, that is considered a new visit.
- Select an operator for the condition. For example, to use a full URL, select Equals in the drop-down. To use a partial URL, select Contains.
- In the Type in url field, enter the URL for the page.
- To include alternative pages, click Add url. When multiple URLs are set, only one of the URL values must be a match.
Example:
-
Display a proactive offer to visitors who have visited three pages regarding the different insurance plans that you offer. Set the Visited Pages condition three times, once for each page. Then set the action to offer a proactive offer with articles on selecting an insurance plan and a chat button.
Requires Guide license? | Where available | How Evaluated | see also |
---|---|---|---|
Yes |
Browser and SDK |
Statically |
Current Page or External Referrer |