Custom Attributes allow you to add specific data points to session recordings captured by Noibu. This allows you to pass custom data like customer IDs, order IDs, campaign identifiers, or A/B test variants. It makes it easier to isolate and review relevant sessions in response to customer complaints or during troubleshooting.
Sending custom attributes to Noibu
Custom attributes can be passed to session recordings via Noibu's SDK, which adds key-value pairs to the current session. These can be later used as search criteria when filtering sessions in the Noibu platform.
If you're unable to use our SDK, your Noibu CSM can help configure an alternate method of collecting custom attributes from HTML selectors, rather than usind an SDK function. To configure custom attributes via HTML selectors, your CSM will need:
- Your domain name (e.g. acme.com)
- Attribute name(s) (e.g. order ID)
- Selector value(s) (e.g. t > ul > li.order > div > span)
- A selector value is the key used to select elements with a custom attribute. You can access an element’s selector value from the frontend of your eCommerce site with the help of the DevTools panel.
Use-cases for custom attributes
Some examples of ways eCommerce merchants use custom attributes in Noibu include:
- Customer ID: being able to find all sessions for a particular customer
- Marketing campaign: searching for any user sessions associated to marketing campaigns
- A/B test variants: comparing user experience in sessions on different landing page variants
- User segmentation: isolating users based on specific conditions, like their login status
- VOC feedback: finding specific session recording associated to VOC surveys. Learn more here.
Searching for sessions with custom attributes
From the Sessions page, click the Add Filter button and choose Custom ID Name and/or Custom ID Value.
When searching for sessions with custom attributes in Noibu, you can search by the attribute name, value, or both.
Filter by Custom ID Name: returns all sessions where the attribute name appears (e.g. "marketing-campaign" returns all sessions tied to any marketing campaign)
Filter by Custom ID Value: returns sessions where the value exactly or partially matches (e.g. "friday" would return all sessions tied to the "Black Friday" campaign, but also any sessions tied to a "Good Friday" campaign)
Combined Custom ID Name + Custom ID Value filters: returns sessions where both the name and value match for more precision (e.g. Custom ID Name = "marketing-campaign" and Custom ID Value = "Black Friday")
Reviewing sessions with Custom Attributes
Clicking on any session in the filtered table will open up session playback. Clicking through to the Session Details page will show additional context on the session, including any relevant custom attributes.