Differences

This shows you the differences between two versions of the page.

--- create_an_interactive_e-learning_template [2019/10/15 08:42] – [Extended method of tracking the end of the quiz] lucy
+++ create_an_interactive_e-learning_template [2020/08/11 18:51] – lucy
@@ Line 27: / Line 27: @@
 b) If you are working on an awareness website within a campaign then click here (see pic)
-{{ q2.png?600 }}
+{{ ::awareness_website_quiz.png?600 |}}
 Lucy then will automatically inject a JavaScript called /js/quiz.js to your template, making quiz-‐related functions available
@@ Line 47: / Line 47: @@
 ===== How to track users watching an awareness video =====
+LUCY allows you to verify if a training video was played. Once a recipient finished watching the video he should be marked as "Trained".
 **Method 1: using the quiz checkbox**
@@ Line 54: / Line 56: @@
   * Mark the awareness template or website as "Quiz"
-{{ quiz_enabled_c.png?600 }}
+{{:quiz_video_track.png?600|}}
   * Make sure your awareness website (or template) has the quiz-question-titles.js static file with the following content: {"1": "Video Played"}
@@ Line 68: / Line 70: @@
 **Method 2: using the video tracking JavaScript**
-Using our custom tracking JavaScript which can be downloaded {{::lucy-event-javascript.zip|here}}, allows you to track video's played in LUCY's "flowplayer" which are used for all our video templates. The JS should be inserted into the bottom of the page where the flowplayer video is uploaded:
+Using our custom tracking JavaScript which can be downloaded {{::lucy-event-javascript.zip|here}}, allows you to track the video's played in LUCY's "flowplayer" which are used for all our video templates. The JS should be inserted into the bottom of the page where the flowplayer video is uploaded:
-{{ video_tracking_new.png?600 }}
+{{:video_2.png?600|}}
-This script allows you to track a video start and finish event and also display the progress in statistics (rounded percent in different event types like video-10 for 10% video played or video-90 for 90% video played, etc.). When the video is started, it sends a "video-start" event. When the video is finished (played to the end), it sends a "video-finish" event to LUCY which leads to statistics like in this graphic:
+This script allows you to track a video start and finish the event and also display the progress in statistics (rounded percent in different event types like video-10 for 10% video played or video-90 for 90% video played, etc.). When the video is started, it sends a "video-start" event. When the video is finished (played to the end), it sends a "video-finish" event to LUCY which leads to statistics like in this graphic:
 {{ video_stats_sample.png?600 }}
@@ Line 79: / Line 81: @@
 ===== Extended method of tracking the end of the quiz  =====
-Starting with version Lucy 4.6, there is a new option called “Use extended method of tracking the end of the quiz”, which is designed to track when the user finishes the quiz. The option is available on the Awarness Template editing page:
+Starting with version Lucy 4.6, there is a new option called “Use extended method of tracking the end of the quiz”, which is designed to track when the user finishes the quiz. The option is available on the Awareness Template editing page:
 {{ ::extended_method_quiz.png?&600 |}}
@@ Line 88: / Line 90: @@
 :!: Attention! Enabling this option without calling the "lucyQuizEnd()" function will cause recipients to not be marked as "trained".
+By default, Lucy marks each recipient as "Trained" after receiving the very first answer to the quiz. With the option "Use extended method of tracking the end of the quiz" and calling the function lucyQuizEnd(), the Trained sign can be set at the moment when it is necessary.
+==== An example of usage the function lucyQuizEnd() in awareness training ====
+Using the awareness template "Internet Security Exam" as an example, add the function lucyQuizEnd() to the source code for processing quiz answers. The quiz has 9 questions. The goal is to find victims who give 5 correct answers to the quiz. Enable the option "Use extended method of tracking the end of the quiz" within the Website section of the Awareness Settings in the campaign.
+Add a new variable "correctAnswerCount" to keep the amount of correct answered questions:
+<code>
+var correctAnswersCount = 0;
+</code>
+{{ ::awareness_quiz_new_variable.png?nolink&600 |}}
+Find the place in the code where function lucyQuizAnswer is called and insert a call of the function lucyQuizEnd after it with the condition as shown below.
+<code>
+correctAnswersCount++;
+if (correctAnswersCount >= 5) {
+    lucyQuizEnd();
+}
+</code>
+{{ ::awareness_quiz_end.png?nolink&600 |}}
+Save the template and run the campaign. After 5 quiz questions are answered correctly, the recipient will be marked as "Trained".
+:!: **Attention**. Using the function //lucyQuizEnd()// together with the option "**Ignore repeated answers in awareness**" __should be avoided__, since this function ignores the restrictions set by that option.
+===== Troubleshooting =====
+__Issue.__ Lucy marks the recipients as 'Trained', while no quiz answers were given. \\
+__Solution__: Enable the option "**Quiz**" within the Website section of the Awareness Settings in campaign.
+__Issue.__ Lucy does not mark the recipients as 'Trained' despite received positive Quiz answers. \\
+__Solution__: Disable the option "**Extended method of tracking the end of the quiz**" within the Website section of the Awareness settings in campaign or change your awareness template as described above in this article.