The NoibuJS software development toolkit–or SDK–allows you to interact with captured session data by creating custom attributes. 

The NoibuJS SDK is accessible from the global window object. The NOIBUJS attribute is set on the window object as soon as the Noibu script loads. Before using the SDK, check if the attribute is defined by running the function below:

function checkSDKExistanceAndAddCustomAttribute(){
  const sdkCheck = setInterval(() => {
    if(window.NOIBUJS){
        clearInterval(sdkCheck);
        window.NOIBUJS.addCustomAttribute('name','id');
    }
  }, 3000);
}

checkSDKExistanceAndAddCustomAttribute()

This function checks if the window object has the NOIBUJS attribute every three seconds. Once the attribute is found, it stops the interval and calls the function within the SDK. The function is addCustomAttribute.

The addCustomAttribute Function

The addCustomAttribute function adds a custom attribute to the session you are working on, which helps you isolate it on the Noibu platform for later use. The attribute can be used to search Noibu sessions in a Session Search, and you can search by either the name or attribute value. Searching by the name value returns all sessions where an id with that name appears. Searching by value only returns sessions where the value matches the value searched. If you want to match the name and value, then use both filters in a session search.

Common uses for the addCustomAttribute function include: 

• Creating a custom attribute for Customer ID:

  window.NOIBUJS.addCustomAttribute('customerID', '934739856')

• Creating a custom attribute for a marketing campaign:

  window.NOIBUJS.addCustomAttribute('campaign', 'BlackFridayCampaign')

• Create a custom attribute for logged in status:

  window.NOIBUJS.addCustomAttribute('isLoggedIn', 'True')

• Create a custom attribute for an A/B test:

  window.NOIBUJS.addCustomAttribute('variant', 'A')

 

Note that you cannot add multiple custom attributes with the same attribute name. For example:

window.NOIBUJS.addCustomAttribute('customerID', 'ABC')
window.NOIBUJS.addCustomAttribute('customerID', 'DEF')

Will only result in the first custom attribute value ('ABC') being captured in Noibu. 

Parameters 

• name: The name of the attribute
• value: The value of the attribute

Validation

• name: String, with maximum 50 characters (exceeding this amount will not add the custom attribute)
• value: String, with maximum 50 characters (exceeding this amount will not add the custom attribute)

Limitations

• Once you add an attribute, you cannot edit the value of it. You can only add additional attributes.
• You can add a maximum of 10 attributes per page. Every time the user causes the page to reload counts as a new page. For example, if a user visits 10 pages, then you can have 100 attributes in that session.
• You cannot also use an object or number as a parameter; the function only takes strings.

The addError Function

The addError function allows you to create custom errors through the SDK. If you see an error occurring in a session, use this function to point out where it's happening. By examining several sessions where the error occurs, you can identify the money you may be losing due to the error. 

The basic structure of the function is as follows:

window.NOIBUJS.addError(new Error(Error message))

Requirements

You must pass an error object to the addError function for the function to work.

The requestHelpCode Function

Through the requestHelpCode function, you can programmatically request a Help Code through the SDK. A help code identifies a shopper's unique session and allows support reps to associate a customer complaint to a session recording in the Noibu console. 

The structure of this command is as follows:

window.NOIBUJS.requestHelpCode()

Use Cases

• A shopper can Generate a Help Code independently, but if a problem occurs you can use this API to access the help code.
• Several shoppers have requested a method of generating a help code without asking the shopper to modify their URL. With the requestHelpCode function, you can create a link or button that a shopper can click to generate the code. We recommend putting this link in your site's footer.
  • Note: To allow for clean filtering in the Session Search, it's crucial that all help codes are generated deliberately, and creating a button may result in mis-clicks or bot activity generating erroneous help codes. To avoid this problem, we recommend assigning an unusual action to the help code button–right clicking or clicking four times, for example–to ensure that only shoppers instructed by CS can generate a help code.

Video Walkthrough

---

Learn more about the Noibu Session ID, the Friction Factor, and Session Collection Failures.