View Categories

Tracking des interactions vidéo sur les replays (APCH Video Tracking) : audit et export CSV

3 min read

Le plugin APCH Video Tracking enregistre toutes les interactions des participants sur les leçons vidéo des replays : lecture, pauses, progression, fin de vidéo et clics sur le bouton « Terminer la leçon » — y compris lorsque celui-ci est grisé. Il permet de répondre factuellement à toute réclamation du type « le bouton ne fonctionne pas ».

💡 Bon à savoir. Le bouton « Terminer la leçon » est volontairement désactivé par Sensei (« vidéo requise ») tant que la vidéo n’a pas été visionnée en entier. La plupart des réclamations viennent de participants qui cliquent sur ce bouton grisé sans avoir terminé la vidéo — le tracking en apporte désormais la preuve.
1. Ce que le plugin enregistre
ÉvénementSignification
play / pauseLecture / mise en pause, avec la position dans la vidéo
progress25 → progress100Jalons de progression : 25 %, 50 %, 75 % et quasi-fin (déclenché à 95 %), envoyés une seule fois chacun
endedVidéo terminée
complete_clickClic sur le bouton « Terminer la leçon » actif
complete_click_disabledClic sur le bouton grisé — la preuve directe du comportement signalé

Chaque événement est horodaté et associé à l’utilisateur, à la leçon et à la position dans la vidéo. L’enregistrement est automatique pour toutes les leçons, y compris les futurs replays créés avec « Dupliquer un Replay ».

2. Ouvrir l’audit

Dans le menu de gauche de l’administration, ouvrez Sensei LMS → Audit participation replay (visible uniquement pour les administrateurs).

Sensei LMS Reports Audit participation replay Settings Tools
L’entrée « Audit participation replay », entre Reports et Settings.
3. Filtrer et lire les résultats

Trois listes déroulantes, combinables :

  • Étudiant — nom et email ;
  • Cours — titre suivi de l’index (ex. 2026-023-R) ; sélectionner un cours limite la liste des leçons à celles de ce cours ;
  • Leçon — titre et cours de rattachement.

Seuls les étudiants, cours et leçons ayant réellement des événements apparaissent dans les listes. Le tableau affiche les 500 derniers événements correspondants, du plus récent au plus ancien.

Lecture typique d’une réclamation : play à 14h02, progress25, progress50, puis plus rien… et un complete_click_disabled. Le participant a arrêté la vidéo à mi-parcours puis cliqué sur le bouton encore grisé : il doit simplement visionner la vidéo en entier.

4. Exporter en CSV

Le bouton « Exporter en CSV » télécharge l’intégralité des événements correspondant aux filtres en cours (sans la limite des 500 lignes).

Le fichier s’ouvre directement dans Excel (séparateur « ; », encodage UTF-8 avec BOM) et contient : date/heure, ID et nom de l’étudiant, email, ID et titre de la leçon, index et titre du cours, événement, position vidéo en secondes.

5. Notes techniques & maintenance
  • Plugin dédié apch-video-tracking (v1.3.4), désactivable sans effet de bord : la table {prefix}apch_video_events et ses données sont conservées.
  • Collecte côté navigateur via le SDK Vimeo Player, envoi vers l’endpoint REST POST /wp-json/apch-vt/v1/event (utilisateurs connectés uniquement, liste blanche d’événements).
  • L’index du cours est lu depuis le champ JetEngine index-cours.
  • Après chaque mise à jour du plugin : purger le cache Flywheel.
  • Accès SQL direct si besoin : SELECT * FROM {prefix}apch_video_events ORDER BY id DESC;

En résumé

Un participant se plaint ? Sensei LMS → Audit participation replay, filtrer sur son nom, lire la chronologie (ou l’exporter en CSV) : vous voyez en 30 secondes s’il a réellement terminé la vidéo et sur quel bouton il a cliqué.