この記事では、Udemy BusinessがサードパーティのLMS/LXPに送信するxAPIの進捗状況と完了ステートメントについて説明します。
メモ: LMS/LXPの統合はエンタープライズプランでのみご利用いただけます。
認証
対象となるステートメント
Udemy Businessは以下の動詞を送信します:
コースステートメント:
- 進捗イベント: 特定のコース内での学習者の進捗を追跡します。
- 修了イベント: 学習者によるコースの修了を記録します。
ラーニングパスステートメント:
- 進捗イベント: 指定されたラーニングパス内の一連の学習コンテンツにおける学習者の進捗を記録します。
- 修了イベント: 学習者がラーニングパス内のすべての学習コンテンツを修了したことを示します。
これらのxAPIステートメントは、イベントが発生するたびにほぼリアルタイムでLMS/LXPシステムに送信され、学習者のアクティビティと成果がタイムリーに更新されます。
ラーニングパスにはさまざまな種類のコンテンツが含まれることがあり、その中にはUdemyのコース、カスタムコース、Udemyコースの一部、記事へのリンク、外部動画、ポッドキャスト、ウィキページなどが含まれることがあります。 Udemy Business Proを含むアカウントの場合は、ラーニングパスに評価テストまたはラボを追加するオプションもあります。
アクター（actor）
既存の設定では、xAPIステートメントのアクターは、 mbox（Eメール）プロパティを使用して識別されます。ただし、LMS/LXPシステムによっては学習者がシステムにアクセスするのにEメールを必要としない場合があります。そのため、アカウントオブジェクトを使用して識別する方法にも対応しています。ただし、アカウントオブジェクトを識別子として使用するため、LMS/LXPから学習者のlmsUserIDをSSOハンドシェイクの一部としてUdemy Businessに渡す必要があります。SSOの一環としてlmsUserIDを設定する方法についてはヘルプセンターの記事をご覧ください。
mboxオブジェクトを使用したアクター識別子の例:
アカウントオブジェクトを使用したアクター識別子の例:
既存の設定で、Udemyからアクター識別子としてアカウントオブジェクトを送るLMS/LXPは以下の通りです。
- SumTotal LMS
上記にないUdemy BusinessとLMS/LXPのxAPI統合については、Udemyは既存の設定により mbox識別子を送信します。
動詞（verb）
コースステートメント
進捗率
進捗ステートメントは学習者のコースの進捗を送信するのに使用されます。進捗率は、コースの全レクチャーに対して完了したレクチャーの割合を基に計算されます。例えば、コースに30分、40分、50分、60分の4つのレクチャーがあり、学習者が最初のレクチャーを完了した場合、進捗率は25%（1/4）になります。各レクチャーの長さは進捗率の算出には考慮されません。
進捗率は、完了済み属性がfalseに設定された結果オブジェクト内で渡され、その数値は0から1のスコア範囲で表されます。
以下は進捗ステートメントの例です:
完了済み
完了ステートメントは、学習者のコース完了を送信するのに使用されます。進捗ステートメントと同様、完了ステートメントは、完了済み属性がtrueに設定された結果オブジェクトを含み、スコア範囲は1から100%完了まで設定されています。
以下は完了ステートメントの例です:
ラーニングパスステートメント
進捗率
進捗ステートメントは、ラーニングパス内での学習者の進捗を送信するために使用されます。進捗率は、ラーニングパス内の修了した学習コンテンツの数と、全体の学習コンテンツの数との比率に基づいて計算されます。例えば、ラーニングパスに5つのコース、2つのリンク、3つのコースの部分が含まれていて、学習者が3つのコースと2つのリンクを修了した場合、進捗率は50%（5/10）として記録されます。各コンテンツの長さは進捗率の算出には考慮されません。
進捗率は、結果オブジェクト内で渡され、修了属性はfalseに設定されます。また、パーセンテージは拡張オブジェクト内で0から100のスコア範囲で表されます。
以下は進捗ステートメントの例です:
完了済み
完了ステートメントは、学習者のラーニングパス完了を送信するのに使用されます。進捗ステートメントと同様、完了ステートメントは、完了済み属性がtrueに設定された結果オブジェクトを含み、スコア範囲は完了を示す100%に設定されています。
以下は完了ステートメントの例です:
オブジェクト
コースオブジェクト
ステートメントのオブジェクトは、コースの種類であり、アクティビティのIDは、コースオブジェクトを識別するためのコースURLとなります。以下はオブジェクトに与えられたUdemy Businessコースの例です。
ラーニングパスオブジェクト
ステートメントのオブジェクトは「Collection」型となり、アクティビティのIDはラーニングパスのURLに設定され、ラーニングパスオブジェクトを一意に識別します。以下はオブジェクトに与えられたUdemy Businessラーニングパスの例です。
SumTotal LMS/LXPの統合では、IDフィールドは組織のサブドメイン情報で始まり、以下の例のようにsumtotaldemoが表示されます。
ステートメントのオブジェクトは、コースの種類であり、アクティビティのIDは、コースオブジェクトを識別するためのコースURLとなります。以下はオブジェクトに与えられたUdemy Businessコースの例です。
メモ: xAPIステートメントからコースAPIのペイロード内の適切なコースまで、オブジェクトのアクティビティIDを参照するため、新しい属性xapi_activity_idがコースAPIに追加されました。
エラーの取り扱い - 再試行ロジック
LMS/LXPへのイベント送信に失敗した場合、Udemy Businessは1日2回、5日間にわたり失敗したステートメントを再試行します。