Salesforce Commerce Cloud (SFCC) customers using SiteGenesis (SG) or Storefront Reference Architecture (SFRA) architectures can deploy Noibu’s ecommerce error monitoring platform via our cartridge on the Salesforce AppExchange.
| Note: these instructions are for SiteGenesis (SG) or Storefront Reference Architecture (SFRA) architectures only. If you use PWA Kit (headless) architecture, you must deploy Noibu manually instead. |
Once installation is complete, you’ll have access to Noibu’s error monitoring, performance monitoring, and session replay. You can also additionally configure SFCC logs integration to view error and warning logs directly in Noibu.
- Installing the Noibu Cartridge for SFCC
- Viewing SFCC custom attributes in session replays
- Viewing SFCC logs
Installing the Noibu Cartridge for SFCC
Noibu provides a cartridge for both SiteGenesis (SG) and Storefront Reference Architecture (SFRA) architectures for Salesforce Commerce Cloud. Both have the same functionality, but installation steps differ slightly.
| Note: if you’re an existing Noibu customer on SG or SFRA architecture who has previously deployed to SFCC via a Tag Management System or manual script, you’ll need to remove this prior to installing the SFCC cartridge. |
1. Go to Noibu’s listing on the Salesforce App Exchange and click “Get it Now” and authenticate with your Salesforce account.
2. After authenticating, you will be redirected to a Github repository containing Noibu’s SFCC cartridge for installation. Download and install the SFCC cartridge following the technical instructions included here.
3. Complete the cartridge setup within SFCC. Full details can be found in the cartridge technical documents, but at a high level you will be required to:
- Import the cartridge into your SFCC workspace via Commerce Cloud Studio
- Assign the cartridge to your site using Business Manager
- Change the custom preferences for the Noibu Cartridge to enable it
- If you have customized SFCC’s default page templates, additional configuration may be required, as detailed in the “Custom Code” section of our technical documents.
What happens next: No further action is needed at this point; our team will reach out soon afterwards to help you complete your Noibu configuration and deployment.
Viewing SFCC custom attributes in session replays
For sites built on SFRA architecture, Noibu automatically captures several relevant custom attributes from SFCC as it collects session recordings from users on your store. By navigating to the Details tab, you can see Custom Attributes logged specifically from your SFCC storefront:
- sfcc-session-id: Unique identifier for the user's session on your site
- customer_id: Unique identifier for logged-in customers
- customer_group: Identifies customer group (VIP, Wholesale, etc.)
- order_id: Unique identifier for the placed order
- order_token: Helps retrieve order details via SFCC API
- cart_id: Unique identifier for the cart (if it exists)
- promotions: List of active promotions affecting the user
- coupon_codes: Discount codes applied at checkout
You can also filter session recordings based on these custom attributes, which can serve as helpful diagnostic information for customer success teams investigating an issue, or for technical teams looking to reproduce and debug an error. Learn more about session replay in Noibu.
Viewing SFCC logs
Noibu’s SFCC Logs integration allows your team to see key error and warning logs directly in Noibu, removing the need to switch between tools when debugging. When enabled, this integration provides extended data retention and a real-time view of server-side warning and error logs, giving developers the full context they need to quickly diagnose and resolve errors. Learn more about enabling the logs integration for SFCC