Blackboard Logo Dev Docs
search rss_feed menu

Assessment Events

Blackboard Learn’s Caliper Analytics stream has two event types dedicated to assessments:

These events work hand-in-hand. An AssessmentEvent is fired whenever a student starts or submits a test, and the AssessmentItemEvent is fired whenever a student starts or submits a question on an assessment.

Here is some of the key data that is associated with these events:

AssessmentEvent

group.courseNumber - the course batch_uid (i.e. the ID sent in by LIS or Data Integration)

object.@id - …/assessments/id - the primary key for the assessment ID

action - Started, Completed

AssessmentItemEvent

group.courseNumber - the course batch_uid (i.e. the ID sent in by LIS or Data Integration)

object.@id - …/questions/id - the primary key for the question ID

object.ispartOf.@id …/assessments/id - the primary key for the assessment this questions is a part of

action - Started, Submitted

Sample Payloads

  1. AssessmentEvent
  2. AssessmentItemEvent

1. AssessmentEvent

{
  "sensor": "54b54b42-dd02-42f8-88ed-07bd719bfb7c",
  "sendTime": "2021-01-05T14:49:40.609Z",
  "dataVersion": "http://purl.imsglobal.org/ctx/caliper/v1p1",
  "data": [
    {
      "@context": "http://purl.imsglobal.org/ctx/caliper/v1p1",
      "type": "AssessmentEvent",
      "id": "54b54b42-dd02-42f8-88ed-07bd719bfb7c",
      "actor": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/a361d45a65564777b98460834687183f",
        "type": "Person",
        "extensions": {
          "bb:user.id": "_12345_1",
          "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
        }
      },
      "action": "Started",
      "object": {
        "dateToSubmit": "2021-01-12T06:59:00.000Z",
        "maxAttempts": 0,
        "maxSubmits": 0,
        "maxScore": 150,
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/assessments/_12345_1",
        "type": "Assessment",
        "name": "My Test",
        "extensions": {
          "bb:assessment.categoryId": "_12345_1",
          "bb:assessment.categoryName": "Assignment",
          "bb:contentId": "_12345_1",
          "bb:assessment.gradeableItemId": "_12345_1",
          "bb:assessment.catUserDefined": "false"
        },
        "creators": [],
        "learningObjectives": [],
        "keywords": [],
        "items": []
      },
      "generated": {
        "startedAtTime": "2021-01-05T14:49:36.451Z",
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/gradableItems/_12345_1/attempts/_12345_1",
        "type": "Attempt",
        "assignable": {
          "dateToSubmit": "2021-01-12T06:59:00.000Z",
          "maxAttempts": 0,
          "maxSubmits": 0,
          "maxScore": 150,
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/assessments/_12345_1",
          "type": "Assessment",
          "name": "My Test",
          "extensions": {
            "bb:assessment.categoryId": "_12345_1",
            "bb:assessment.categoryName": "Assignment",
            "bb:contentId": "_12345_1",
            "bb:assessment.gradeableItemId": "_12345_1",
            "bb:assessment.catUserDefined": "false"
          },
          "creators": [],
          "learningObjectives": [],
          "keywords": [],
          "items": []
        },
        "assignee": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/a361d45a65564777b98460834687183f",
          "type": "Person",
          "extensions": {
            "bb:user.id": "_12345_1",
            "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
          }
        },
        "count": 1
      },
      "eventTime": "2021-01-05T14:49:36.451Z",
      "edApp": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/applications/learn",
        "type": "SoftwareApplication"
      },
      "group": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/courses/34f0705416864ca09a34f22f73446686",
        "type": "CourseOffering",
        "extensions": {
          "bb:course.id": "_12345_1"
        },
        "members": [],
        "courseNumber": "BIO-101"
      },
      "membership": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/courses/34f0705416864ca09a34f22f73446686/members/a361d45a65564777b98460834687183f",
        "type": "Membership",
        "extensions": {
          "bb:course.id": "_12345_1",
          "bb:course.externalId": "BIO-101",
          "bb:user.id": "_12345_1",
          "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
        },
        "member": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/a361d45a65564777b98460834687183f",
          "type": "Person",
          "extensions": {
            "bb:user.id": "_12345_1",
            "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
          }
        },
        "organization": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/courses/34f0705416864ca09a34f22f73446686",
          "type": "CourseOffering",
          "extensions": {
            "bb:course.id": "_12345_1"
          },
          "members": [],
          "courseNumber": "BIO-101"
        },
        "roles": ["Learner"],
        "status": "Active"
      },
      "federatedSession": {
        "startedAtTime": "2021-01-05T14:49:36.451Z",
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/sessions/94DD6EFB1B20EBD3B62889A38C7BF590",
        "type": "LtiSession",
        "name": "94DD6EFB1B20EBD3B62889A38C7BF590",
        "dateCreated": "2021-01-05T14:49:36.451Z",
        "user": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/a361d45a65564777b98460834687183f",
          "type": "Person",
          "extensions": {
            "bb:user.id": "_12345_1",
            "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
          }
        }
      },
      "extensions": {}
    }
  ]
}

