You are reviewing MouseStats documentation: Take a look to the product!

How to start tracking manually using JavaScript API?

By default, If all rules are match, tracking will be started on page load. For advanced usages, you are allowed to prevent tracking for each service, and start it when it's required using MouseStats JavaScript API. To clarify the usage, you can imagine an in-page popup JavaScript page that we want to make heatmaps for it. In this case, you need to stop tracking on page load, and start tracking on popup show.

How?

There are some variables you can set them True before the tracking script to prevent auto start tracking on page load for each service:

In this example, we have disabled auto start for all services:

<script language="javascript" type="text/javascript">
   var MouseStats_PausedPlaybacks = true; //Prevent AutoStart Playback Recording
   var MouseStats_PausedHeatmaps = true; //Prevent AutoStart Heatmaps Recording
   var MouseStats_PausedFormAnalytics = true; //Prevent AutoStart Form Analytics Recording
   var MouseStats_PausedMicroSurveys = true; //Prevent AutoStart Micro Surveys
</script>

//Tracking script here!

And any time after page load, you can call this functions to start tracking:

<script language="javascript" type="text/javascript">
   try { MouseStatsVisitorPlaybacks.Resume(); } catch(e) { MouseStats_PausedPlaybacks = false; }; //Start Playback Recording
   try { MouseStatsHeatmaps.Resume(); } catch(e) { MouseStats_PausedHeatmaps  = false; }; //Start Heatmaps Recording
   try { MouseStatsFormAnalytics.Resume(); } catch(e) { MouseStats_PausedFormAnalytics = false; }; //Start Form Analytics Recording
   try { MouseStatsMicroSurveys.Resume(); } catch(e) { MouseStats_PausedMicroSurveys = false; }; //Start Micro Surveys
</script>

//Tracking script here!


Moreover, you can Stop recording if you need to do it in some cases such as single-page applications:

<script language="javascript" type="text/javascript">
   try { MouseStatsVisitorPlaybacks.Stop(); } catch(e) { }; //Stop Playback Recording
   try { MouseStatsHeatmaps.Stop(); } catch(e) { }; //Stop Heatmaps Recording
   try { MouseStatsFormAnalytics.Stop(); } catch(e) { }; //Stop Form Analytics Recording
</script>

//Tracking script here!