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