本文概括介绍 Udemy Business 通过与 LMS/LXP/LRS 等第三方系统集成的 xAPI 发送的语句来报告学员的进度和课程完成情况。
注意:LMS/LXP 集成仅适用于 Enterprise 方案。
授权
支持的语句
Udemy Business 将发送与学员的进度和课程完成情况相对应的以下动词:
- 进度事件
- 完成事件
这些语句将在事件发生时近乎实时地发布到 LMS/LXP 系统。
参与者
默认情况下,xAPI 语句中的参与者将使用 mbox(即电子邮件)属性来标识。但是,一些 LMS/LXP 系统不需要电子邮件即可让学员访问其系统。因此,还支持使用帐户对象来识别参与者。但是,对于用作标识符的帐户对象,LMS/LXP 应在 SSO 握手过程中将学员的 lmsUserId 传递给 Udemy Business。请参阅此帮助中心文章,了解如何将 lmsUserId 配置为 SSO 的一部分。
使用 mbox 对象标识的参与者示例:

使用帐户对象标识的参与者示例:

默认情况下我们将为其发送帐户对象作为参与者标识符的 LMS/LXP 如下:
对于上面未列出的 Udemy Business xAPI 集成的 LMS/LXP,我们将默认发送 mbox 标识符。
动词
有进展
进度语句将用于发送学员在课程中的进度。进度是根据完成的讲座与课程内讲座总数的比率计算的。例如,如果一门课程包含 4 个讲座,分别为 30 分钟、40 分钟、50 分钟和 60 分钟,并且学员完成了第一个讲座,那么进度将被记录为 25% (1/4)。每个讲座的持续时间将不计入进度百分比的计算。
进度百分比将在 completion 属性设置为 false 的结果对象中传递,百分比通过 0 到 1 之间的量表分数表示。
下面是一个示例进度语句:

已完成
完成语句将用于发送学员的课程完成情况。与进度语句类似,完成语句将包含一个结果对象,该对象将 completion 属性设置为 true,并将量表分数设置为 1,以指示 100% 完成。
下面是一个示例完成语句:

对象
语句的对象将是课程类型,并且活动的 ID 将设置为课程 URL 以唯一标识课程对象。以下是作为对象传递的 Udemy Business 课程示例:

注意:为将对象的活动 ID 从 xAPI 语句引用到课程 API 有效负载中的适当课程,向课程 API 添加了一个新属性 xapi_activity_id。
错误处理 - 重试逻辑
当向 LMS/LXP 发送事件失败时,Udemy Business 将在 5 天内每天重试任何失败的语句两次。