P2LRN Analytics

1. Qué muestra

2. Datos del curso y resultados

El paquete .p2lrn define el contenido y las actividades del curso. El seguimiento de una realización llega desde Player, desde un resultado .p2lrn-result o desde la plataforma donde se integra P2LRN.

3. CDN

Carga el componente y entrégale las métricas del curso abierto desde Player o los resultados .p2lrn-result importados. No es obligatorio utilizar una API. El atributo src sólo sirve cuando ya existe un documento JSON de métricas, no para apuntar directamente al archivo .p2lrn.

<script src="https://p2lrn.netlify.app/analytics/current/dist/p2lrn-analytics.js"></script>
<p2lrn-analytics id="analytics-curso" course-id="curso-actual"></p2lrn-analytics>
<script>
  // datasetCurso contiene métricas reales de este curso, obtenidas de Player
  // o de resultados .p2lrn-result ya validados; no es el archivo .p2lrn.
  document.querySelector("#analytics-curso").data = datasetCurso;
</script>

Para fijar una prerelease concreta, sustituye current por 0.5.0-alpha.11.

4. NPM

En proyectos con dependencias gestionadas, instala Analytics y registra el componente desde tu aplicación.

npm install @p2lrn/analytics@0.5.0-alpha.11

import '@p2lrn/analytics';

const panel = document.querySelector('p2lrn-analytics');
panel.data = datasetCurso; // datos reales del curso y resultados de sus alumnos
// refresh() sólo es necesario cuando se ha configurado un dataSource o src.

5. Dataset del Host

El contrato utiliza seis colecciones. Los identificadores son opacos para Analytics y su significado pertenece a tu plataforma.

{
  "learners": [{"id":"u-1","name":"Ana"}],
  "courses": [{"id":"c-1","title":"Matemáticas"}],
  "enrollments": [{"learnerId":"u-1","courseId":"c-1","progress":0.72}],
  "attempts": [{"id":"a-1","learnerId":"u-1","courseId":"c-1","activeTimeMs":840000}],
  "grades": [{"learnerId":"u-1","courseId":"c-1","value":82,"maxValue":100,"authoritative":true}],
  "events": [{"type":"p2lrn:progress","timestamp":"2026-10-28T10:00:00Z","learnerId":"u-1","courseId":"c-1"}]
}

6. Fuente de datos de una plataforma

Cuando P2LRN está integrado en una web o LMS, la plataforma puede entregar al panel el dataset del curso o implementar un dataSource propio. Analytics no exige una ruta API concreta ni obtiene métricas inventadas a partir del contenido del curso.

const panel = document.querySelector('p2lrn-analytics');

panel.data = datasetDelCurso;

// O bien:
panel.dataSource = {
  async load(filtros) {
    return obtenerDatosAutorizadosDelCurso(filtros);
  }
};

Si una aplicación ya dispone de una ruta autenticada propia, también puede utilizar createHttpAnalyticsDataSource apuntando a esa ruta de la aplicación. P2LRN no define ni impone una URL fija.

Las calificaciones sólo se consideran oficiales cuando la fuente autorizada las marca expresamente con authoritative: true. Un resultado offline no establece ese indicador por sí solo.

La aplicación integradora decide cómo identifica al usuario y qué datos puede consultar. El panel se limita a representar el dataset recibido.

7. Eventos y tiempo activo

Los eventos de Player pueden convertirse a learning-event/1. Analytics entiende categorías de ciclo de vida, navegación, evaluación, progreso, finalización, atención, medios, interoperabilidad, colaboración y error.

Para tiempo activo, el panel acepta activeTimeMs del intento y eventos p2lrn:active-time/p2lrn:attention. Cuando recibe valores acumulados del mismo intento conserva el mayor, evitando sumar dos veces el mismo intervalo.

8. Señales de seguimiento

Las señales no son un diagnóstico ni una predicción automática. Son reglas visibles que el Host puede ajustar.

El panel muestra el motivo de cada señal para que una persona pueda interpretarla y decidir qué hacer.

9. API del componente

10. API de agregación

También puedes usar Analytics sin montar el panel.

import {
  normalizeAnalyticsDataset,
  computeAnalyticsSnapshot,
  filterAnalyticsDataset,
  analyticsToCsv
} from '@p2lrn/analytics';

const dataset = normalizeAnalyticsDataset(raw);
const snapshot = computeAnalyticsSnapshot(dataset);
const csv = analyticsToCsv(snapshot, {kind:'courses'});

11. Eventos del Web Component

12. Privacidad y seguridad

• No incluyas alumnos, correos, notas o historial dentro de un paquete .p2lrn.
• Autoriza el endpoint de Analytics según institución, rol, curso y alcance del usuario conectado.
• No confíes en learnerId o courseId enviados por el navegador para decidir permisos.
• El CSV contiene los datos visibles en el panel; su descarga debe respetar la política de tu plataforma.
• Las puntuaciones informativas del navegador no deben convertirse silenciosamente en notas oficiales.