Record app user sessions with FullstoryBeta
Learn how to capture user app behavior for use with Fullstory.
Retool can record user behavior and interactions with apps using Fullstory. When enabled, data about user interactions with apps are reported directly to Fullstory for you to review in detail. You can then analyze app analytics, evaluate impact, and review interactions with session replay.
Considerations
A user session contains behavioral data, such as interactions, that occur with an app during a period of activity. Retool captures user session data for production apps that are accessed in user mode. This includes any external apps your organization may have.
A new session starts whenever a user launches an app. The session ends when a user leaves the app (such as closing the browser or navigating to a different page). Sessions may also end after a period of inactivity. Refer to Fullstory's session documentation to learn more about session activities.
Retool automatically includes the user's email address for each user session. User-sensitive data is automatically masked by Fullstory by default. If you need to display sensitive information in plain text within apps, Retool recommends using configuration variables or secrets to prevent this information from being captured.
If required, you can also configure data capture rules in Fullstory for specific elements using CSS selectors.
1. Enable user session recording
Gather the following information from your Fullstory account:
- A Fullstory organization. You can choose to create a new organization or use an existing one.
- Your Fullstory Org ID. Retool uses this ID when sending user sessions to Fullstory.
Then, navigate to the observability settings in your organization and set the Fullstory orgID. Choose how you want to handle embedded apps. Once configured, Retool automatically captures and reports user sessions to Fullstory.
Embedded apps
If you want to record embedded apps, you must identify how you want Retool to do so when you set up the Fullstory integration.
| Configuration Option | Setup Description | Expected Behavior |
|---|---|---|
| Record embedded apps unchecked (default behavior) | Parent and embedded app are on the same domain. | Records embedded app within the parent session. |
| Record embedded apps > Send data to app Fullstory org | Parent and embedded app are on different domains or subdomains. | Records iFrame separately from the parent app. |
| Record embedded apps > Send data to parent Fullstory org | Parent and embedded app are on different domains or subdomains. | Records embedded app within the parent session. |
See Fullstory documentation for additional information.
2. Define session elements
Fullstory automatically tags certain Retool components to provide insights, such as elements clicked the most. You can define additional elements with Fullstory using CSS selectors from Retool components.