Seguimiento xAPI

Visión general

Creator puede informar de la actividad de quien aprende como declaraciones xAPI (Experience API / Tin Can) a cualquier almacén de registros de aprendizaje (LRS) compatible con el estándar. Cada interacción relevante — responder a una pregunta, terminar un juego, aprobar un cuestionario, completar una lección o el curso entero — se convierte en una declaración como «Alex respondió a la pregunta 3 (correcto)».

El seguimiento xAPI está disponible en tres modos de entrega:

ModoPaqueteCómo se llega al LRS
SCORM + xAPIExportación LMS (SCORM) con el interruptor Registrar eventos xAPI activadoEl endpoint y las credenciales del LRS se incrustan en el momento de exportar; el paquete sigue informando por SCORM al LMS como de costumbre
Web + lanzamiento TinCanExportación Web con xAPI activadoEl endpoint, las credenciales y el actor llegan como parámetros de consulta en la URL de lanzamiento (estilo TinCan/Rustici); los valores incrustados actúan como respaldo
Paquete xAPIEl formato de exportación específico xAPI (Tin Can)Incluye un manifiesto tincan.xml para que plataformas con LRS (por ejemplo, SCORM Cloud) puedan importarlo y lanzarlo; los parámetros de lanzamiento tienen prioridad sobre los valores incrustados

Qué se informa

Las declaraciones se generan a partir de plantillas por brick, con valores por defecto sensatos según la categoría:

  • Bricks de evaluación (opción única, relacionar, rellenar huecos…) — answered con el resultado (correcto/incorrecto). Activado por defecto.
  • Juegos casuales (wordle, memoria, ahorcado…) — attempted en la primera interacción, completed con el resultado. Activado por defecto.
  • Medios (vídeo, audio) y colecciones interactivas (acordeón, pestañas, carruseles…) — experienced / interacted. Desactivado por defecto — actívalo por brick donde la señal importe.
  • Estructura — se informa siempre mientras xAPI está activo: initialized / completed / terminated del curso, completed de la lección y passed / failed del cuestionario con la puntuación del motor de cuestionarios.

Personalización por brick

Abre el panel de edición de un brick y busca la sección Seguimiento xAPI (disponible en los bricks de evaluación, juego, medios y colección):

  • Informar declaraciones — Por defecto (categoría), Activado o Desactivado para este brick.
  • Verbo — elige de la lista de verbos estándar de ADL, o selecciona Verbo personalizado… para indicar tu propia IRI de verbo y nombre visible (para organizaciones con su propio perfil xAPI).
  • Nombre de la actividad — el nombre legible que se muestra en los informes del LRS (por defecto, el tipo de brick).

Previsualizar declaraciones

La Vista previa del editor ejecuta el motor xAPI completo contra un LRS simulado integrado. Abre el panel Declaraciones xAPI en la vista previa e interactúa con el contenido: cada declaración que enviaría el paquete exportado aparece en vivo — sin necesidad de LRS ni de red.

IRIs de actividad

Las declaraciones identifican sobre qué se actuó mediante IRIs jerárquicas fijadas en el paquete en el momento de exportar:

{app-url}/xapi/content/{contentId}                     ← curso
{app-url}/xapi/content/{contentId}/lesson/{lessonId}   ← lección
{app-url}/xapi/content/{contentId}/lesson/{id}/brick/{brickId}

Los bricks referencian su lección y su curso mediante contextActivities, de modo que los paneles del LRS pueden agrupar la actividad por lección y por curso. Estas IRIs son un contrato estable: volver a exportar el mismo contenido conserva las mismas IRIs, y el informe del LRS se mantiene continuo entre versiones.

Credenciales del LRS

Cuando incrustas un endpoint y unas credenciales de LRS en el momento de exportar, se escriben en el paquete (content.json) y son legibles por cualquiera que pueda abrir el zip — esto es inherente a los paquetes xAPI del lado cliente, y la práctica habitual de toda herramienta de autoría importante. Protégete:

  • Usando credenciales de LRS de solo escritura (solo entran declaraciones, no se leen).
  • Prefiriendo el modo de lanzamiento TinCan, donde la plataforma anfitriona inyecta credenciales de corta duración por cada persona que aprende.

Identidad de quien aprende

El actor de cada declaración se resuelve por orden de prioridad:

  1. El actor de la URL de lanzamiento TinCan (proporcionado por la plataforma anfitriona).
  2. El identificador de aprendiz de SCORM de la sesión del LMS (modo SCORM + xAPI), informado como un identificador account.
  3. Un identificador anónimo persistente único por navegador — usado cuando un paquete web se abre directamente.
Seguimiento xAPI