Custom errors enable you to track any line of code being executed, while users navigate your website. For example, if there's a line of code being executed when users try to purchase an item that’s out of stock, even though your site might have logic that prevents them from getting to the purchase page (for out of stock items).
How to view custom errors and their details
Filter custom errors from the Sessions with Errors widget
Filter to custom errors from the Sessions with Errors widget for a quick glance at the top custom errors impacting your sessions.
- From Error Analysis, select the 'Custom errors' rate card on the Sessions with Errors widget.
- Click onto any 'CST' error (custom error) to open the side panel and view more details.
Filter custom errors from the Error Explorer
Dive deeper into all custom errors from the Error Explorer - apply advanced filters, sort the results and use the tabs to focus the results on all pages, individual pages, or page groups.
- From Error Analysis, go to the Error Explorer.
- Click the 'Filter' button to filter to custom errors.
- Optionally, you can also filter by ‘Custom attributes’. Enter the “value” of any predefined custom attribute. Learn more about setting up custom attributes here.
- Click onto any 'CST' error (custom error) to open the side panel and view more details.
Tip: Search for a specific error
Use the search bar to quickly filter any specific custom error by entering a custom error message.
Custom error details
Details for the custom error will include:
- ‘Type’ (custom error)
- *‘Group error ID’
- ‘Message’ (error message as displayed on the error table)
How to segment by custom errors
There are two key ways to segment by custom errors:
- From the Segments capability: From the main menu, go to ‘Analysis set-up' tab > 'Segments’ to create and save a new segment to be used across other modules.
-
From the analysis context: From the menu go to ‘Error Analysis’ and click the ‘All users’ button from the analysis context.
Here's an example of segmenting by custom errors directly from the analysis context:
- From the segment dropdown, search and select for the user action ‘Errors’.
- Select ‘users who visited’: ‘any page’ or a ‘specific page’.
- Select whether they ‘experienced’ or ‘haven’t experienced’ the error.
- Select whether they experienced:
- ‘Any custom error’.
- ‘A custom error’: either enter the text of the custom error in the ‘that contains’ field, or the value of the attribute into ‘has a custom attribute’ field (or you can enter both).
- ‘An exact custom error’: enter the ‘error name’ and optionally add the value of the ‘custom attributes’.
- ‘A grouped custom error’: enter the ‘group ID’.
5. Click ‘Apply’. Or, click ‘Save as new Segment’ for future analyses.