xAPI-tracking

Overzicht

Creator kan leeractiviteit rapporteren als xAPI (Experience API/Tin Can)-statements aan elke standaardconforme Learning Record Store (LRS). Elke relevante interactie — een vraag beantwoorden, een game afronden, een quiz halen, een les of de hele cursus voltooien — wordt een statement zoals "Alex heeft Vraag 3 beantwoord (correct)".

xAPI-tracking is beschikbaar in drie leveringsmodi:

ModusPakketHoe de LRS wordt bereikt
SCORM + xAPILMS (SCORM)-export met de schakelaar xAPI-events registreren ingeschakeldLRS-eindpunt en inloggegevens ingebed op exportmoment; het pakket blijft SCORM zoals gebruikelijk rapporteren aan het LMS
Web + TinCan-launchWeb-export met xAPI ingeschakeldEindpunt, inloggegevens en actor komen als queryparameters in de launch-URL (TinCan/Rustici-stijl); ingebedde waarden zijn de terugval
xAPI-pakketHet speciale exportformaat xAPI (Tin Can)Levert een tincan.xml-manifest zodat platforms met LRS-ondersteuning (bijv. SCORM Cloud) het kunnen importeren en starten; launch-parameters hebben voorrang op ingebedde waarden

Wat wordt gerapporteerd

Statements worden gegenereerd op basis van sjablonen per brick, met verstandige standaardwaarden per categorie:

  • Evaluatie-bricks (enkele keuze, koppelen, invulvragen…) — answered met het resultaat (correct/incorrect). Standaard ingeschakeld.
  • Casual games (wordle, memory, galgje…) — attempted bij de eerste interactie, completed met de uitkomst. Standaard ingeschakeld.
  • Media (video, audio) en interactieve collecties (accordeon, tabbladen, carrousels…) — experienced/interacted. Standaard uitgeschakeld — schakel ze per brick in waar het signaal ertoe doet.
  • Structuur — altijd gerapporteerd zolang xAPI actief is: cursus initialized/completed/terminated, les completed, en quiz passed/failed met de score van de quizengine.

Aanpassing per brick

Open het bewerkingspaneel van een brick en zoek de sectie xAPI-tracking (beschikbaar op evaluatie-, game-, media- en collectiebricks):

  • Statements rapporteren — Standaard (categorie), Ingeschakeld of Uitgeschakeld voor deze brick.
  • Werkwoord — kies uit de standaard ADL-werkwoordenlijst, of kies Aangepast werkwoord… om je eigen werkwoord-IRI en weergavenaam op te geven (voor organisaties met hun eigen xAPI-profiel).
  • Activiteitsnaam — de leesbare naam die wordt getoond in LRS-rapporten (standaard het bricktype).

Statements bekijken

De Voorbeeld-functie van de editor voert de volledige xAPI-engine uit tegen een ingebouwde mock-LRS. Open het paneel xAPI-statements in de voorbeeldweergave en interageer met de content: elk statement dat het geëxporteerde pakket zou versturen, verschijnt live — geen LRS of netwerk nodig.

Activiteits-IRI's

Statements identificeren waarop is gehandeld met hiërarchische IRI's die op exportmoment in het pakket worden vastgelegd:

{app-url}/xapi/content/{contentId}                     ← cursus
{app-url}/xapi/content/{contentId}/lesson/{lessonId}   ← les
{app-url}/xapi/content/{contentId}/lesson/{id}/brick/{brickId}

Bricks verwijzen naar hun les en cursus via contextActivities, zodat LRS-dashboards activiteit per les en cursus kunnen groeperen. Deze IRI's zijn een stabiel contract: dezelfde content opnieuw exporteren behoudt dezelfde IRI's, en LRS-rapportage blijft continu tussen versies.

LRS-inloggegevens

Wanneer je een LRS-eindpunt en inloggegevens inbedt op exportmoment, worden deze in het pakket (content.json) geschreven en zijn ze leesbaar voor iedereen die de zip kan openen — dit is inherent aan client-side xAPI-pakketten en de standaardpraktijk van elke grote authoring-tool. Bescherm jezelf door:

  • Alleen-schrijven-LRS-inloggegevens te gebruiken (statements in, geen leesrechten).
  • De voorkeur te geven aan de TinCan-launchmodus, waarbij het hostingplatform per lerende kortlevende inloggegevens injecteert.

Identiteit van de lerende

De actor in elk statement wordt bepaald op basis van prioriteit:

  1. De actor uit de TinCan-launch-URL (aangeleverd door het hostingplatform).
  2. Het SCORM-leerling-ID uit de LMS-sessie (SCORM + xAPI-modus), gerapporteerd als een account-identifier.
  3. Een permanent anoniem ID dat uniek is per browser — gebruikt wanneer een webpakket direct wordt geopend.
xAPI-tracking