xAPI in Learning Manager

Last updated on 29 November 2023

What is xAPI?

The Experience API (xAPI), is an e-learning software specification that allows learning content and learning systems to speak to each other in a manner that records and tracks all types of learning experiences. Learning experiences are recorded in a Learning Record Store (LRS). LRSs can exist within traditional learning management systems (LMSs) or on their own.

For more information on xAPI, see: https://github.com/adlnet/xAPI-Spec.

How does Learning Manager support xAPI?

Learning Manager has an inbuilt Learning Record Store. This LRS has the full capability of accepting xAPI statements from content that has been hosted within Learning Manager. It even accepts xAPI statements that third parties generate. These xAPI statements are stored within Learning Manager and they can then be exported outside Learning Manager to be visualized into any third-party data warehousing system.

When do you use xAPI?

Increasingly there is a need to capture learning experiences of the end user which span across multiple systems. There is also a need to track the exact engagement of the learner with training content. It goes beyond Start, In Progress and Completion (which are the only attributes captured by SCORM).

Using xAPI in Learning Manager

Set up your application

Log in as Integration Admin. Select Applications > Register.

App registration
Register a new application.

Create application
Define the scope for the application.
- If Admin role xAPI read and write access is enabled, the Admin is able to post and get xAPI statements and documents.
- If Learner role xAPI read and write access is enabled, the Admin is able to post and get xAPI statements and documents.
Save changes. You get your developer id and secret.

End points :

Click the link below to view the xAPI swagger document:

https://learningmanagereu.adobe.com/docs/primeapi/xapi/

Note: xAPI version supported in Learning Manager is 1.0.3.

API authentication

Learning Manager xAPI use OAuth 2.0 framework to authenticate and authorize your client applications. Once you register your application, you can get the clientId and clientSecret. Get URL is used in browser as it authenticates the Learning Manager users using their pre-configured accounts such as SSO, Adobe ID.

GET https://learningmanager.adobe.com/oauth/o/authorize?client_id=<Enter your clientId>&redirect_uri=<Enter a url to redirect to>&state=<Any String data>&scope=<admin:xapi or learner:xapi>&response_type=CODE.

Tracking xAPI statements as Learning Manager LO

As an Author you can now choose xAPI module while creating courses to monitor user experience outside Learning Manager. For example, you can use this feature to evaluate the activities of users on a third-party platform used for course consumption.

While creating an Activity Module, in the Type option, use the pop-up menu to select xAPI-based Module.

x-API based module creation
You are requested to provide an IRI. If not provided, Learning Manager generates one automatically.
Note:
IRI for an activity is unique across an account. That means, two modules in Learning Manager cannot have same IRI. A new IRI is generated in the following cases:

When a course with xAPI module is shared across accounts.

When a certification with xAPI module recurs
Any xAPI statement with the mentioned IRI is tracked in the above module and are reflected in the Learning Manager reports.
To copy the auto-generated IRI, revisit the Activity Module page.
Publish the Module.

Points to note:

Learning Manager currently supports only mbox as an identifier. Other identifiers including mboz_sha1, openid , account are not supported.
The stateId and profileId is a UUID when used with Learning Manager.
PUT request does not overwrite the document for xAPIs agents/profile, activity/profile, and activity/state
Unidentified group is not supported in Actor.
The parameter "related_activities" is not supported in GET statement.
The parameters 'format=ids' & 'format=canonical' is not supported in GET statements.
Voiding of xAPI statement does not undo any actions that happened in Learning Manager when the statement was posted.

Generate reports

xAPI reports can be generated as excel reports. As an Administrator, open Reports > Excel reports > xAPI activity report.

The downloaded report fetches all the information posted by the Learner and Administrator for any statement.

Same reports can be gernerated / scheduled using FTP and Box connectors for any third- party integration. Follow these steps:

Log in as Integration Admin > Open FTP/Box connector > Select xAPI Activity report from the left pane> Choose to schedule/ generate a report.

Note:

When only raw score is sent in xAPI statement without max score, Quiz score is not shown in LT.
To get the percentage score in Learning Manager, scaled scores are sent through xAPI.