Integrating Roundtable
This guide explains how to integrate Roundtable’s behavioral biometrics and session replay platform into your web application.
Quick Start
Add our tracking script to your website by inserting this single line of code in the <head>
section of your HTML:
Replace YOUR_SITE_KEY
with the site key found in your Roundtable dashboard. The data-user-id
attribute is an optional but recommended for tracking users across multiple sessions. This can help you identify whether a user’s activity is anamolous relative to their historical activity.
For optimal performance, place the script in the <head>
section of your HTML document as early as possible.
Example Implementations
Standard Website
For traditional websites, add the script to your base HTML template:
Single Page Application (SPA)
For React, Angular, Vue.js, or other SPAs, add the script to your main HTML file:
React (public/index.html)
Vue.js (index.html)
Identifying Users
If included, the data-user-id
allows you to associate session data with specific users. This identifier should be consistent across sessions and devices, such as an email hash or account number hash. We recommend anonymizing this ID before passing it to our script.
If the user ID isn’t available when the HTML is initially rendered (e.g., after login or API call), you’ll need to dynamically add the script:
Using a Session ID
Our Javascript tracker generates a session ID which is stored in session storage under the key rtSessionId
. This ID can be used to retrieve data for a specific session later.
You can access the session ID in your code at any time:
Next Steps
- Visit your Roundtable Account to generate a public API key.
- Learn how to Access Session Data to retrieve user actions and replay recordings
- Explore our API Reference for more details