xAPI-Tracking

Übersicht

Creator kann Lernaktivitäten als xAPI-Statements (Experience API / Tin Can) an jeden standardkonformen Learning Record Store (LRS) melden. Jede relevante Interaktion — eine Frage beantworten, ein Spiel abschließen, ein Quiz bestehen, eine Lektion oder den gesamten Kurs abschließen — wird zu einem Statement wie „Alex hat Frage 3 beantwortet (richtig)“.

xAPI-Tracking steht in drei Übermittlungsmodi zur Verfügung:

ModusPaketWie die LRS erreicht wird
SCORM + xAPILMS-(SCORM)-Export mit aktiviertem Schalter xAPI-Events registrierenLRS-Endpunkt und Zugangsdaten werden zum Exportzeitpunkt eingebettet; das Paket meldet weiterhin wie gewohnt SCORM an das LMS
Web + TinCan-LaunchWeb-Export mit aktiviertem xAPIEndpunkt, Zugangsdaten und Actor kommen als Query-Parameter in der Launch-URL an (TinCan-/Rustici-Stil); eingebettete Werte dienen als Fallback
xAPI-PaketDas dedizierte Exportformat xAPI (Tin Can)Liefert ein tincan.xml-Manifest, sodass LRS-gestützte Plattformen (z. B. SCORM Cloud) es importieren und starten können; Launch-Parameter haben Vorrang vor eingebetteten Werten

Was gemeldet wird

Statements werden aus Vorlagen pro Brick generiert, mit sinnvollen Standardwerten nach Kategorie:

  • Bewertungs-Bricks (Single Choice, Zuordnung, Lückentext …) — answered mit dem Ergebnis (richtig/falsch). Standardmäßig aktiviert.
  • Casual Games (Wordle, Memory, Galgenmännchen …) — attempted bei der ersten Interaktion, completed mit dem Ergebnis. Standardmäßig aktiviert.
  • Medien (Video, Audio) und interaktive Sammlungen (Akkordeon, Tabs, Karussells …) — experienced / interacted. Standardmäßig deaktiviert — pro Brick aktivieren, wo das Signal relevant ist.
  • Struktur — wird immer gemeldet, solange xAPI aktiv ist: Kurs initialized / completed / terminated, Lektion completed und Quiz passed / failed mit der Punktzahl aus der Quiz-Engine.

Anpassung pro Brick

Öffne das Bearbeitungspanel eines Bricks und finde den Bereich xAPI-Tracking (verfügbar bei Bewertungs-, Spiel-, Medien- und Sammlungs-Bricks):

  • Statements melden — Standard (Kategorie), Aktiviert oder Deaktiviert für diesen Brick.
  • Verb — wähle aus der Standard-ADL-Verbliste oder wähle Benutzerdefiniertes Verb …, um eine eigene Verb-IRI und einen eigenen Anzeigenamen anzugeben (für Organisationen mit eigenem xAPI-Profil).
  • Aktivitätsname — der menschenlesbare Name in LRS-Reports (standardmäßig der Brick-Typ).

Statements in der Vorschau ansehen

Die Vorschau des Editors führt die vollständige xAPI-Engine gegen eine integrierte Mock-LRS aus. Öffne das Panel xAPI-Statements in der Vorschau und interagiere mit dem Content: Jedes Statement, das das exportierte Paket senden würde, erscheint live — ohne LRS oder Netzwerkverbindung erforderlich.

Aktivitäts-IRIs

Statements identifizieren, worauf sich die Aktion bezieht, mit hierarchischen IRIs, die zum Exportzeitpunkt im Paket eingefroren werden:

{app-url}/xapi/content/{contentId}                     ← Kurs
{app-url}/xapi/content/{contentId}/lesson/{lessonId}   ← Lektion
{app-url}/xapi/content/{contentId}/lesson/{id}/brick/{brickId}

Bricks verweisen über contextActivities auf ihre Lektion und ihren Kurs, sodass LRS-Dashboards Aktivitäten pro Lektion und Kurs gruppieren können. Diese IRIs sind ein stabiler Vertrag: Ein erneuter Export desselben Contents behält dieselben IRIs bei, und das LRS-Reporting bleibt versionsübergreifend durchgängig.

LRS-Zugangsdaten

Wenn du einen LRS-Endpunkt und Zugangsdaten zum Exportzeitpunkt einbettest, werden sie in das Paket geschrieben (content.json) und sind für jeden lesbar, der das Zip öffnen kann — das liegt in der Natur clientseitiger xAPI-Pakete und ist gängige Praxis bei jedem größeren Autorentool. Schütze dich, indem du:

  • Schreibgeschützte LRS-Zugangsdaten verwendest (nur Statements eingehend, keine Lesezugriffe).
  • Den TinCan-Launch-Modus bevorzugst, bei dem die Hosting-Plattform kurzlebige Zugangsdaten pro Lernendem einschleust.

Identität der Lernenden

Der Actor in jedem Statement wird in Prioritätsreihenfolge ermittelt:

  1. Der Actor aus der TinCan-Launch-URL (bereitgestellt von der Hosting-Plattform).
  2. Die SCORM-Lernenden-ID aus der LMS-Sitzung (SCORM-+-xAPI-Modus), gemeldet als account-Identifikator.
  3. Eine persistente anonyme ID, eindeutig pro Browser — verwendet, wenn ein Web-Paket direkt geöffnet wird.
xAPI-Tracking