Synap Academy

Facet best practice

Deeper dive into what each facet type does and how to set up your content to make best use of the results pages
All attempts that you want to use the analytics system will need to contain questions that are faceted. There are 3 Types of facets:
  • Content
  • Skill
  • Difficulty
We recommend that you do not use multiple of the same facets on a question. For example one question should only have one of each facet set to it. This is important for how the data displays in graphs to students
Walk through of results page using full facets
This section will use the below tags as an example to explain how facets have been decided.
Tags and their facets

📗 Content facets

All the content tag facets work together as part of a hierarchy. Use content facets to describe the material and show the relationship between content. The available facets are from highest to lowest: Exam, Module, Subject, Topic and Subtopic.
We recommend starting with Subject, Topic and Subtopic as they are the most important in terms of the breakdown graphs, and set a good benchmark to organise the rest of your content.
Alcohol is the subject, as it what all of its corresponding topics and subtopics have in common.
Topics are: Wine, Spirits, Beers because their corresponding subtopics can be grouped together by that topic.
Subtopics are: Red wine, to Lagers as subtopics as they are all independent enough from each other but are related back to their corresponding topic and subject. Spirits relates to Whiskey and Vodka, but not to IPA and Lager. All of them still relate to Alcohol, the subject
It's important to remember that these are all still tags, we are just adding an extra layer of definition on top of them.
Once you've defined a set of content tags, users, admins and educators will be able to see a attempt breakdown against each facet in the results for that quiz or exam.
Example of content broken down by subject, topic and subtopic

Additional content facets

Add Exam and Module facets on top of content to provide an extra layer of grouping
Content facets with Exam and Module added
In this example Fermentation is the module and Biology the exam. Biology has many modules to it that could be used here to further group content together

📘 Skill facets

Setting up skill facets will enable to skill breakdown on the results page. You may find there is some overlap between skills and content tags, for example algebra is a skill but also a subject. The trick here is to prioritise what you want the users to see and visualise.
Skill facet examples
Skill definition for best practice A skill is a learned ability or proficiency in a specific area. It is something that a person becomes better at through practice. For example: Verbal Reasoning, Problem Solving, Decision Analysis.

📙 Difficulty facets

Similar to skill, difficulty tags a will display a score on an attempt by difficulty. We don't impose any requirements on what is or isn't a difficulty. Tags that require are difficulty facet should be fairly independent and easy to identify from all other facet types.
Difficulty facet examples
Difficulty definition for best practice Difficulty is the level of effort involved in answering a question correctly. Something that is difficult requires more effort, skill or knowledge to complete. Examples of difficulty are: Easy, Medium, Hard
Example graphs breaking down by Skill and Difficulty facets
In general skills are what your users need to possess to answer a question well, and difficulty is how much effort and how many of those skills are required to answer it. Keep this in mind when setting up your facets. You may wish to not assign difficulty facets until your questions have been used by a large group, then you can export data on your questions to see what the correct answer rate of each questions is. Then create diffuculty tags based on those responses. (Feel free to get in touch with support to talk about this in more detail)