P2LRN Analytics

1. What it shows

2. Course data and results

The package .p2lrn defines the content and activities of the course. The monitoring of a realization comes from Player, from a result .p2lrn-result or from the platform where P2LRN is integrated.

3. CDN

Load the component and give it the metrics of the open course from Player or results .p2lrn-result imported. It is not mandatory to use an API. The attribute src It only works when a metrics JSON document already exists, not to point directly to the file .p2lrn.

<script src="https://p2lrn.org/analytics/current/dist/p2lrn-analytics.js"></script>
<p2lrn-analytics id="course-analytics" course-id="current-course"></p2lrn-analytics>
<script>
  // courseDataset contains real metrics for this course, obtained from Player
  // or from already validated .p2lrn-result files; it is not the .p2lrn course file.
  document.querySelector("#course-analytics").data = courseDataset;
</script>

To set a specific prerelease, replace current by 0.5.0-alpha.11.

4. NPM

In projects with managed dependencies, install Analytics and register the component from your application.

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

import '@p2lrn/analytics';

const panel = document.querySelector('p2lrn-analytics');
panel.data = courseDataset; // real course data and learner results
// refresh() is only needed when a dataSource or src has been configured.

5. Host Dataset

The contract uses six collections. Identifiers are opaque to Analytics and their meaning belongs to your platform.

{
  "learners": [{"id":"u-1","name":"Ana"}],
  "courses": [{"id":"c-1","title":"Mathematics"}],
  "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. Platform data source

When P2LRN is integrated into a website or LMS, the platform can deliver the course dataset to the panel or implement a dataSource own. Analytics does not require a specific API path or derive invented metrics from course content.

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

panel.data = datasetDelCurso;

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

If an application already has its own authenticated route, it can also use createHttpAnalyticsDataSource apuntando a that application path. P2LRN does not define or enforce a fixed URL.

Ratings are only considered official when the authorized source expressly marks them with authoritative: true. An offline result does not establish that indicator on its own.

The integrating application decides how it identifies the user and what data it can consult. The panel is limited to representing the received dataset.

7. Events and active time

The events of Player can be converted to learning-event/1. Analytics understands categories of lifecycle, navigation, evaluation, progress, completion, attention, media, interoperability, collaboration, and error.

For active time, the panel accepts activeTimeMs of the attempt and events p2lrn:active-time/p2lrn:attention. When it receives accumulated values ​​from the same attempt, it keeps the largest, avoiding adding the same interval twice.

8. Tracking signals

The signs are not a diagnosis or an automatic prediction. They are visible rules that the Host can adjust.

The panel shows the reason for each signal so that a person can interpret it and decide what to do.

9. Component API

10. Aggregation API

You can also use Analytics without mounting the dashboard.

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

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

11. Web Component Events

12. Privacy and security

• Do not include learners, emails, notes or history within a package .p2lrn.
• Authorizes the Analytics endpoint based on the institution, role, course, and scope of the connected user.
• Don't trust learnerId or courseId sent by the browser to decide permissions.
• The CSV contains the data visible in the dashboard; Your download must respect your platform's policy.
• Informational browser scores should not quietly become official grades.