Suivi xAPI

Aperçu

Creator peut signaler l'activité des apprenants sous forme de déclarations xAPI (Experience API / Tin Can) vers n'importe quel Learning Record Store (LRS) conforme aux standards. Chaque interaction pertinente — répondre à une question, terminer un jeu, réussir un quiz, achever une leçon ou le cours entier — devient une déclaration du type « Alex a répondu à la Question 3 (correct) ».

Le suivi xAPI est disponible selon trois modes de diffusion :

ModePackageComment le LRS est atteint
SCORM + xAPIExport LMS (SCORM) avec l'option Enregistrer les événements xAPI activéePoint de terminaison et identifiants du LRS intégrés au moment de l'export ; le package continue de signaler en SCORM au LMS comme d'habitude
Web + lancement TinCanExport web avec xAPI activéLe point de terminaison, les identifiants et l'acteur arrivent en paramètres de requête dans l'URL de lancement (style TinCan/Rustici) ; les valeurs intégrées servent de repli
Package xAPILe format d'export dédié xAPI (Tin Can)Fournit un manifeste tincan.xml afin que les plateformes adossées à un LRS (par exemple SCORM Cloud) puissent l'importer et le lancer ; les paramètres de lancement priment sur les valeurs intégrées

Ce qui est signalé

Les déclarations sont générées à partir de modèles par Brick, avec des valeurs par défaut sensées selon la catégorie :

  • Bricks d'évaluation (choix unique, association, texte à trous…) — answered avec le résultat (correct/incorrect). Activé par défaut.
  • Jeux informels (wordle, memory, pendu…) — attempted à la première interaction, completed avec le résultat. Activé par défaut.
  • Médias (vidéo, audio) et collections interactives (accordéon, onglets, carrousels…) — experienced / interacted. Désactivé par défaut — à activer par Brick là où le signal a de l'importance.
  • Structure — toujours signalée tant que xAPI est actif : initialized / completed / terminated du cours, completed de la leçon, et passed / failed du quiz avec le score du moteur de quiz.

Personnalisation par Brick

Ouvrez le panneau d'édition d'un Brick et trouvez la section Suivi xAPI (disponible sur les Bricks d'évaluation, de jeu, de média et de collection) :

  • Signaler les déclarations — Par défaut (catégorie), Activé ou Désactivé pour ce Brick.
  • Verbe — choisissez dans la liste des verbes ADL standard, ou sélectionnez Verbe personnalisé… pour fournir votre propre IRI de verbe et son nom d'affichage (pour les organisations ayant leur propre profil xAPI).
  • Nom de l'activité — le nom lisible affiché dans les rapports du LRS (par défaut, le type de Brick).

Prévisualiser les déclarations

Le mode Aperçu de l'éditeur exécute le moteur xAPI complet contre un LRS simulé intégré. Ouvrez le panneau Déclarations xAPI dans l'aperçu et interagissez avec le contenu : chaque déclaration que le package exporté enverrait apparaît en direct — aucun LRS ni réseau requis.

IRI d'activité

Les déclarations identifient l'objet de l'action avec des IRI hiérarchiques figés dans le package au moment de l'export :

{app-url}/xapi/content/{contentId}                     ← cours
{app-url}/xapi/content/{contentId}/lesson/{lessonId}   ← leçon
{app-url}/xapi/content/{contentId}/lesson/{id}/brick/{brickId}

Les Bricks référencent leur leçon et leur cours via contextActivities, afin que les tableaux de bord du LRS puissent regrouper l'activité par leçon et par cours. Ces IRI constituent un contrat stable : réexporter le même contenu conserve les mêmes IRI, et le reporting du LRS reste continu d'une version à l'autre.

Identifiants du LRS

Lorsque vous intégrez un point de terminaison et des identifiants LRS au moment de l'export, ils sont écrits dans le package (content.json) et sont lisibles par quiconque peut ouvrir le zip — c'est inhérent aux packages xAPI côté client, et une pratique standard de tous les grands outils de création. Protégez-vous en :

  • Utilisant des identifiants LRS en écriture seule (déclarations en entrée, aucune lecture).
  • Privilégiant le mode de lancement TinCan, où la plateforme d'hébergement injecte des identifiants à courte durée de vie par apprenant.

Identité de l'apprenant

L'acteur de chaque déclaration est résolu selon un ordre de priorité :

  1. L'acteur provenant de l'URL de lancement TinCan (fourni par la plateforme d'hébergement).
  2. L'identifiant apprenant SCORM issu de la session LMS (mode SCORM + xAPI), signalé comme identifiant account.
  3. Un identifiant anonyme persisté, unique par navigateur — utilisé lorsqu'un package web est ouvert directement.
Suivi xAPI