Articles in this section

Linking Assessments to Your Website

Avatar
Nina
  • Updated
Follow

There are two options for linking your assessment to your website:

  • Option 1-Creating a URL that links straight to a new response. This takes your respondent to the first page of the assessment. Optionally they may be taken to a payment page first.
  • Option 2-Linking to your Available Assessments screen. Use this option when you want your respondent to be taken to a landing page with a list of your available assessments. You can also list a price for each assessment if needed.

Plus, we will cover:

  • How to pull through respondent information into your response settings. When a respondent takes your assessment via a link, you don’t have their preloaded details in the response settings like you do when you have uploaded them into the system to send an email invite. You can set up fields in the assessment that will automatically populate their response details for easy management of responses.  Learn how to set this up here. 

Option 1-Linking straight to a response

Use Option 1 to create a link that allows:

  • People to follow the link on your website or social media page.
  • An open link that can be forwarded to anyone by email or otherwise.

These are the steps:

Step Instruction
1. Enable “Auto Create Responses”

On the "Assessment Settings'' screen tick the checkbox for "Auto Create Response".

auto_create_responses.png
2. Enter a code into the External ID field

Then enter any code in the External ID field. This will show in your URL.

-The External ID cannot have any spaces in it - but you can have a dash (-) e.g.Assess-Me.

-The External ID cannot have more than 50 characters.

-Important: Ensure that you only have one version of the assessment with this External ID - otherwise the system may pick up either.
3. Press Copy URL

Press 'Copy URL' to copy your shareable link.

 

It will look something like this:

https://tryme.brilliantassessments.com?external=try-me
4. Identify where the response came from

Organization ID

This option is available to identify where the responses came from by adding an Organization encrypted key:

  • To add the Organization encrypted key to your URL, type: &org=, then copy and paste your organization encrypted key.

encrypted_URL.png

  • To find the encrypted key go to organizations>edit> then copy and paste the encrypted key

encrypted_kay.png

 

Classifier ID

This option is available if you want to specify the Classifier as a parameter on your URL:

  • To specify the classifier as a parameter on your URL, you add the following:  &classifiers[0].key=aaaaa&classifiers[0].value=bbbbb
    • Where aaaaa is the name of the classifier, and bbbbb is the value you want assigned.
       
  • In the scenario you would need to specify more than one classifier, you would add (example for two below): &classifiers[0].key=aaaaa&classifiers[0].value=bbbbb&classifiers[1].key=ccccc&classifiers[1].value=ddddd
     
    • aaaaa is the name of the first classifier, and bbbbb is the value you want assigned; ccccc is the name of the second classifier, and ddddd is the value you want assigned

The Classifier must be marked as Admin Entry and you can have two or more parameters specified.

We recommend avoiding classifiers with spaces in them as they are not normally allowed in a URL, and if you or your clients are copying and pasting them a lot of tools will break the URL at the space.

 

NB. The syntax of URLs when you have multiple parameters is for the first parameter to have a /? before it and subsequent parameters to have an & before it (with no spaces in either case). 
5. Charging for your assessment If you wish to charge for your assessment through the system refer to How do I charge for an assessment response – Brilliant Assessments.

 

Option 2- Linking to the Available Assessments screen

You can link to an Available Assessments screen from your website.  This screen will list all of the assessments you have available.  Optionally it can also list a price for each assessment, and take the respondent into credit card processing before initiating the response.  This functionality is dependent on you setting up a credit card account with stripe.com.

Read more detail on Available Assessments

 

Related articles

Comments

0 comments

Please sign in to leave a comment.