CLRecipe - Social Media Recipes for TinCan API (xAPI)

The Connected Learning Analytics Toolkit imports social media associated with a learning activity into an LRS and performs advanced analytics. The recipes to model social media interaction as xAPI statements are shared for community contribution and feedback. Recipes for Microblogging, Content Authoring, Content Collaboration and Content Curation will be provided.

Todo List:

• [X] Add content curation examples
• [X] Add content authoring examples
• [ ] Add collaborative authoring examples
• [ ] Add Contribute.md to outline how to contribute to project
• [X] Add examples as .json files
• [ ] Register and get recipe id for recipe

Modeling Social Media Interaction as an xAPI statement

The CLRecipe project:

• maps terminology from various social media platforms to a common set of objects and verb
• provides an xAPI Recipe for building xAPI statement for modeling social media interactions that include the relationship between social media posts (i.e. reply, share and like) so that advanced analytics (including content analysis and social network analysis) can be performed
• provides xAPI recipe examples for:
  • Microblogging Microblogging occurs on platforms such as Twitter and Facebook where users are only allowed to post a short note with an enforced character limit.
  • Content Authoring Content Authoring refers to any long text that is written by a single user. A blog post make on Wordpress is an example.
  • Content Collaboration Platforms such as MediaWiki and Google Docs support content collaboration. On these platforms multiple authors are able to add, edit and delete content.
  • Content Curation Content Curation involves creating a collection of artefacts (e.g., documents, audio, video, images, etc).

Though social media platforms use different terminology, a common model of interaction exists (see figure below). The model involves:

• A user can create a post. The post could be a short microblog post or a full article.
• A user can optionally including tag/s, hashtag/s or mention other users when creating the post.
• Other users can share a post (i.e. for their followers to view) and optionally including a comment.
• Other users can replying to the original post.
• Other users can rate the original post.

The Recipe for representing social media activity as xAPI statements prescribes that:

• A common set of verbs and objects must be used to represent activity across all social media platforms. Terminology used by specific platforms like Twitter and Facebook is mapped to a standard set of object and verbs (e.g. A 'Tweet' and Facebook Timeline post will both be mapped to the Note object; Twitter 'Favorite' and Facebook 'Like' will be represented by the 'Like' verb).
• A distinction between Short Microblogging posts (i.e. using the Note object) and larger text articles (i.e. using the Article object for pages and blog posts). This gives an indication of the size of the text included and is useful for content analysis (analytics).
• The social media platform must be specified using the context.Platform property. The inclusion of the platform (e.g. Twitter, Facebook, Blog, etc) will allow statement to be queried from the LRS based on the originating platform.
• Tags, hashtags and @mentions that are included in a post must all be included in a single xAPI statement that represents the original post. There were two options to achieve this namely using context.contextActivities.Other or context.contextActivities.Category. context.contextActivities.Other was selected because tags, hashtags and mentions represent folksonomies created by the user. context.contextActivities.Category is more suitable for use by custom taxonomies that are created at a system level for enhanced reporting (e.g. Cognitive Presence tagging, Sentiment Analysis, etc).
• Shares and likes must include a reference back to the object being shared or liked using contect.contextActivities.Parent. If the referenced id does not exist in the LRS it can be inserted using a substatement to represent the object. contect.contextActivities.Parent was chosen over using a statementref because because contect.contextActivities.Parent represents a direct parent-child relationship which required for social network analysis.
• Imported social media harvested from a group discussion area (i.e. Google+ Group or Facebook Group) must include context.Team.

Option additions to the recipe to facilitate reporting by course and instructor include:

• Imported social media should be associated with a course using context.contextActivities.Grouping.
• Imported social media should be associated with an instructor using context.Instructor.

Activities

Activities are items that are created on social media platforms. Blog posts, tweets, homepage posts and curated media are all example objects. The CLRecipe makes a distinction between short Microblogging posts (i.e. using the Note object) and larger text articles (i.e. using the Article object).

The table below show how social media activities from different social media platforms map to the Activities chosen for use by the CLRecipe.

Verbs

Verbs are actions that are performed on an object. Most of the verbs used in the CLRecipe are from the Activity Stream API

The table below show how actions from different social media platforms map to the Verbs chosen for use in the CLRecipe.

An example xAPI statement based upon CLRecipe is provided below. The example is for a Twitter tweet that includes hashtags and mentions:

{
    "actor": {
        "account": {
            "homePage": "http://www.twitter.com",
            "name": "aneesha"
        },
        "objectType": "Agent"
    },
    "context": {
        "contextActivities": {
            "grouping": [],
            "other": [
                {
                    "definition": {
                        "name": {
                            "en-US": "@sbuckshum"
                        },
                        "type": "http://id.tincanapi.com/activitytype/tag"
                    },
                    "id": "http://id.tincanapi.com/activity/tags/tincan",
                    "objectType": "Activity"
                },
                {
                    "definition": {
                        "name": {
                            "en-US": "#clatest"
                        },
                        "type": "http://id.tincanapi.com/activitytype/tag"
                    },
                    "id": "http://id.tincanapi.com/activity/tags/tincan",
                    "objectType": "Activity"
                }
            ],
            "parent": []
        },
        "platform": "Twitter",
        "registration": "b234b0fc-5f53-4b4b-810b-c52bc65dbf8d"
    },
    "object": {
        "definition": {
            "name": {
                "en-US": "making social learning (ephemeral social processes) analytics visible @sbuckshum #clatest"
            },
            "type": "http://activitystrea.ms/schema/1.0/note"
        },
        "id": "https://twitter.com/aneesha/status/597971744180174848",
        "objectType": "Activity"
    },
    "verb": {
        "display": {
            "en-US": "created"
        },
        "id": "http://activitystrea.ms/schema/1.0/create"
    }
}

Comprehensive CLRecipe Example xAPI Statements

Examples xAPI statement are provided for:

• Microblogging
• Content Creation
• Collaborative Content Authoring
• Content Curation
• Association with Course, Team and Instructor

Useful TinCan API Recipes

• SCORM to Tincan API Cookbook
• xAPI community of practice for user generated course content (UGCC)
• xAPI Community of Practice for Mozilla Open Badges
• Verbs and Activity Types used in Curatr

References

• xAPI Specification