Understanding Token Functionality in the End Screen Score Report

Tokens in the End Screen Score Report in the Exam Management Portal function as placeholders that dynamically populate with candidate-specific data when generating an end-screen summary.

Understanding Token Functionality

The admin can select which tokens to include, allowing for a customized and dynamic score report. Tokens are added based on the exam structure and the available data, ensuring the report reflects each candidate’s unique exam experience.

Token Categories and Their Usage

  1. Candidate and Exam Identification

    • {candidate_name} → Displays the test-taker’s full name.
    • {exam_title} → Shows the name of the exam taken (e.g., "Travel Content Creator Certification").
    • {exam_code} → Displays the unique identifier for the exam (useful for administrative tracking).
    • {administration_date} → Reflects the exact date when the candidate took the exam.
  2. Pass/Fail & Scaled Scores

    • {exam_pass_fail_outcome} → Indicates if the candidate passed or failed.
    • {exam_scaled_score_integer} → Provides the total scaled score as a whole number.
    • {exam_scaled_score_two_decimal} → Provides the total scaled score with two decimal places (useful for precision-based reporting).
  3. Raw & Percentage Scores

    • {exam_raw_score} → Displays the total number of correctly answered questions.
    • {exam_percent_score_integer} → Shows the candidate’s percentage score rounded to the nearest whole number.
    • {exam_percent_score_two_decimal} → Displays the percentage score with two decimal places for precision.
  4. Topic and Section Performance Metrics

    • {root_topic_percent_score_integer} → Shows the percentage score for each primary exam topic as a whole number.
    • {root_topic_percent_score_two_decimal} → Provides the percentage score for each primary topic with decimal precision.
    • {exam_section_percent_score_two_decimal} → Displays the candidate’s performance in each exam section as a percentage with two decimals.
    • {section_percent_robust_scores} → May include statistical adjustments to improve reliability.
    • {section_raw_scores} → Shows the number of correct answers within each section.
    • {sections_outcomes} → Indicates pass/fail status for each section.
    • {root_topic_percent_robust_scores} → Adjusted topic-level percentage scores for fairness.
    • {root_topic_raw_scores} → Number of correct answers per root topic.
  5. Test Part Pass/Fail & Additional Analytics

    • {test_part_pass_fail_outcome} → Displays the pass/fail status for a specific test section if the exam is modular.

How Tokens Work in the End-Screen Design

When structuring the end-screen, the tokens will be embedded in a template. Once the exam is completed, the system dynamically replaces the tokens with real data. Here’s an example of how the final screen might appear:

Example of a Generated Score Report End-Screen

Congratulations, {candidate_name}!
You have completed the {exam_title} exam ({exam_code}) on {administration_date}.

Your Exam Results:

  • Final Outcome: {exam_pass_fail_outcome}
  • Scaled Score: {exam_scaled_score_integer}
  • Percentage Score: {exam_percent_score_integer}%
  • Root Topic Performance:
    • Topic 1: {root_topic_percent_score_integer}%
    • Topic 2: {root_topic_percent_score_integer}%

Section Breakdown:

  • Section 1: {exam_section_percent_score_two_decimal}%
  • Section 2: {exam_section_percent_score_two_decimal}%

Key Takeaways for Implementation

  • Consistency: Tokens ensure that all candidates receive structured and accurate reports.
  • Customization: Depending on the exam format, only relevant tokens should be used.
  • Precision: Decimal scores offer more detailed performance insights when needed.
  • Modularity: If the exam is divided into sections or topics, use section-based tokens for detailed reporting.

To see How to Create an End Screen Score Report by Adding Tokens, click here.

Contact Us

If you have any questions or need additional assistance, please contact us by either emailing support@certiverse.com or by submitting a ticket from this article.