• Udemy Business 학습 관리 시스템 통합: xAPI 구문

    이 문서에서는 Udemy Business에서 LMS/LXP/LRS 등 타사 시스템을 통한 xAPI 통합을 사용하여 학습자의 강의 진도 및 완료를 보고하기 위해 보내는 구문을 설명합니다.

    참고: 기업체 서비스를 이용할 때만 LMS/LXP 통합을 사용할 수 있습니다.

    Authorization

    지원되는 구문

    Udemy Business에서는 학습자의 강의 진도 및 완료에 관한 다음 동사를 전송합니다.

    1. 진도 이벤트
    2. 완료 이벤트

    이러한 구문은 이벤트 발생 시 거의 실시간으로 LMS/LXP 시스템에 게시됩니다.

    행위자

    기본적으로 xAPI 구문에서 행위자는 mbox(즉, 이메일) 속성을 사용하여 식별됩니다. 하지만 일부 LMS/LXP 시스템에서는 시스템에 액세스하기 위해 학습자가 이메일을 제출할 필요가 없습니다. 따라서 계정 개체를 사용하여 행위자를 식별하는 것 또한 지원됩니다. 하지만 식별자로 사용되는 계정 개체의 경우, 해당 LMS/LXP는 SSO 핸드셰이크의 일환으로 학습자의 lmsUserIdUdemy Business에 전달해야 합니다. SSO의 일환으로 lmsUserId를 구성하는 작업에 관한 도움말 센터 문서를 참조하시기 바랍니다.

    mbox 개체를 사용하여 식별되는 행위자의 예:

    mbox_object.png

    계정 개체를 사용하여 식별되는 행위자의 예:

    account_object.png

    계정 개체를 기본적으로 행위자 식별자로 전송하는 LMS/LXP는 다음과 같습니다.

    • SumTotal LMS

    위에 열거되지 않은 Udemy Business xAPI 통합 LMS/LXP에 대해서는 기본적으로 mbox 식별자를 전송합니다.

    동사

    진도

    진도 구문은 한 강의 내에서 학습자의 진도를 전송하는 데 사용됩니다. 진도는 특정 강의 과목 내에서 완료한 강의와 총 강의 수의 비율을 기반으로 계산됩니다. 예를 들어, 한 강의 과목에 길이가 각각 30분, 40분, 50분, 60분짜리 강의가 포함되어 있고 학습자가 첫 강의를 완료한 경우라면 진도는 25%(1/4)로 기록됩니다. 각 강의의 길이는 진도 백분율 계산에 고려되지 않습니다.

    진도 백분율은 완료 속성이 false로 설정된 결과 개체 내에서 전달되며, 백분율은 0과 1 사이의 변환 점수로 표시됩니다.
    다음은 진도 구문의 예입니다.

    progressed_statement.png

    완료

    완료 구문은 학습자의 강의 완료를 전송하는 데 사용됩니다. 진도 구문과 유사하게, 완료 구문에는 완료 속성이 true로 설정된 결과 개체와 100% 완료를 나타내기 위해 1로 설정된 변환점수가 포함됩니다.

    다음은 완료 구문의 예시입니다.

    completion_statement.png

    개체

    구문의 개체는 강의의 유형 및 활동의 id로 강의 개체를 고유하게 식별하기 위한 강의 URL로 설정됩니다. 다음은 개체로 전달된 Udemy Business 강의의 예시입니다.

    ub_course_passed_as_an_object.png

    참고: xAPI 구문의 개체 활동 id를 강의 API 페이로드의 적절한 강의로 참조하기 위해 새 특성 xapi_activity_id가 강의 API에 추가되었습니다.

    오류 처리 - Retry(재시도) 로직

    이벤트를 LMS/LXP로 전송하는 데 실패하는 경우, Udemy Business는 실패한 구문의 재전송을 5일 동안 하루에 두 번씩 시도합니다.

    문서 읽기