Precision settings allow you to customize the way WalkMe identifies elements on your website. Using precision settings you can see how easily WalkMe identifies a given element on your site and modify the way the WalkMe algorithm works. Modifying precision settings optimizes the way that WalkMe’s algorithm performs on your site and is usually used to resolve issues or maximize performance.
The Short Version
Any time you use the WalkMe Editor to select an Element on your site, whether it’s for a Smart Walk-Thru step, Launcher, SmartTip or as a Rule type in the Rule Engine, WalkMe uses its proprietary algorithm to scan the page and identify your Element. Each Element is given an Element Grade, which tells you how easily WalkMe can identify this Element again in the future.
Since every website is unique, it may be necessary to modify the way the WalkMe algorithm works to identify specific Elements. It is helpful to change precision settings when WalkMe may be misidentifying or not finding your selected Element. Precision settings are also used to optimize performance when selecting Elements, usually by using jQuery selectors.
Uses for Precision Settings
- Increase the precision level of the algorithm if WalkMe Items appear on incorrect Elements on your site;
- Decrease the Precision level of the algorithm if WalkMe cannot find your selected Element;
- Ignore the text of your Element if it may appear in multiple languages;
- Ignore the ID for an Element on your website when it changes constantly;
- Use a jQuery selector for Launchers that are Strong Pinned to optimize performance;
- Ignore the position of a button that might move on the screen when the size of your browser window changes.
How It Works
Whenever WalkMe plays a Smart Walk-Thru Step, shows a Launcher or displays a set of SmartTips, it starts by scanning the page using our proprietary algorithm to try and locate your selected Element. The WalkMe algorithm uses a variety of factors, such as the text of your Element, its placement on the page and other attributes in the HTML code such as ID and Class.
Each Element on your site, whether it’s a button, heading, field or link has unique attributes, some more unique than others. To help you understand how unique an Element’s attribute is on your site we give it a precision level, also known as an Element Grade. This Grade refers to how unique the Element is, and how easily WalkMe will be able to find it again.
When an Element is difficult to identify, has a low precision score, or when the code and layout of your site change on page load or screen size change, WalkMe may have trouble locating your selected Element. When this happens, WalkMe may misidentify the element on the page or simply not play your WalkMe item.
To customize the way that the WalkMe algorithm works on your site, use the precision tool to modify settings. Some precision settings are, by necessity, modified globally (for all Elements) by our specialists, so it’s important to check with your CSM if you plan to change precision settings.
Checking Element Precision
WalkMe gives an Element Grade based on how easily WalkMe can identify an Element and distinguish it from all other Elements on the page. The Element Grade is displayed in the configuration view for a Smart Walk-Thru Step Balloon, Launcher, or SmartTip that appears immediately after selecting an Element. It is found in the Precision tab in the Options menu of a respective item. If you select an element to use as a Rule type in the Rule Engine, find Precision options by clicking on the gear icon.
Test an Element’s Grade by visiting the page on which your WalkMe Item should appear and open the precision settings. WalkMe analyzes the current page in the browser and gives the Element a Grade. If it does not see the Element on this page, you will receive the following message: “The Element is not available on this page.”
View Element Grade in the Flow Tracker when testing a Smart Walk-Thru to the right of the Step. The Flow Tracker displays a “looking for Element” magnifying glass icon until it locates the Element on the page. Once the Element is located, the Element Grade will appear to the left of the step in the Flow Tracker.
For Elements used in a Rule, click the Rule in the Flow Tracker. If the Element is found on the page then an eyeball with a check mark appears. If the Element is not found, then an exclamation point appears.
Understanding Element Grades
The Element Grade scale is from one through five, where five green bars is the highest score possible.
Generally, we regard three bars or higher as a good score. Elements with less than three bars may still be identified consistently by WalkMe, but it’s recommended that you thoroughly test these WalkMe Items. When using jQuery selectors, precision does not display an Element Grade, because it uses your selector to identify the Element. Learn more about jQuery Selectors.
Re-Selecting Your Element
When you initially select your Element, you can modify your selection to improve the Element Grade. You can either expand your selection, narrow your selection or simply re-select the Element entirely.
After an Element is selected, use precision settings to view the Element Grade and to modify the way the algorithm works. Precision settings are located in the options menu for your WalkMe items. To re-select your element, click Re-Select Element at the bottom of the options menu.
For Rules that use Elements, click the Re-select Element icon on your Rule statement.
Fine-tune the WalkMe algorithm to ensure it identifies your Element correctly if necessary in the Precision tab in the Options menu for steps, Launchers, and SmartTips. Precision can be altered by identifying by type of Element, bypassing a selected characteristic, or by modifying the general precision level.
Direct WalkMe to focus on certain attributes:
- Default: WalkMe uses the default settings for the algorithm;
- Identify by Text: Identifies the Element specifically by its text in the HTML code.This is only valid for Elements that actually contain text that is identified in the HTML; some Elements with text are images but do not contain text. When this option is selected, the text from the Element will autofill in the input field (without spaces, not case-sensitive). Notice that when choosing this option, you can’t use any other bypass options;
- jQuery Selector: Using a jQuery selector is the most precise way to identify an Element because it allows you to create a custom selector to identify the Element. Use a custom jQuery selector when an Element is very difficult for WalkMe to identify. Writing a jQuery selector can help WalkMe to find Elements if you use Multi-Language and your website has dynamic IDs (i.e., the Element’s code changes when the page is reloaded).
Direct WalkMe to ignore certain attributes.
- Text: The algorithm ignores any HTML text within the Element (number, text, or character). Bypass text for Elements that appear in multiple languages or that may use dynamic text;
- ID: The algorithm ignores the Element ID in the HTML code. If the Element you selected has a variable or dynamic ID (ID is constantly changing when a page is loaded), configure WalkMe to ignore ID;
- Position: The algorithm ignores the position of the Element on screen. Use if an Element changes location on screen. This may happen if your user has a different screen size and your site is designed to reformat the layout. If you would like to apply one of these bypass options to all Elements captured, contact your CSM who can quickly add this feature.
When WalkMe checks the page for an Element, it analyzes all Elements that match most of the attributes on the page and gives it a numerical score. The algorithm selects the Element with the highest score and plays the step.
- High: Use this setting if Elements similar to the one that was chosen are being identified by WalkMe (i.e., steps or launchers appear on the wrong Element). Setting to High should avoid misidentification;
- Medium: This is the default precision level and is sufficient in most cases;
- Low: Use this setting in cases where the algorithm cannot find your Element on the screen because the position of Elements is constantly changing.
Resolving Common Issues
My Element Grade is Low
An Element Grade less than three bars is not necessarily a problem; start by testing out your Smart Walk-Thru in Preview mode and even on your website’s Test environment.
If WalkMe cannot find your Element or it appears on the wrong element use the steps listed below.
I need to Strong Pin a Launcher or SmartTip
If you want WalkMe to continually look for an Element so that when it appears a Launcher or SmartTip will be displayed, then you must add a jQuery selector in the precision. jQuery selectors help WalkMe to identify your Element without affecting performance. Using Strong Pin on a Launcher or SmartTip without adding a jQuery selector may cause performance issues and is not recommended.
Smart Walk-Thru Step, Launcher or SmartTip appears on the wrong Element.
Try changing your Precision level to High or re-selecting the Element. If the issue persists try using the Identify by Text type or writing a jQuery selector. If you use Multi-Language avoid Identify by tText and use a jQuery selector.
Smart Walk-Thru Step, Launcher or SmartTip Element cannot be found.
Try changing your Precision level to Low or re-selecting your Element. If the issue persists, try using some of the bypass options. Often ignoring ID can resolve any issues if an Element’s ID changes whenever a page is reloaded. If this does not help them use a jQuery selector.
Try it Out
- Create a Smart Walk-Thru Step. Open your Precision settings and see how the Element Grade changes when you select different precision levels and bypass options;
- For a Rule that uses On Screen Element or Selected Element click the gear icon and check your Element Grade. When selecting an Element, try using the Expand Selection and Narrow Selection buttons to see how your selection and Element Grade changes.