Skip to main content
All CollectionsDeveloper
Unleashing Session Control Using Custom Attributes
Unleashing Session Control Using Custom Attributes

A Guide to Harnessing Custom Attributes with FullSession

Updated over a year ago

Introduction

FullSession, a robust web analytics tool, empowers users with advanced features to navigate and analyze a vast array of recorded sessions. One such feature is the utilization of custom attributes, which enables users to attach specific attributes to sessions as tags. In this article, we will explore how FullSession users can effectively employ custom attributes to categorize sessions, facilitating streamlined searches and insightful filtering.

Understanding Custom Attributes

Custom attributes serve as tags that users can attach to sessions, providing a flexible means of categorization. By associating sessions with relevant attributes, FullSession users can build tailored filters, making it easier to pinpoint specific sessions within the extensive pool of recorded data. To illustrate, consider a scenario where FullSession users wish to differentiate between sessions of end-users still exploring the application under a free trial and those of paid users.

Implementation of Custom Attributes

Whenever you need to gather specific user details or connect with external tools (like help desk software), use the FUS.setSessionAttributes function. This function requires a single argument: a JSON object with straightforward key/value pairs representing the information you want to collect.

FUS.setSessionAttributes(userVars); // userVars is a JSON object

To put it another way:

FUS.setSessionAttributes({
field: value,

});

Wondering what you can gather this way? Almost anything! It'll become clearer as you explore the sections below. These functions establish particular attributes for sessions, serving as markers for subsequent filtering.

FUS.setSessionAttributes({"customerPlan":"free"}) // for sessions from end-users under free trial FUS.setSessionAttributes({"customerPlan":"paid"}) // for sessions from paid end-users

These JavaScript functions, FUS.setSessionAttributes, allow the attachment of attributes such as "customerPlan" with values like "free" or "paid" to sessions, providing a clear distinction between user groups.

See more examples below:

Type suffix

Meaning

Example

str

string

{  "nickname_str": "boo" }

int

integer

{  "PasswordResets_int": 49 }

real

real

{  "amtAbandonedInCart_real": 3.84 }

bool

boolean

{
"didSelfServiceSignup_bool": true

Navigating Custom Attributes in FullSession

After a session concludes (typically 30 minutes after the last activity), FullSession users can easily locate the passed key-value pairs under the custom attributes category. This intuitive approach allows users to seamlessly access and utilize these attributes as filters in their session analysis.

Refining Session Searches

With custom attributes in place, FullSession users can refine their session searches based on specific criteria. In the example scenario, users can filter sessions based on the "customerPlan" attribute, selecting either "free" or "paid" to differentiate between users under a free trial and paid users, respectively.

In conclusion, harnessing custom attributes in FullSession provides users with a powerful tool to categorize and filter sessions effectively. By attaching attributes to sessions and utilizing them as tags, users can streamline their analysis, making it easier to find and focus on specific user groups or behaviors. Understanding the implementation and navigation of custom attributes is a valuable skill for FullSession users seeking to gain nuanced insights from their recorded sessions and make data-driven decisions to enhance their applications.

Did this answer your question?