Seeded benchmarks let you compare respondents against benchmark values that you supply, for example published industry figures or results from an earlier study, rather than against the responses collected in Brilliant Assessments. You upload the values in a CSV file.
On this page
1. Before you start
- Confirm that Use Benchmarking is ticked on Assessment Settings > General.
- Confirm that the All Responses Label is set on the same tab. Benchmarks do not display without it.
- Finalize the names of your sections, subsections and themes. The benchmark file is matched to these names, so renaming them later means updating the file.
2. Decide what the benchmark is compared against
Before you create the classifier, decide which of the following you need. The answer determines where the classifier is linked.
| You want to compare | Example | Follow |
|---|---|---|
| Every respondent against one set of values | All respondents compared against a single published industry average | Section A |
| Each respondent against the values for their own group | Respondents compared against others with the same years of service | Section B |
A classifier is linked in one place only. A classifier used for Section B must not also be selected in Assessment Settings.
3. Section A. Benchmark against the entire assessment
Step 1. Create the classifier
- Go to Site Settings > Features. If Use Classifier is not ticked, tick it and click Save.
- Open the Classifiers tab and click Add Classifier.
- Enter a Classifier Name, for example Industry Average. This name is used in column A of the benchmark file.
- Note the Classifier No. You use this number in your report merge strings.
- Tick Benchmark and set the Calculation Type to Seeded.
- Enter a Benchmark Label, for example
Industry average. - Enter 0 in Benchmark Minimum Values. This field is required when Benchmark is ticked.
- Click Save.
Note: The Download Template and Upload Data buttons appear as soon as you select Seeded, but the template cannot be downloaded until the classifier is linked in Step 2.
Step 2. Link the classifier to the assessment
- Open the assessment's Assessment Settings and go to the General tab.
- Scroll down to Additional Benchmark and select the classifier.
- Click Save.
Step 3. Download the template
- Go to Site Settings > Features > Classifiers and click Edit on the classifier.
- Click Download Template, select the assessment, and click Download.
Step 4. Fill in the benchmark file
Leave the Benchmark Answer column blank on every row. The file contains one set of rows: the assessment-level row first, followed by a row for each section, subsection or theme you want to benchmark. See Filling in the benchmark file below for what each column needs.
Step 5. Upload the file. See Uploading the file below.
4. Section B. Benchmark for each Benchmark Answer
This section uses a Years of Service example. Respondents answer "How long have you worked here?" with Less than 1 year, 1-3 years, 3-5 years or More than 5 years, and each answer has its own benchmark scores.
Step 1. Create the classifier
- Go to Site Settings > Features. If Use Classifier is not ticked, tick it and click Save.
- Open the Classifiers tab and click Add Classifier.
- Enter a Classifier Name, for example Years of Service. This name is used in column A of the benchmark file.
- Note the Classifier No. You use this number in your report merge strings.
- Tick Benchmark and set the Calculation Type to Seeded.
- Enter a Benchmark Label. Use
{Classifier}to insert the respondent's answer, for exampleStaff with {Classifier} of service. - Enter 0 in Benchmark Minimum Values. This field is required when Benchmark is ticked.
- Click Save.
Note: The template cannot be downloaded until the classifier is linked in Step 2.
Step 2. Link the classifier to the question
- In the Builder, click Edit on the question whose answers are benchmarked (a single choice or drop-down list question).
- Open the Options tab and select the classifier in the Classifier list.
- Click Save.
Each answer to the question is now a classifier value. Do not select this classifier in Assessment Settings > Additional Benchmark.
If the group is worked out from other answers rather than chosen directly, link the classifier to a result calculation instead, on the calculation's Options tab. The text the calculation returns becomes the classifier value. See How do I benchmark respondents by a band that a calculation works out?.
To remove a classifier from a question or calculation, hold down Ctrl and click it in the Classifier list.
Step 3. Download the template
- Go to Site Settings > Features > Classifiers and click Edit on the classifier.
- Click Download Template, select the assessment, and click Download.
Step 4. Fill in the benchmark file
Create a set of rows for each answer. Each set starts with the assessment-level row, followed by a row for each section, subsection or theme you want to benchmark. Enter the answer in the Benchmark Answer column exactly as it appears in the question.
Step 5. Upload the file. See Uploading the file below.
5. Filling in the benchmark file
The template contains a row for the overall assessment score, and for every section, subsection and theme in the linked assessment. Once benchmark data has been uploaded, the download contains that data instead, ready for updating.
| Column | What to enter |
|---|---|
| A. Classifier Name | The Classifier Name exactly as entered when the classifier was created. |
| B. Benchmark Answer | Section A: leave blank. Section B: the answer this row applies to. It must match the answer text, or the calculation result, exactly. The match is case-sensitive, so "1-3 years" and "1-3 Years" are different values. It cannot contain a comma, because a comma splits the value into two columns in a CSV file. |
| C. Section | The section name for section and subsection rows. Leave it blank for the assessment-level row and theme rows. |
| D. SubSection | The subsection name for subsection rows only. |
| E. Theme | The theme name for theme rows only. |
| F. Percentage | The benchmark percentage score as a decimal, for example 0.75 for 75%. Required. |
| G. Answer Points | The benchmark average (Likert) score on any scale. Required. |
Rules for the file:
- Keep the assessment-level row. This is the row where Section, SubSection and Theme are all blank. In Section B, every Benchmark Answer needs its own assessment-level row. Do not delete it. If you do not report an overall benchmark, enter 1 in both Percentage and Answer Points as placeholders.
- Delete any rows you do not need, such as a welcome section, apart from the assessment-level rows.
- Enter a value in both Percentage and Answer Points on every row. If you only use one of them, enter 1 in the other.
- To convert a percentage to a Likert score, multiply the decimal by the number of points on your scale, for example 0.75 x 5 = 3.75 on a 5-point scale.
- Save the file as CSV (Comma delimited).
6. Uploading the file
- Go to Site Settings > Features > Classifiers and click Edit on the classifier.
- Click Upload Data.
- Select the rating the benchmark will be reported against. Most sites select Base. If the chart that shows this benchmark uses an advanced rating (the
RatingType=parameter), select that rating instead. See Using Advanced Ratings. - Choose your CSV file and click Upload.
A confirmation message appears when the upload succeeds. If it fails, the message lists the rows that could not be matched. See Why does my seeded benchmark upload fail?.
Note: If the classifier is linked to more than one assessment, the upload is checked against every linked assessment. All of them must have the same section, subsection and theme names. If they do not, create a separate seeded classifier for each assessment.
7. Reporting the benchmark
Seeded benchmark values are available as soon as the file is uploaded. They do not wait for the nightly benchmark refresh.
Add BM1= followed by your Classifier No to a chart or score merge string. For example, with Classifier No 5:
-
{BarMulti[SectionNo=ALL BM1=5]}shows each section score next to the benchmark. -
{RatingScore.Score[Survey BM1=5]}returns the benchmark percentage.
In Section B, each respondent is compared against the values for their own answer. On a single-value output such as a score merge string or a gauge, the benchmark replaces the respondent's score. Use a multi chart to show both. See Setting Up Benchmarks for Reporting and Displaying Scores in Report.
Tip: If you update the Benchmark Label on the classifier, open Assessment Settings, scroll to the bottom of the General tab and click Save for the new label to appear in your reports.
8. Updating seeded benchmarks
- Edit the classifier and click Download Template. The file contains the data currently uploaded.
- Make your changes, keeping the assessment-level rows.
- Save the file as CSV and upload it again with Upload Data.
Related Content
|
Setting up Classifiers & Benchmarks Learn how to set up other benchmark types and classifiers in your Brilliant Assessment |
Comments
0 comments
Article is closed for comments.