Maze allows you to record custom metadata on individual sessions by adding tags/parameters to your maze URL.
Use cases
- Tester identification. If you already know who your testers are, you can use URL tags to generate a unique tester link and pass in identifiable data about the tester (such as name, gender, email, etc.) in your results dashboard. This approach works best if you're using a third-party service to send out the maze links that allows you to pipe the identifying information into the link you share with them. Learn more in the section Generating custom URLs below.
- Completion tracking. If you need to track which participants completed your maze (for instance, for compensation purposes), you can pass an external tester ID as a URL tags.
Before you start
- You can only use tags when sending the maze URL to your own testers. URL tags are not available when using Maze's panel of hired testers.
- URL tags are not currently supported in the PWA.
- The tags
id
,createdAt
,email
anduserId
are already in use. Please don't use them as they won't register your information.
Using tags in your maze URLs
Maze uses a simple nomenclature to help you record data.
This is an example of a maze test URL:
t.maze.co/74641933
And this is the same test URL with a custom tag:
t.maze.co/74641933?source=slack
By sending that second URL to a tester, we will record the following additional information in the results dashboard:
- Source: Slack
You can chain as many tags as you want, and we will automatically associate the data with your tester: t.maze.co/74641933?source=slack&category=toast&...
Once your tester completes a mission, you will be able to see this data by clicking Show more button in the Testers tab of the Results page.
Generating custom URLs
You don't have to manually add tags to each individual link you send. If you send your test links via a third-party tool, they may have features that allow you to pipe the custom data in the URL dynamically.
For instance, you could send out URLs that include the following (example) syntax: t.maze.co/74641933?name={{firstName}}&gender={{gender}}
.
While we don't directly support or endorse them, there are several products you could potentially use to generate and distribute custom URLs, such as: