xAPI (Experience API) ist ein Daten- und Spezifikationsschnittstellen-Standard für E-Learning-Plattformen zur Erfassung und Weitergabe von Nutzerlerndaten im Rahmen verschiedenster Online- und Offline-Lernaktivitäten.
Hinweis: Die xAPI-Integration ist nur im Enterprise-Abo verfügbar.
Inhalt
Anweisungen
Udemy Business sendet über die xAPI-Integration in ein externes System (LMS/LXP/LRS) Daten zu den Lernfortschritten und Abschlüssen von Kursen oder Lernpfaden der Nutzer:innen. Hier findest du weitere Infos zu den von Udemy Business gesendeten xAPI-Anweisungen.
Konfiguration der Integration
Die Weiterleitung von xAPI-Anweisungen an ein unterstütztes LMS/LXP-System wird in der Verwaltungsoberfläche in Udemy Business konfiguriert, nachdem das LMS/LXP-System entsprechend konfiguriert wurde. Dazu müssen die folgenden Schritte ausgeführt werden.*
* Beachte bitte, dass die Schritte 1 und 2 im LMS/LXP-System erfolgen.
Schritt 1: Udemy Business als API-Anwendung in deinem LMS/LXP-System registrieren und die zugehörigen Client-Anmeldedaten erzeugen
Dieser Schritt wird im LMS/LXP-System ausgeführt. Konfiguriere im Verwaltungsmodul deines LMS/LXP-Systems eine xAPI-Integration. Wähle die Option zur Registrierung einer Client-Anwendung und erzeuge eine Client-ID und ein Client-Passwort für die API-Anwendung.
Achte bei der Erzeugung der Client-Anmeldedaten darauf, dass die Zugriffsrechte auf xapi:write eingestellt sind. (Hinweis: Ohne diese Zugriffsrechte können die von Udemy Business an das LMS/LXP-System gesendeten xAPI-Anweisungen nicht ordnungsgemäß verarbeitet werden.)
Sprich diesen Schritt ggf. mit dem LMS/LXP-Administrator ab.
Schritt 2: OAuth-Token-Endpunkt und xAPI-Anweisungsendpunkt im LMS/LXP-System generieren
Dieser Schritt wird im LMS/LXP-System ausgeführt. Die LMS/LXP-Instanz sollte eine URL für den OAuth-Token-Endpunkt und den xAPI-Anweisungsendpunkt ausgeben.
Den OAuth-Token-Endpunkt ruft Udemy Business zur Erzeugung der Authentifizierungs-Token unter Angabe der in Schritt 1 erzeugten Client-ID und des Client-Passworts auf. Mithilfe dieses Tokens sendet Udemy Business die xAPI-Anweisungen dann an den Anweisungsendpunkt.
Beispiel:
URL des Token-Endpunkts: https://udemy.lms.com/v3/oauth2/access-token
URL des xAPI-Anweisungsendpunkts: https://udemy.lms.com/v3/xapi/statements
Hinweis: Achte darauf, dass die Endpunkt-URLs korrekt sind. Rufe die korrekten URLs für deine Instanz im LMS/LXP-System ab.
Schritt 3: xAPI-Integration in Udemy Business konfigurieren
1. Gehe zu Verwalten → Einstellungen → APIs und Integrationen.
Wähle im Dropdown-Menü Integration auswählen deine Integration aus oder klicke auf Weitere:
2. Aktiviere die Nachverfolgung der Lernaktivitäten (xAPI):
3. Gib die OAuth-Token-URL, die Client-ID, das Client-Passwort und die xAPI-Anweisungs-URL ein.
4. Nachdem du die xAPI-Anmeldedaten eingegeben hast, klicke auf Anmeldedaten testen. Klicke nach erfolgreicher Validierung auf Speichern. Hinweis: Mit diesem Test wird nur gecheckt, ob Udemy Business den Token-Endpunkt aufrufen kann.
Die xAPI-Integration mit deinem LMS/LXP-System ist nun eingerichtet und einsatzbereit. Lernfortschritte und abgeschlossene Inhalte werden jetzt fast in Echtzeit an das LMS/LXP-System weitergeleitet.
Konfiguration – Sonderfälle
Die oben beschriebenen Schritte sollten nur angewendet werden, wenn dein LMS/LXP-System:
- sowohl Fortschritts- als auch Abschlussereignisse unterstützt und
- mbox (E-Mail-Adresse) als Actor-Bezeichner akzeptiert.
Wenn die xAPI-Konfiguration auf der Udemy Business-Verwaltungsseite für das gewählte LMS-System angezeigt wird, wurden alle benutzerdefinierten Änderungen (Beispiel: das LMS/LXP-System unterstützt nur Abschlussereignisse oder erfordert einen anderen Actor-Bezeichner als mbox (E-Mail-Adresse)) bereits durch die Udemy Business-Implementierung durchgeführt. Wenn das LMS jedoch ohne xAPI-Konfigurationsabschnitt oder gar nicht in der Liste angezeigt wird und spezielle Anforderungen an den Actor-Bezeichner und/oder die Verben hat, dann kontaktiere bitte den Udemy Business-Support und gib diese besonderen Anforderungen an.
Vorteile von xAPI
Udemy Business unterstützt bereits REST-APIs für die Berichterstellung (APIs für Nutzeraktivität, Kursnutzung und Nutzerfortschritt). Diese APIs umfassen sowohl detaillierte Transaktionsdaten (auf Lektionsebene) als auch aggregierte Zusammenfassungsdaten (auf Kurs- oder Lernpfadebene). Aufgrund dieser verschiedenen Aggregationsebenen stellen diese APIs neue Daten mit einer Verzögerung von etwa 8 bis 14 Stunden bereit. xAPI-Anweisungen werden dagegen mit minimaler Verzögerung nahezu in Echtzeit gesendet, bieten jedoch weniger Informationen.
In der folgenden Tabelle werden die wichtigsten Unterschiede zwischen der Standardberichterstellungs-REST-API- und dem xAPI-Ereignis-Stream zusammengefasst:
|
Kriterien |
xAPI |
Berichterstellungs-REST-APIs |
|
Latenz |
Abschlussereignisse werden fast in Echtzeit übermittelt. Die Latenz ist gering. |
Abschlussereignisse werden mit einer Verzögerung von ca. 8 Stunden bereitgestellt. |
|
Standard |
Folgt einem Branchenstandard für die Erfassung und Berichterstellung der Lernerlebnisse von Nutzern in einer Lernumgebung. |
Folgt keinem Standarddatenmodell, daher muss die Datenübertragung an andere Systeme möglicherweise individuell angepasst werden. |
|
Interoperabilität |
Das Standarddatenmodell ermöglicht die unkomplizierte Interaktion verschiedener Systeme. So kann eine umfassende Übersicht über das Lernerlebnis der Nutzer aus verschiedenen Perspektiven erstellt werden. |
Für die Interaktion zwischen mehreren Systemen ist die Übersetzung und Zuordnung der Daten zwischen den beteiligten Systemen erforderlich. |
|
Ressourcenbelastung |
Udemy Business puscht die Ereignisse an die Drittanbietersysteme, diese Systeme müssen also keine Daten von Udemy Business abrufen. Daher ist die Ressourcenbelastung gering und es kommt seltener zu Skalierbarkeitsproblemen. |
Drittanbietersysteme müssen die Daten von Udemy abrufen. Wenn die Anzahl der Abfragen und die Nutzlast steigt, kann es zu Zeitüberschreitungen kommen. |
|
Zukunftssicherheit |
Branchenstandard, der schnell weiterentwickelt wird. So können wir (zukünftig) eine breite Palette von Lernereignissen übertragen, z. B. detaillierte Fortschrittsverfolgung innerhalb von Lerninhalten, Interaktionen, Suchen, Bewertungen usw. |
Zurzeit auf Abschluss- und Fortschrittsereignisse auf Lektions- und Kursebene beschränkt, aber eine Ausweitung ist möglich. Der Aufwand ist hier jedoch vergleichsweise höher, da keine Standards existieren. |