Blackboard Logo Dev Docs search rss_feed menu

Blog Events

Blackboard Learn’s Caliper Analytics stream emits a BlogEvent whenever a student submits a blog entry in an original experience course. Here is some of the key data that is associated with these events:

BlogEvent

object.id - the primary key for the Blog

action - Created, Modified, Commented

extensions - contains a tag called bb:user.externalId with the batch_uid for the user

Sample Payload

Here is a sample of what an event payload might look like:

{
    "sensor": "530efc49-6b9f-40a6-918b-966ee83a744c",
    "sendTime": "2021-01-05T16:55:05.235Z",
    "dataVersion": "http://purl.imsglobal.org/ctx/caliper/v1p1",
    "data": [
        {
            "@context": [
                "http://caliper.blackboard.com/ctx/caliper/v1/Context",
                "http://purl.imsglobal.org/ctx/caliper/v1p1"
            ],
            "type": "http://caliper.blackboard.com/caliper/v1/BlogEvent",
            "id": "a6fa63b8-9db7-44f8-aff8-63b94b952ead",
            "actor": {
                "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/530efc49-6b9f-40a6-918b-966ee83a744c/users/9c60a9cdb3144d1aa77ff56c34ef248b",
                "type": "Person",
                "extensions": {
                    "bb:user.id": "_227_1",
                    "bb:user.externalId": "scott.hurrey@myschool.edu"
                }
            },
            "action": "Created",
            "object": {
                "@context": [
                    "http://caliper.blackboard.com/ctx/caliper/v1/Context",
                    "http://purl.imsglobal.org/ctx/caliper/v1p1"
                ],
                "type": "http://caliper.blackboard.com/caliper/v1/Blog",
                "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/530efc49-6b9f-40a6-918b-966ee83a744c/blog/_39_1",
                "name": "Test Blog",
                "description": "",
                "blogType": "INDIVIDUAL",
                "journal": false,
                "pointsPossible": 100,
                "extensions": {}
            },
            "generated": {
                "@context": [
                    "http://caliper.blackboard.com/ctx/caliper/v1/Context",
                    "http://purl.imsglobal.org/ctx/caliper/v1p1"
                ],
                "type": "http://caliper.blackboard.com/caliper/v1/BlogPost",
                "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/530efc49-6b9f-40a6-918b-966ee83a744c/blog/_39_1/post/_40_1",
                "name": "",
                "description": "",
                "anonymous": false,
                "attachedFilesCount": 0,
                "length": 51,
                "extensions": {}
            },
            "eventTime": "2021-01-05T16:55:03.225Z",
            "edApp": {
                "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/530efc49-6b9f-40a6-918b-966ee83a744c/applications/learn",
                "type": "SoftwareApplication"
            },
            "membership": {
                "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/530efc49-6b9f-40a6-918b-966ee83a744c/courses/e9c09e39c7844ae3b2ed677ac4fd90d7/members/9c60a9cdb3144d1aa77ff56c34ef248b",
                "type": "Membership",
                "extensions": {
                    "bb:course.id": "_124_1",
                    "bb:course.externalId": "og-101",
                    "bb:user.id": "_227_1",
                    "bb:user.externalId": "scott.hurrey@myschool.edu"
                },
                "member": {
                    "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/530efc49-6b9f-40a6-918b-966ee83a744c/users/9c60a9cdb3144d1aa77ff56c34ef248b",
                    "type": "Person",
                    "extensions": {
                        "bb:user.id": "_227_1",
                        "bb:user.externalId": "scott.hurrey@myschool.edu"
                    }
                },
                "organization": {
                    "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/530efc49-6b9f-40a6-918b-966ee83a744c/courses/e9c09e39c7844ae3b2ed677ac4fd90d7",
                    "type": "CourseOffering",
                    "extensions": {
                        "bb:course.id": "_124_1"
                    },
                    "members": [],
                    "courseNumber": "og-101"
                },
                "roles": [
                    "Learner"
                ],
                "status": "Active"
            },
            "federatedSession": {
                "startedAtTime": "2021-01-05T16:55:03.225Z",
                "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/530efc49-6b9f-40a6-918b-966ee83a744c/sessions/5118E091FCBDF29709BBD9D6F6758679",
                "type": "LtiSession",
                "name": "5118E091FCBDF29709BBD9D6F6758679",
                "dateCreated": "2021-01-05T16:55:03.225Z",
                "user": {
                    "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/530efc49-6b9f-40a6-918b-966ee83a744c/users/9c60a9cdb3144d1aa77ff56c34ef248b",
                    "type": "Person",
                    "extensions": {
                        "bb:user.id": "_227_1",
                        "bb:user.externalId": "scott.hurrey@myschool.edu"
                    }
                }
            },
            "extensions": {},
            "session": {
                "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/530efc49-6b9f-40a6-918b-966ee83a744c/sessions/5118E091FCBDF29709BBD9D6F6758679",
                "type": "Session"
            }
        }
    ]
}