Other API functions

Other client-side API functions

  1. 1.
    1. 1.
    2. 2.
  2. 2.
    1. 1.
  3. 3.
    1. 1.
      <input class='noRecord'/>

1. Disable tracking yourself

// Starting with the next page load the tracking will be disabled
// Removes the "disabled" flag.
// Starting with the next page load you will be tracked
  • To disable tracking yourself or other client you can call UST.disableRecord() from the JavaScript console or from a JS file.
  • To re-enable tracking the curent client call UST.enableRecord()
  • The tracking enabled/disabled flag is stored in the localStorage. As long as the browser localStorage is not cleared/reset this setting will persist. (eg: you won't be tracked again unless you clear all your browser data/cookies/localStorage)
Note: You can also use the ust-opt-out and ust-opt-in query strings to disable tracking on a specific website where the tracker is installed. Access that website and add the query string like this: www.site.com?ust-opt-out.

2. Force send the recorded data

// A request to send *new* data to the server will be created
  • userTrack sends data to the server in an efficient way: it batches multiple actions made by the users and sends all of them at once in a single request. This means that sometimes you have recorded data stored on the client that hasn't been sent yet (it's queued to be sent in a specific amount of time). You can call UST.forceSendData() to reset the time left to send the next batch to 0, thus forcing userTrack to send the data as soon as possible.
  • One use case of this method is if you want to make sure the last seconds of the user's visit are recorded by calling UST.forceSendData() inside window onbeforeunload callback.
  • You could also call this function after the user makes an important action that you want to make sure has been sent to the server (eg: user clicks a specific button). Note that in this case you should also use UST.addTag()

3. Disable tracking a text input field

// Add the `noRecord` class to the element to stop tracking keyboard input
<input type="text" name="my-sensitive-input" class="noRecord"/>
  • By default all inputs with type="password" are NOT recorded.
  • To disable keyboard input tracking for any other input simply add the class noRecord to the element.