How to Deliver Brillium Assessments to Thinkific Students

Steps to Start Delivering Brillium Exams to Thinkific Students.

This article offers a step-by-step guide for Thinkific users who have either a Brillium trial or a paid Brillium subscription. It covers the process of defining a Brillium Assessment and configuring it for delivery to Thinkific students. By following these steps, users can ensure a seamless integration between Brillium and the Thinkific platform.

Step 1: (Optional) Configure your workspace.

When creating a Brillium integration, it’s a good practice to create a separate workspace for assessments that will exchange data with external platforms. While this isn’t mandatory, it can simplify the maintenance and organization of assessments accessed through other platforms compared to those accessed directly or through other integrations like Zapier, Learning Management Systems, HRIS systems, or websites.

Create a Workspace

1. Select the Settings () icon
2. Select Workspaces
3. Right-click on the Workspace name that you wish to add a Workspace. This will add a Workspace below the selected Workspace in the hierarchy.
4. Select "Add Workspace" from the drop-down menu that appears.
5. Enter a Workspace name

Step 2: Configure Respondent Fields (Once per Workspace)

Respondent Fields are used to collect demographic information for students that complete your assessments. When integrating Brillium data with a Thinkific account, this information needs to include additional Thinkific data beyond name and email address. Some of this information is sent by Thinkific to ensure the proper student score is associated with the correct Thinkific student.

Thinkific automatically populates four Brillium Respondent fields with student information when an assessment is launched to ensure Brillium can send data back to the correctly matching student when an assessment is completed. Configuration of Respondent Fields is a process which only needs to take place ONCE for each Workspace used for Thinkific exam integration.

To configure Respondent Fields:

1. Select the gear icon and choose Respondent Fields from the menu that appears.
2. From the Predefined Set dropdown list, select Thinkific
3. If results already exist in your Brillium Workspace, a warning message may appear. Selecting the Confirm button on the warning page will save the change.

Now, you’ll notice that the Thinkific data fields are configured and ready to use. The next step is to create a Brillium assessment (if you haven’t already).

Create an Assessment

If you have not already created an assessment, create an assessment with Assessment Builder.

Step 3: Properties Tab

In addition to a Unique ID, each Brillium assessment has an Assessment Key (referred to as an “Exam Password” in Thinkific). Similar to the Unique ID, this key is automatically generated when an assessment is created but can be modified if necessary.

To change the Assessment Key, navigate to the Properties tab in Assessment Builder and click on the Change button.

How to find the Assessment Key

• Select Assessments from the main menu
• Select the ellipse icon next to the Assessment, located under the Actions column
• Select the link icon from the action menu that appears
• The Assessment Key is the series of alpha-numeric characters that follows “key=”

Step 4: Requirements Tab

Select the Requirements tab.

The Requirements tab in Assessment Builder is where you define the Introduction information, Agreement Terms, Login Page demographic fields, and Assessment Logout Options. These Logout Options tell Brillium where to return the student after the assessment is completed, typically a Thinkific course page. This action also confirms to the student that the assessment results are properly received and processed by Thinkific for the corresponding Exam lesson. 

This customization is done by adjusting the Logout button and its associated action under the Assessment Logout Options.

1. Navigate to the Assessment Logout Options section of the Requirements tab.
2. Next to Button Action, select Web Link.
3. Change the Button Label as desired (i.e. “Return to the Course”, see below for further explanation).
4. In the Link After Assessment field, enter the specific link back to the exam defined in the Thinkific course player. This is the URL for the Thinkific page where the student clicked the button to begin the exam.
5. Select Save.

Step 5: Feedback Tab

Select the Feedback tab.

The Feedback tab is where the end of assessment Pass or Fail feedback summary are defined. When creating a test, quiz, or certification exam in Brillium, a Passing Score for the assessment must be defined.

To set the passing score, enter the score percentage number in the Passing Score field on the Feedback tab. The number must be between 1 and 100.

Step 6: Integration Tab

Select the Integration tab.

The Integration tab is where parameters are defined to indicate where Brillium will send results once the assessment is completed. There are several integration methods available in Brillium, but to send student assessment results to Thinkific, the POST-FORM method must be used.

To define assessment integration parameters for an assessment, perform the following steps:

1. For Integration Method, select POST – Form from the dropdown list
2. The Link Password field may be left blank (see additional information under the Optional Assessment Builder Settings section of the Integration using HTTP POST and GET knowledge article.
3. For Postback Method, select Blind Post from dropdown list
4. The Postback URL field defines the Thinkific provided URL for Brillium to send the assessment results. This is typically in the form: “https://ENTER-YOUR-DOMAIN.thinkific.com/brillium_notify”
5. Select Save.

Once all the settings in Brillium are configured, return to the Thinkific account and create an Exam lesson.

Step 7: Develop a Thinkific exam lesson.

The final step is to define the Exam lesson in Thinkific with the proper settings to launch the assessment, sending the student to the Brillium exam, and ensuring the results are properly received by Thinkific when the exam is complete.

Create a Thinkific Exam Lesson

Within the Thinkific account, create an Exam lesson and enter the proper information in the following fields:

• Title: Enter an exam title.
• Brillium Root URL: This is the URL of your Brillium exam. This URL will be unique to your account and only include the domain and subdomain portion of your URL. For example, if your Brillium instance is at: https://abccompany.onlinetests.app, the root URL will be: https://abccompany.onlinetests.app
• Exam ID: This is equivalent to the assessment Unique ID in Brillium. (this can be found in Assessment Builder)
• Exam Password: This is equivalent to the Brillium "Assessment Key" defined on the Assessment Builder Properties tab.
• Entry Hash Password: When used, this is defined as the Link Password in the Brillium Assessment Builder Integrations tab. While this setting is recommended, it is not required.
• Passing Grade: This can be any number between 1 and 100. Ensure that it is the same value as entered in Brillium within the Assessment Builder Feedback tab under Passing Score.

EXAMPLE: Thinkific Exam Lesson Configuration

Step 8: Preview Thinkific Course

Be sure that your Thinkific course settings are saved, and Publish your course by setting the Course publish status to "Published"

Preview the Thinkific course and Exam Lesson:

1. From the Thinkific Publish tab, select the PREVIEW button
2. Select COURSE AS AN ENROLLED STUDENT from the PREVIEW dropdown menu

Troubleshooting - Thinkific Troubleshooting Checklist

If you find that Thinkific integration is not working as expected, review the following to ensure the exam setup is correct between both Brillium and Thinkific.