AssessmentItemEvent

{
  "sensor": "54b54b42-dd02-42f8-88ed-07bd719bfb7c",
  "sendTime": "2021-01-05T14:50:26.769Z",
  "dataVersion": "http://purl.imsglobal.org/ctx/caliper/v1p1",
  "data": [
    {
      "@context": "http://purl.imsglobal.org/ctx/caliper/v1p1",
      "type": "AssessmentItemEvent",
      "id": "54b54b42-dd02-42f8-88ed-07bd719bfb7c",
      "actor": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/1a26d8c5b4d44f1db491db1f24407715",
        "type": "Person",
        "extensions": {
          "bb:user.id": "_12345_1",
          "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
        }
      },
      "action": "Started",
      "object": {
        "maxAttempts": 0,
        "maxSubmits": 0,
        "maxScore": 0,
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/assessments/_12345_1/questions/_12345_1",
        "type": "AssessmentItem",
        "creators": [],
        "learningObjectives": [],
        "keywords": [],
        "isPartOf": {
          "dateToSubmit": "2020-12-23T07:59:00.000Z",
          "maxAttempts": 1,
          "maxSubmits": 0,
          "maxScore": 300,
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7cc/assessments/_12345_1",
          "type": "Assessment",
          "name": "My Test",
          "extensions": {
            "bb:assessment.categoryId": "_12345_1",
            "bb:assessment.categoryName": "Test",
            "bb:assessment.catUserDefined": "false",
            "bb:assessment.gradeableItemId": "_12345_1"
          },
          "creators": [],
          "learningObjectives": [],
          "keywords": [],
          "items": []
        }
      },
      "generated": {
        "startedAtTime": "2021-01-04T19:13:19.774Z",
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/assessments/_12345_1/questions/_12345_1/attempts/_12345_1",
        "type": "Attempt",
        "assignable": {
          "maxAttempts": 0,
          "maxSubmits": 0,
          "maxScore": 0,
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/assessments/_12345_1/questions/_12345_1",
          "type": "AssessmentItem",
          "creators": [],
          "learningObjectives": [],
          "keywords": [],
          "isPartOf": {
            "dateToSubmit": "2020-12-23T07:59:00.000Z",
            "maxAttempts": 1,
            "maxSubmits": 0,
            "maxScore": 300,
            "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/assessments/_12345_1",
            "type": "Assessment",
            "name": "My Test",
            "extensions": {
              "bb:assessment.categoryId": "_12345_1",
              "bb:assessment.categoryName": "Test",
              "bb:assessment.catUserDefined": "false",
              "bb:assessment.gradeableItemId": "_12345_1"
            },
            "creators": [],
            "learningObjectives": [],
            "keywords": [],
            "items": []
          }
        },
        "assignee": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/1a26d8c5b4d44f1db491db1f24407715",
          "type": "Person",
          "extensions": {
            "bb:user.id": "_12345_1",
            "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
          }
        },
        "count": 1
      },
      "eventTime": "2021-01-04T19:13:19.774Z",
      "edApp": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/applications/learn",
        "type": "SoftwareApplication"
      },
      "group": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/courses/35983609b6084ef88407f98a2263e574",
        "type": "CourseOffering",
        "extensions": {
          "bb:course.id": "_12345_1"
        },
        "members": [],
        "courseNumber": "BIO-101"
      },
      "membership": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/courses/35983609b6084ef88407f98a2263e574/members/1a26d8c5b4d44f1db491db1f24407715",
        "type": "Membership",
        "extensions": {
          "bb:course.id": "_12345_1",
          "bb:course.externalId": "BIO-101",
          "bb:user.id": "_12345_1",
          "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
        },
        "member": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/1a26d8c5b4d44f1db491db1f24407715",
          "type": "Person",
          "extensions": {
            "bb:user.id": "_12345_1",
            "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
          }
        },
        "organization": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/courses/35983609b6084ef88407f98a2263e574",
          "type": "CourseOffering",
          "extensions": {
            "bb:course.id": "_12345_1"
          },
          "members": [],
          "courseNumber": "BIO-101"
        },
        "roles": ["Learner"],
        "status": "Active"
      },
      "federatedSession": {
        "startedAtTime": "2021-01-04T19:13:19.774Z",
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/sessions/DCC5DE08316F7BB7F5355929DD49AE28",
        "type": "LtiSession",
        "name": "DCC5DE08316F7BB7F5355929DD49AE28",
        "dateCreated": "2021-01-04T19:13:19.774Z",
        "user": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/1a26d8c5b4d44f1db491db1f24407715",
          "type": "Person",
          "extensions": {
            "bb:user.id": "_12345_1",
            "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
          }
        }
      },
      "extensions": {}
    },
    {
      "@context": "http://purl.imsglobal.org/ctx/caliper/v1p1",
      "type": "AssessmentItemEvent",
      "id": "54b54b42-dd02-42f8-88ed-07bd719bfb7c",
      "actor": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/1a26d8c5b4d44f1db491db1f24407715",
        "type": "Person",
        "extensions": {
          "bb:user.id": "_12345_1",
          "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
        }
      },
      "action": "Completed",
      "object": {
        "maxAttempts": 0,
        "maxSubmits": 0,
        "maxScore": 0,
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/assessments/_9058464_1/questions/_9058487_1",
        "type": "AssessmentItem",
        "creators": [],
        "learningObjectives": [],
        "keywords": [],
        "isPartOf": {
          "dateToSubmit": "2020-12-23T07:59:00.000Z",
          "maxAttempts": 1,
          "maxSubmits": 0,
          "maxScore": 300,
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/assessments/_9058464_1",
          "type": "Assessment",
          "name": "My Test",
          "extensions": {
            "bb:assessment.categoryId": "_12345_1",
            "bb:assessment.categoryName": "Test",
            "bb:assessment.catUserDefined": "false",
            "bb:assessment.gradeableItemId": "_12345_1"
          },
          "creators": [],
          "learningObjectives": [],
          "keywords": [],
          "items": []
        }
      },
      "generated": {
        "startedAtTime": "2021-01-04T19:13:19.774Z",
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/assessments/_12345_1/questions/_12345_1/attempts/_12345_1/response",
        "type": "MultipleResponseResponse",
        "extensions": {
          "bb:questionType": "MultipleAnswer"
        },
        "attempt": {
          "startedAtTime": "2021-01-04T19:13:19.774Z",
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/assessments/_12345_1/questions/_12345_1/attempts/_12345_1",
          "type": "Attempt",
          "assignable": {
            "maxAttempts": 0,
            "maxSubmits": 0,
            "maxScore": 0,
            "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/assessments/_12345_1/questions/_12345_1",
            "type": "AssessmentItem",
            "creators": [],
            "learningObjectives": [],
            "keywords": [],
            "isPartOf": {
              "dateToSubmit": "2020-12-23T07:59:00.000Z",
              "maxAttempts": 1,
              "maxSubmits": 0,
              "maxScore": 300,
              "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/assessments/_12345_1",
              "type": "Assessment",
              "name": "My Test",
              "extensions": {
                "bb:assessment.categoryId": "_12345_1",
                "bb:assessment.categoryName": "Test",
                "bb:assessment.catUserDefined": "false",
                "bb:assessment.gradeableItemId": "_12345_1"
              },
              "creators": [],
              "learningObjectives": [],
              "keywords": [],
              "items": []
            }
          },
          "assignee": {
            "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/1a26d8c5b4d44f1db491db1f24407715",
            "type": "Person",
            "extensions": {
              "bb:user.id": "_12345_1",
              "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
            }
          },
          "count": 1
        },
        "values": []
      },
      "eventTime": "2021-01-04T19:13:19.774Z",
      "edApp": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/applications/learn",
        "type": "SoftwareApplication"
      },
      "group": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/courses/35983609b6084ef88407f98a2263e574",
        "type": "CourseOffering",
        "extensions": {
          "bb:course.id": "_12345_1"
        },
        "members": [],
        "courseNumber": "BIO-101"
      },
      "membership": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/courses/35983609b6084ef88407f98a2263e574/members/1a26d8c5b4d44f1db491db1f24407715",
        "type": "Membership",
        "extensions": {
          "bb:course.id": "_12345_1",
          "bb:course.externalId": "BIO-101",
          "bb:user.id": "_12345_1",
          "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
        },
        "member": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/1a26d8c5b4d44f1db491db1f24407715",
          "type": "Person",
          "extensions": {
            "bb:user.id": "_12345_1",
            "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
          }
        },
        "organization": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/courses/35983609b6084ef88407f98a2263e574",
          "type": "CourseOffering",
          "extensions": {
            "bb:course.id": "_12345_1"
          },
          "members": [],
          "courseNumber": "BIO-101"
        },
        "roles": ["Learner"],
        "status": "Active"
      },
      "federatedSession": {
        "startedAtTime": "2021-01-04T19:13:19.774Z",
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/sessions/DCC5DE08316F7BB7F5355929DD49AE28",
        "type": "LtiSession",
        "name": "DCC5DE08316F7BB7F5355929DD49AE28",
        "dateCreated": "2021-01-04T19:13:19.774Z",
        "user": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/1a26d8c5b4d44f1db491db1f24407715",
          "type": "Person",
          "extensions": {
            "bb:user.id": "_12345_1",
            "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
          }
        }
      },
      "extensions": {}
    }
  ]
}