이 문서에서는 Udemy Business에서 LMS/LXP/LRS 등 타사 시스템을 통한 xAPI 통합을 사용하여 학습자의 강의 진도 및 완료를 보고하기 위해 보내는 구문을 설명합니다.
- 통합을 구성하는 방법을 알아보려면 “Udemy Business 학습 관리 시스템: xAPI”를 참조하세요.
참고: 기업체 서비스를 이용할 때만 LMS/LXP 통합을 사용할 수 있습니다.
Authorization
지원되는 구문
Udemy Business에서는 학습자의 강의 진도 및 완료에 관한 다음 동사를 전송합니다.
- 진도 이벤트
- 완료 이벤트
이러한 구문은 이벤트 발생 시 거의 실시간으로 LMS/LXP 시스템에 게시됩니다.
행위자
기본적으로 xAPI 구문에서 행위자는 mbox(즉, 이메일) 속성을 사용하여 식별됩니다. 하지만 일부 LMS/LXP 시스템에서는 시스템에 액세스하기 위해 학습자가 이메일을 제출할 필요가 없습니다. 따라서 계정 개체를 사용하여 행위자를 식별하는 것 또한 지원됩니다. 하지만 식별자로 사용되는 계정 개체의 경우, 해당 LMS/LXP는 SSO 핸드셰이크의 일환으로 학습자의 lmsUserId를 Udemy Business에 전달해야 합니다. SSO의 일환으로 lmsUserId를 구성하는 작업에 관한 도움말 센터 문서를 참조하시기 바랍니다.
mbox 개체를 사용하여 식별되는 행위자의 예:
계정 개체를 사용하여 식별되는 행위자의 예:
계정 개체를 기본적으로 행위자 식별자로 전송하는 LMS/LXP는 다음과 같습니다.
- SumTotal LMS
위에 열거되지 않은 Udemy Business xAPI 통합 LMS/LXP에 대해서는 기본적으로 mbox 식별자를 전송합니다.
동사
진도
진도 구문은 한 강의 내에서 학습자의 진도를 전송하는 데 사용됩니다. 진도는 특정 강의 과목 내에서 완료한 강의와 총 강의 수의 비율을 기반으로 계산됩니다. 예를 들어, 한 강의 과목에 길이가 각각 30분, 40분, 50분, 60분짜리 강의가 포함되어 있고 학습자가 첫 강의를 완료한 경우라면 진도는 25%(1/4)로 기록됩니다. 각 강의의 길이는 진도 백분율 계산에 고려되지 않습니다.
진도 백분율은 완료 속성이 false로 설정된 결과 개체 내에서 전달되며, 백분율은 0과 1 사이의 변환 점수로 표시됩니다.
다음은 진도 구문의 예입니다.
완료
완료 구문은 학습자의 강의 완료를 전송하는 데 사용됩니다. 진도 구문과 유사하게, 완료 구문에는 완료 속성이 true로 설정된 결과 개체와 100% 완료를 나타내기 위해 1로 설정된 변환점수가 포함됩니다.
다음은 완료 구문의 예시입니다.
개체
구문의 개체는 강의의 유형 및 활동의 id로 강의 개체를 고유하게 식별하기 위한 강의 URL로 설정됩니다. 다음은 개체로 전달된 Udemy Business 강의의 예시입니다.
참고: xAPI 구문의 개체 활동 id를 강의 API 페이로드의 적절한 강의로 참조하기 위해 새 특성 xapi_activity_id가 강의 API에 추가되었습니다.
오류 처리 - Retry(재시도) 로직
이벤트를 LMS/LXP로 전송하는 데 실패하는 경우, Udemy Business는 실패한 구문의 재전송을 5일 동안 하루에 두 번씩 시도합니다.