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
1. Access Error Analysis from the main menu.
2. Scroll down to the errors table. Any custom errors will be indicated with a 'CST' (custom) label.
3. Under the ‘More’ column, click the ‘>’ arrow button to access the error side panel.
4. Details for the custom error will include:
- ‘Type’ (custom error)
- *‘Group error ID’
- ‘Message’ (error message as displayed on the error table)
How to filter custom errors
1. From the errors table, click the ‘Filter’ button.
2. Use the ‘Error type’ dropdown menu to filter by ‘Custom errors’.
3. Optionally, you can also filter by ‘Custom attributes’. Enter the “value” of any predefined custom attribute. Learn more about setting up custom attributes here.
4. Click ‘Filter’.
How to segment by custom errors
There are two key ways to segment by custom errors:
- From the Segments module: 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:
1. From the segment dropdown, search and select for the user action ‘Errors’.
2. Select ‘users who visited’: ‘any page’ or a ‘specific page’.
3. Select whether they ‘experienced’ or ‘haven’t experienced’ the error.
4. 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’. Optionally, click ‘Save as new Segment’ for future analyses.