Sessions-Summary-with-Tags-Report - Report-types - Reports API

Sessions Summary with Tags Report

Shows a summary of sessions for a single learner, categorized by Tags.

You would want to use this to analyze the overall scores for a single learner across a series of sessions and categories, for example. You can drill-down into a particular category in order to investigate a series of related categories, for example, Activities or particular learning outcomes.

This report provides a drill-down view of the learner's performance within a particular Tag hierarchy (a pre-configured set of Tags). The first two levels of the Tag hierarchy are used.

For example, consider a given Tag hierarchy defines subject Tags, such as math or English, each comprising a set of topic areas such as arithmetic, geometry, literature, and grammar. For the given session(s), the report shows the percentage of correct, incorrect, and unattempted Items within each subject that the session(s) covered. Drilling down on a subject shows a further breakdown of the Items in each topic area of that subject.

The report dynamically determines which Items were served during the given session(s), and calculates the percentage score for each Tag as a proportion of all Items in the session assigned to that Tag. For example, if the session included eight Items tagged with math, and the learner had six correct responses, the report calculates a score of 75% for that Tag.

Scoring details

The report can be configured to calculate the Tag scores using the number of correct Items (dichotomous scoring), or as the sum of partial scores per Item per Tag (partial scoring).

Examples

// Example report configuration
{
    "id": "report-24",
    "type": "sessions-summary-by-question",
    "user_id": "mce_student",
    "session_ids": [
        "d7ad7585-a0c1-4c01-9762-44a85f55835c"
    ]
}

Attributes

  • type string

    The type of this report. Must be "sessions-summary-by-question".

  • id string

    The HTML element ID where you want this report to appear.

  • user_id string

    The ID of the user (learner) to report on.

  • session_ids array[string]

    An array of session IDs to include in the report.

    Note If you need more than 100 sessions, contact Learnosity Support.

  • render boolean

    Renders the report on your page at the location set with the specified HTML element ID.

    You would set this property to false if you wanted to receive the raw report data only and use your own custom UI to display it.

    Default: true

Was this article helpful?

Did you arrive here by accident? If so, learn more about Learnosity.