UXWizz (formerly userTrack)
Search…
📖
Guides
🔧
JavaScript API
Hooks/callbacks
What are userTrack callbacks?
The userTrack callbacks or hooks are a way to tap into the client-side userTrack tracking functionality and listen to specific events. This is useful, for example, if you want to read or forward some userTrack tracking data to another service.
Available callbacks
- UST.onLoaded
- Called as soon as the ust.min.js finishes loading.
- UST.onTrackingStarted
- Called when all tracking checks passed, meaning that a new session will be created.
- UST.onSessionCreated(clientID: number)
- Called when the userTrack server create a new session for this client
- clientID: The integer number ID of the session.
- This is called only once per visit for each visitor.
- UST.onPageViewCreated(clientID: number, clientPageID: number)
- Called when a new page has loaded and the server responded with the pageview ID.
- clientID: The integer ID of the session.
- clientPageID: The integer ID of the pageview.
- This callback is also called once immediately after onSessionCreated (first pageview).
- UST.onDataSent(data: string[])
- Called whenever tracking data (session recording/heatmap data) is sent to the server.
- data: An array of data strings sent to the server. Each data string is in the format
c=XXXwherecis the data type andXXXis the data value. The data type can be:- m - Heatmap movements
- c - Heatmap clicks
- p - Partial recording data
- r - Full recording data (sent when pageview has finished)
- i - clientPageID
- Data value is a number
- UST.onTagAdded(tag: string)
- Called when UST.addTag() was called and the server responded.
- tag: The string that has just been added as a tag to the current user.
- UST.onEventAdded(eventData: Event)
- Added in version 3.5.0
- Called when UST.addEvent() was called and the server responded.
- eventData: The original eventData passed, also containing clientID and clientPageID
- UST.onGDPRAccepted
- Called when the user accepted the tracking consent pop-up.
- UST.onGDPRDeclined
- Called when the user declined the tracking consent pop-up.
Usage example
Make sure write the callbacks declarations after the tracking file is included.
1
// <head>
2
// After ust.min.js include snippet
3
// ...
4
// <script>
5
6
// Example: User will be recorded
7
UST.onTrackingStarted = function() {
8
console.log('Creating session...!');
9
}
10
11
// Example: New session has been created with an unique clientID
12
UST.onSessionCreated = function(clientID) {
13
console.log('New session created for client', clientID);
14
}
15
16
// Example: whenever a tag is added, add the same tag + current pageID
17
UST.onTagAdded = function(tag) {
18
if (tag === 'AddToCart' || tag === 'Converted') {
19
UST.addTag(tag + ';' + sessionStorage.clientPageID);
20
}
21
}
22
23
// <script>
24
// </head>
Copied!
After the session has been created (onSessionCreated), you can always read the current userTrack clientID and clientPageID from sessionStorage:
sessionStorage.getItem('clientPageID')
sessionStorage.getItem('clientID')
sessionStorage.getItem('token')
token - Another unique identifier per session (similar to clientID).
This is useful as it's not incremental.
Notes
Positions string (compressed format):
1
"X1^Y1^count1~X2^Y2^count2"
2
// For example:
3
"303^490^1~441^570^1~439^642^1"
Copied!
Recording string (compressed format)
1
// This is more complex, looking at the data send or in the ust_records
2
// Should give you some idea of the format
3
// Some event names and their shorthand character:
4
enum PlaybackEventType {
5
CLICK = 'c',
6
SCROLL = 's',
7
MOVEMENT = 'm',
8
INACTIVITY = 'i',
9
BLUR_INPUT = 'b',
10
TEXT_SELECTION = 'a',
11
WINDOW_RESIZE = 'r',
12
}
13
14
// For example
15
"a`body(2)(1)(5)(1)(2)(4)(2)(4)%201%23T%23^body(2)(1)(5)(1)(2)(4)(2)(4)%201%23T%23^8^9~i`80"
16
"m`966^1016~i`8~s`0^806~s`0^998~m`954^1415~s`0^1000~m`962^1416"
Copied!
Last modified 7mo ago
Copy link