xAPI(Experience API)는 온라인 및 오프라인을 포함하여 광범위한 학습 활동 상황 내에서 학습자의 경험에 대한 데이터를 수집 및 공유하기 위한 전자 학습 데이터 및 사양 인터페이스 표준입니다.
참고: xAPI 통합은 기업체 서비스에서만 사용할 수 있습니다.
목차
구문
Udemy Business에서는 LMS/LXP/LRS 등 타사 시스템을 통한 xAPI 통합을 사용하여 학습자의 강의 진도 및 완료에 관한 활동을 전송합니다. Udemy Business에서 전송하는 xAPI 구문에 대해 자세히 알아보세요.
통합 구성
우선 지원되는 LMS/LXP에서 관련 구성을 완료한 후, Udemy Business의 관리 사용자 인터페이스에서 LMS/LXP에 xAPI 구문을 게시하도록 Udemy Business를 구성할 수 있습니다. 다음은 따라야 할 단계입니다.*
*1단계와 2단계는 LMS/LXP 측에서 수행해야 합니다.
1단계: Udemy Business를 LMS/LXP에서 API 애플리케이션으로 등록 및 클라이언트 자격 증명 생성
이 단계는 LMS/LXP 내에서 수행됩니다. xAPI 통합을 구성하려면 LMS/LXP의 관리 모듈을 확인하세요. API 애플리케이션에 클라이언트 애플리케이션을 등록하고 클라이언트 ID와 클라이언트 암호를 생성하기 위한 옵션이 있어야 합니다.
클라이언트 자격 증명을 생성할 때 액세스 범위가 xapi:write로 설정되도록 합니다.(참고: 이 범위 없이는 Udemy Business에서 LMS/LXP로 전송한 xAPI 구문이 실패합니다.)
이 단계를 수행하려면 LMS/LXP 관리자에게 문의하세요.
2단계: LMS/LXP에서 OAuth 토큰 엔드포인트와 xAPI 구문 엔드포인트 조달
이 단계는 LMS/LXP 내에서 수행됩니다. LMS/LXP 인스턴스에는 OAuth 토큰 엔드포인트와 xAPI 구문 엔드포인트에 대한 URL이 있어야 합니다.
OAuth 토큰 엔드포인트는 1단계에서 생성된 클라이언트 ID와 암호를 제공하여 인증 토큰을 생성하기 위해 Udemy Business에서 호출하는 엔드포인트입니다. 그런 다음 Udemy Business는 생성된 토큰을 사용하여 xAPI 구문을 구문 엔드포인트에 게시합니다.
예시:
토큰 엔드포인트 URL: https://udemy.lms.com/v3/oauth2/access-token
xAPI 구문 엔드포인트 URL: https://udemy.lms.com/v3/xapi/statements
참고: 엔드포인트 URL이 정확한지 확인하십시오. 인스턴스의 정확한 엔드포인트 URL을 가져오려면 LMS/LXP에서 확인하십시오.
3단계: Udemy Business에서 xAPI 통합 구성
- 관리 → 설정 → LMS/LXP 통합으로 이동합니다.
-
포함되지 않은 LMS/LXP 파트너의 경우, “기타”를 선택하고, 이름과 함께 LMS/LXP 통합을 제공하고 “저장”을 선택합니다.
참고: 아래 설정 페이지는 Udemy Business REST API(강의 및 보고 API)에 액세스하고 xAPI를 설정하기 위한 API 키를 활성화하는 데 공통으로 사용됩니다. LMS/LXP가 드롭다운에 있더라도 xAPI 통합 구성은 아직 지원되지 않을 수 있습니다.
- LMS를 선택하고 저장을 선택하고 나면 아래 화면으로 진행합니다. 첫 번째 섹션은 표준 REST API(강의 및 보고 API)에 액세스하기 위한 API 키를 제공합니다.
- 오른쪽 상단에서 통합 편집을 xAPI 구성을 켜짐으로 토글합니다. 아래 강조 표시된 섹션은 xAPI 구성에 해당합니다. OAuth 토큰 URL, 클라이언트 id, 클라이언트 암호 및 xAPI 구문 URL을 제공합니다.
- 세부 정보를 제공한 후 테스트 자격 증명을 클릭하여 Udemy Business 인스턴스가 토큰 URL에 도달할 수 있는지 확인합니다. 저장을 클릭하여 구성을 저장합니다. 참고: 이 테스트는 Udemy Business가 토큰 엔드포인트에 액세스할 수 있는지만 확인합니다.
- 이제 LMS/LXP와 xAPI 통합이 설정되어 사용할 준비가 되었습니다.
- 수강생 진도와 완료가 이제 거의 실시간으로 LMS/LXP에 전달될 것입니다.
구성 - 특별 사례
위에 설명된 단계는 LMS/LXP가
- 진도 및 완료 이벤트를 모두 지원하고
- mbox(이메일)를 행위자의 식별자로 허용하는 경우에만 따라야 합니다.
xAPI 구성이 선택한 LMS에 대해 Udemy Business 관리 페이지에 표시되는 경우, 모든 사용자 지정 변경 사항(예: 완료 이벤트만 지원하거나 mbox-이메일과 다른 행위자 식별자를 요구하는 LMS/LXP)은 Udemy Business 구현에서 이미 처리되었을 것입니다. 그러나 LMS가 목록에 표시되지만 xAPI 구성 섹션이 없는 경우 또는 목록에 없는 사용자 지정 LMS가 있고 행위자 식별자 및/또는 동사 관련 특별 요구 사항이 있는 경우에는 Udemy Business 지원 팀에 문의하여 해당 요구 사항을 제출해야 합니다.
xAPI의 이점
Udemy Business는 이미 보고 목적을 위해 REST API를 지원합니다(사용자 활동, 사용자 강의 활동, 사용자 진도 API). 이러한 API에는 세분화된 거래 데이터(강의 과목 수준) 및 집계된 요약 데이터(각 강의 수준)이 모두 포함됩니다. 이처럼 집계 수준이 다르기 때문에, 해당 API에서 새 데이터를 사용 가능하게 만들기까지 8~14시간의 지연 시간이 발생합니다. 반면 xAPI 구문은 지연을 최소화해 실시간에 가깝지만 더 적은 정보를 제공합니다.
아래 표는 표준 보고 REST API와 xAPI 이벤트 스트림의 주요 차이점을 요약합니다.
기준 |
xAPI |
보고 REST API |
지연 시간 |
완료 이벤트의 근실시간 게시를 지원합니다. 지연 시간이 짧습니다. |
완료 이벤트를 사용 가능하게 만들기까지 최대 8시간의 지연이 발생합니다. |
표준 |
학습 환경에서 학습자의 경험을 포착하고 보고하는 작업에 대한 업계 표준을 따릅니다. |
표준 데이터 모델을 따르지 않으므로 다른 시스템으로 데이터를 포팅하기 위해 사용자 지정이 필요할 수 있습니다. |
상호 운용성 |
표준 데이터 모델은 시스템이 서로 쉽게 상호 작용하고 학습자의 경험을 여러 곳에서 완전히 파악할 수 있도록 구축하는 작업을 지원합니다. |
여러 시스템 간 상호 작용에는 참여 시스템 간 데이터 번역 및 매핑이 필요합니다. |
리소스 소비 |
Udemy Business는 이벤트를 타사 시스템으로 내보내므로, 이러한 시스템이 Udemy Business에서 가져올 필요가 없습니다. 이로 인해 리소스 소비와 확장 가능성 문제가 줄어듭니다. |
Udemy에서 데이터를 가져오려면 타사 시스템이 필요합니다. 요청과 페이로드가 증가할 때 시간 초과 문제가 발생할 수 있습니다. |
미래 대비 |
업계 표준을 신속히 개발합니다. 다양한 (미래의) 학습자 환경 이벤트(예: 콘텐츠 내에서 세분화된 진도 추적, 상호 작용, 검색, 리뷰 등)를 확장할 수 있습니다. |
현재 강의 과목 및 각 강의 수준에서 완료, 진도 이벤트로 제한되어 있으나 확장 또한 가능합니다. 하지만 현재 표준이 마련되지 않아 상대적으로 더 많은 작업이 필요할 수 있습니다. |