Set up xAPI reporting for the Udemy Business integration

Introduction

Learn365 supports xAPI reporting, which enables Udemy Business to communicate learners’ progress and completion to Learn365.

To set up xAPI reporting for Udemy Business, you must register Udemy Business as an application in Microsoft Azure, then configure the xAPI integration via the Udemy Business Portal. This article describes the xAPI reporting setup process.

To learn more about xAPI and its capabilities, see this article.

 

xAPI reporting features and requirements

To ensure course progress is properly reflected in Learn365, a Udemy Business course must be imported into Learn365 and a learner must be enrolled in the course. The information in the learner's Udemy Business profile must match the information recorded in the Microsoft Azure portal.

xAPI reporting enables progress and completion reporting of courses that are launched via the Learn365 player. If a learner consumes a course directly in Udemy Business without launching the course via Learn365, the progress and completion won’t be sent to Learn365.

Courses that aren't started or have been completed in Udemy Business will be displayed as Not started and Completed in Learn365, respectively.

 

 

If a course is imported more than once, learners’ course progress will be reported in each instance of the course, as long as the learner is enrolled in the course.

 

 

Create and configure a new application in the Microsoft Azure portal

Required role: Application Developer (Microsoft Entra ID) or higher.

To set up the Microsoft Azure portal for xAPI reporting, you must create an Azure enterprise application, grant the application permission to access the Learn365 API, and create the client secret credential.

For more information about the registering an application, see this Microsoft Learn article.

 

Create an Azure enterprise application

1. Go to your organization’s Microsoft Azure portal home page.

2. Select App registrations > New registration.

3. Enter a name for the application and keep the default settings.

4. Select Register.

 

 

Request Learn365 API permission for your application

1. From the application you created, navigate to Manage > API permissions > Add a permission.

2. Select the APIs my organization uses tab and select the LMS365 API application. The Request API permissions page opens.

3. Select Application permissions.

4. Select the FullAccess - Access LMS365 APIs checkbox then select Add permissions.

5. Select Yes on the Grant admin consent confirmation dialog. This will grant your application full API access to your Learn365 tenant.

 

 

Generate the client secret credential

1. Go to Certificates & secrets > New client secret.

2. Enter a Description and select when the client secret Expires, then select Add.

3. Save the client secret to your device for later use.

 

 

Finish the Azure portal configuration

In the Azure portal, go to Home > App Registrations > Overview and save the Application (client) ID and the Directory (tenant) ID credentials to your device for later use.

 

Set up the integration via the Udemy Business Portal

Required role: Udemy Business administrator.

To set up xAPI reporting in the Udemy Business Portal, follow these steps:

1. Go to the Udemy Business Portal for your organization, which is typically found at https://<Tenant ID>.udemy.com, and sign in as an administrator. Replace <Tenant ID> with your tenant ID.

2. Select Manage in the top right-hand side.

3. On the left-hand sidebar, select Settings > LMS/LXP integrations.

4. Select Start set-up.

5. Select Learn365 from the drop-down list, if it’s an available option. If it’s not, select Other.

6. Enter Learn365 in the LMS/LXP name field, and set the Auto enrollment and xAPI configuration toggles to On.

7. In the OAuth token URL field, paste the following URL: https://ne-api.365.systems/xAPI/<Tenant ID>/OAuthServerToken

 

 

8. In the Client ID and Client secret fields, paste the respective credentials that you generated in the Azure portal configuration stage.

9. Enter xapi:write in the OAuth scope field.

10. In the xAPI Statements URL field, paste the following URL: https://ne-api.365.systems/xAPI/<Tenant ID>/Udemy/ActivityStatement

 

 

11. Optionally, you can select Test Credentials to verify that Udemy Business can access the Oauth token URL.

12. Select Save. The Udemy Business Portal configuration is now complete.

The portal displays a configuration summary. You can now close the page.

For more information about Udemy Business xAPI integration, see this Udemy Business article.

 

Verify the xAPI reporting configuration

To confirm that your xAPI reporting configuration is successful, follow these steps:

1. In the Learn365 Admin Center, import a course from Udemy Business.

2. Enroll a learner in this course and publish it.

3. Log in to Learn365 as the learner you enrolled in the course, and start the course.

4. In the Learn365 Admin Center, go to Training Management > select the imported Udemy Business course > Course progress.