{{ page.title }}

{{ page.description }}

A quiz is a quick and informal way to test a viewer's level of comprehension. Quizzes are used primarily in marketing and eLearning videos.

Before you get started

Before you can add interactivity to a player, you need a HapYak-enabled Brightcove Player and you need to make sure a Brightcove Interactivity project has been created. For information on how to do this, see Getting Started with Interactivity.

Adding a Quiz

Follow these steps to add a quiz to a project:

  1. Login to Brightcove Interactivity Studio (https://www.hapyak.com/login).
  2. In the left navigation, click Manage.
  3. Click on a project to open it.
  4. In the bottom toolbar, click on the question button.
  5. Enter the quiz question.
  6. Enter the answers. Click + Choice for an additional multiple choice option.  Click + Input for an additional free response input field.
  7. Indicate the correct answer(s) by checking the radio button next to them.
  8. Click + Question to add additional questions to the quiz.
  9. Click Done when done.

To delete any question, choice or input field, click the delete icon () associated with the item.

Configuring quiz options

To access the quiz options, click Options on the quiz dialog.

Review Screen

To access the review screen options, click Review screen on the quiz options menu.

Pass/Fail actions

To access the Pass/Fail actions options, click Pass/Fail actions on the quiz options menu.

There are On Pass and On Fail tabs that can be configured based on whether the viewer passes or fails the quiz. By default, to "pass" the quiz, the viewer must answer at least 51% of the questions correctly. This can be adjusted by clicking Set custom pass/fail threshold.

Notes on setting a custom pass/fail threshold

When quizzes are used for assessment, Brightcove Interactivity records a pass / fail determination for each quiz. Since the quiz annotation supports more than one question, the pass/fail threshold lets you define what percentage of those questions must be answered correctly for the user to "pass."

By default, the threshold to pass any quiz is 51%. You can override this percentage to apply your own standards. This is a tricky feature though, here's why. Brightcove Interactivity reports do not currently show "pass/fail" determinations, they only show correct/incorrect at the individual question level. The reason this feature exists is to properly mark the data for customers with a Learning Management System (LMS) integration or who use our APIs directly to access the data.

Requiring a user pass a quiz before advancing in a video

A common use case is to require that a viewer "pass" a quiz before they can advance forward in the video. This is referred to as "conditional gating" and this is supported by Brightcove Interactivity.

Follow these steps when configuring the quiz:

  1. Click Edit on the annotation.
  2. Click the Gate menu to set Gate:Y.
  3. Click Options > Review screen.
  4. Uncheck Allow viewer to see correct answer(s).
  5. Click SUBMIT.
  6. Click Options > Pass/Fail actions.
  7. Click the On Fail tab.
  8. Set Jump to video time to a Custom time of 00:00.000 seconds.
  9. Check Reset questions.
  10. Click SUBMIT.
  11. Click Done.

A viewer will not be able to proceed in the video until they have correctly answered the question. View an example here.

Creating a free response question

The default question type is multiple choice. To create a free response question:

  1. Delete the first multiple choice answer option
  2. Click "Add Text Input." (Note: Users must click the radio button next to the free response field).

Configuring how often questions are displayed

You can select to show the quiz annotations to the viewer only once or every time they view the video.

  1. Click SETTINGS.
  2. Locate Show questions and click ONLY ONCE or EVERY VIEW.