How to Create a Synthetic User Journey
A Step-By-Step Guide
Step 1: Create a User Journey
Synthetic User Journeys must be added to an existing website within your account. Note: If the website hasn’t been created yet, click the “Add New” button and choose “Add a new Website”.
- Click “Add”
- Click “Add Monitor to Website”
- Under Performance, choose “User Journey”
- Give your Journey a name – e.g. “Testing the Checkout”
- Add a description (optional)
- Select a website, then click “Add Journey”
Once this process has completed, click “View Journey” to see your new User Journey.
Step 2: Writing a Journey Script
User Journeys consist of a series of Steps and Actions. Each Step corresponds to a single page on your site. Actions are the things you do on each page: e.g. take a screenshot, click a button, fill in a form.
- On the Journey Overview, Click “Create” under Script, or click “Script (Steps & Actions)” in the main menu
- In the Script Editor screen, click “Add Step” to start writing your Journey
- Give the step a name . E.g. “Home page”
- Add an action, e.g. capture a screenshot of the Home page
- When you’re ready to move to a new page in the Journey, click “Add Step”
- The first action is moving to the new page, normally done with a Click action. E.g. Click on the “Products” button in the website’s navigation
Continue to add actions and steps to build up your Journey. As you go along, it’s a good idea to use the “Save & Test” button. This will run your Journey and return results – letting you know if your steps are successful.
Use the “WaitForElement” action to pause the Journey whilst something loads.
If you’re struggling to work out what ‘selector’ to use when clicking/interacting with an element on the page – try using the “Inspect Element” feature available in most modern browsers.
Visit your website, then right click and click “Inspect Element” on the element you want to click on. This will show you the source code, and you can get the CSS Selector from there.
In Google Chrome, you can right-click on the source code in the Inspector and choose “Copy > Copy Selector” to get the exact CSS selector to use in the script.
Step 3: Starting the Journey
Once you’re happy with your script, return to the Overview to complete the setup.
- Click “Configure” under Regions & Interval
- Select how frequently the Journey will run. More frequent tests use more credits.
- Choose one or more regions to run from. The credits calculator underneath will tell you how many credits this will use.
- Click “Update”
- Finally, click “Start Journey” to begin testing your site.