========================================================================
YouTube Video Tracker for Qualtrics  –  README.txt
Version 1.0   |   Last updated: 04-Aug-2025
========================================================================

1. PROJECT OVERVIEW
   Custom JavaScript that locks Qualtrics navigation until students
   meet video-watching requirements (percent watched, time-on-task,
   no skips, normal speed, focus on tab).

2. DIRECTORY MAP  (relative to this README)
   /src/                    JavaScript source files
       ├─ youtube_qualtrics_tracker.js
       ├─ quiz_save_reminder.js
       └─ completion_banner.js
   Installation_Guide_v1.0
   User_Guide_v1.0

3. PREREQUISITES
   • Qualtrics account with “Add JavaScript” enabled

4 DEPLOY TO QUALTRICS
   1. Copy **youtube_qualtrics_tracker.js** into a JavaScript element
      on the survey page that contains your video.
   2. In **Survey Flow**, add Embedded Data:
        • YT_URL          – full YouTube link (string)
        • videoWatched    – (optional) leave blank or set to “No”
      Other metrics (watchQuality, watchEfficiency, etc.) are
      created automatically by the script.
   3. Preview the survey.  Navigation remains locked until
      the video finishes.

6. KNOWN ISSUES (see Shortcoming & Wishlist document for full list)
   • Gate unlock requires 100 % completion even when
     WATCH_THRESHOLD < 100 (see Known Limitations L-03).
   • Script forcibly exits Fullscreen to display checkpoint questions
     (see Known Limitations L-01).

7. CONTACT / SUPPORT
   • Alejandro Camejo - acame047@fiu.edu
   • Luis Delgado - ldelg085@fiu.edu
   • Anders Gutierrez - aguti267@fiu.edu
   • Samantha Sanchez - ssanc225@fiu.edu

========================================================================
