Udemy Businessの統合: xAPI

xAPI（Experience API）は、オンライン、オフラインを含む幅広い学習アクティビティから得られる学習体験のデータを収集、共有するためのeラーニングデータおよび仕様のインターフェース基準です。

メモ: xAPI統合はエンタープライズプランでのみご利用いただけます。

目次

• ステートメント

• 統合の設定
• 設定 - 特殊なケース
• xAPIの利点

ステートメント

LMS/LXP/LRSなどのサードパーティーシステムとxAPI統合することにより、Udemy Businessは学習者のコースまたはラーニングパスの進捗と完了状況に応じて、以下のアクティビティを送信します。Udemy Businessが送信するxAPIステートメントの詳細をご覧ください。

統合の設定

サポートされているLMS/LXPにxAPIステートメントを登録するためのUdemy Businessの設定は、まずLMS/LXPで設定した後、Udemy Businessの管理者ユーザーのインターフェイスから行います。以下の手順を示します*

*ステップ1とステップ2は、LMS/LXP側で行う必要がありますのでご注意ください。

ステップ1: Udemy BusinessをAPIアプリケーションとしてご利用のLMS/LXPに登録し、クライアント情報を生成します。

このステップは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がOAuthトークンを生成するために呼び出すものです。生成したトークンを使用して、Udemy BusinessがxAPIステートメントを、ステートメントエンドポイントにPOSTします。

例:

トークンエンドポイントURL: https://udemy.lms.com/v3/oauth2/access-token

xAPIステートメントエンドポイントURL: https://udemy.lms.com/v3/xapi/statements

メモ: URLが正しいことをご確認ください。LMS/LXPを確認し、インスタンスに適切なURLを入手してください。

ステップ3: Udemy BusinessでxAPI統合を設定する

1.管理 → 設定 → APIと統合の順に移動します。

統合を選択ドロップダウンで、統合を選択するか、その他をクリックします:

2. 学習者アクティビティ追跡（xAPI）を有効にします:

3. OAuthトークンURL、クライアントID、クライアントシークレット、xAPIステートメントURLを提供します。

4. xAPIの認証情報を入力したら、認証情報をテストをクリックします。正常に認証されたら、保存をクリックします。メモ: このテストでは、Udemy Businessがトークンエンドポイントにアクセス可能かどうかのみを検証します。

LMS/LXPとのxAPI統合の設定がこれで完了し、利用できるようになります。学習の進捗状況および完了状況が、自動的かつほぼリアルタイムでLMS/LXPに送信されるようになります。

設定 - 特殊なケース

上記の手順は、ご利用のLMS/LXPが以下の条件に該当する場合にのみ実行してください。 

• 進捗したイベントおよび完了したイベントの両方に対応している場合 
• アクター識別子としてmbox（Eメール）のみを受理する場合 

xAPIの設定が、選択したLMSに反して、Udemy Businessの管理者ページに表示される場合、カスタム変更（例: LMS/LXPが完了イベントのみに対応している、またはmbox - Eメール以外のアクター識別子を要求する）が、Udemy Businessの実装によりすでに処理されています。ただし、LMSがリスト上にあるものの、xAPI設定セクションがない場合、もしくはリスト上にないカスタムLMSを利用して、アクター識別子や動詞に関する特殊な要件がある場合は、Udemy Businessサポートにご連絡のうえ、その要件をお知らせください。

xAPIの利点

Udemy Businessではすでに、レポートを目的とするREST APIsに対応しています（ユーザーアクティビティ、ユーザーのコースアクティビティ、ユーザーの進捗状況の各API）。これらのAPIには、より細分化された取引データ（レクチャーレベル）と集約されたサマリーデータ（コースレベルまたはラーニングパスレベル）の両方が含まれています。異なるレベルで集約されているため、これらのAPIでは、新しいデータを使用できるようになるまでに8時間～14時間のタイムラグが生じます。 xAPIステートメントは、最小限のタイムラグで、ほぼリアルタイムで利用できます。ただし情報量は少なくなります。 

この表は、標準的なレポートREST APIとxAPIのイベントストリームの主な違いをまとめたものです。