--- schema_version: "1" id: 49d2d1bb79fb034b69c949708b64d789a31d9dd314b8f1e8d244fff4745cb916 title: Reports & Dashboards collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/pwa-kit-managed-runtime/guides/reports-and-dashboards.md canonical_url: https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/reports-and-dashboards.html source_site: developer.salesforce.com content_type: documentation content_hash: 9e9e74ad15de42cbc751e68732dea696481e0ae887327da0737e488b1d2ebafd products: - Composable Storefront - Salesforce APIs --- # Reports & Dashboards With [B2C Commerce Reports & Dashboards](https://help.salesforce.com/s/articleView?id=cc.b2c_reports_and_dashboards.htm&type=5), you can identify trends over time and make smarter business decisions based on your B2C Commerce data. View data on order conversion metrics, site traffic, frequently searched products, and more. This guide explains how to configure and verify Reports & Dashboards to use with your Progressive Web App (PWA) Kit site. ## Prerequisites To use Reports & Dashboards: - Open a support case asking Salesforce Customer Support to [enable Einstein Activities](https://developer.salesforce.com/docs/commerce/einstein-api/guide/einstein-activities-overview.html#business-manager-configuration). If you're migrating from an existing Storefront Reference Architecture (SFRA) site ([hybrid storefront](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/hybrid-implementation.md) or otherwise), you should time this step to coincide with your Composable Storefront launch to preserve your existing SFRA reporting. - Have the Reports and Dashboards user role in [Account Manager](https://account.demandware.com/) with the scopes of the permission set to the environments in your [realm](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide). If you don’t have this role, ask your Account Manager administrator to assign it to you. See [Managing Account Manager for Salesforce B2C Commerce Users](https://help.salesforce.com/s/articleView?id=000391212&type=1). **note:** Unless otherwise stated, all of the points in this guide apply to sites built 100% with [Composable Storefront](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/getting-started.html) (PWA Kit) or with a [phased headless rollout](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/phased-headless-rollouts.html). ## Configure Reports & Dashboards After completing the [prerequisites](#prerequisites), configure Reports & Dashboards by following these steps. ### 1. Configure Business Manager - Enable access to Einstein API endpoints. See [Enable Access](https://developer.salesforce.com/docs/commerce/einstein-api/guide/einstein-activities-overview.html#enable-access). - Configure your B2C Commerce instance to use Einstein Activities for analytics. See [Business Manager Configuration](https://developer.salesforce.com/docs/commerce/einstein-api/guide/einstein-activities-overview.html#business-manager-configuration). ### 2. Update SFRA to Use the Einstein Activities API **Phased headless rollout only:** Complete the steps in [Einstein Activities for Phased Headless Rollouts](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/einstein-activities-for-phased-headless-rollouts.html). ### 3. Configure Your PWA Kit Settings In your PWA Kit project, go to `template-retail-react-app/config/default.js` and set the properties as follows. - **`host`**: Almost always set to the Einstein production instance `api.cquotient.com`. If you want to use a proxy, you can set this property to a value such as `/mobify/proxy/einstein`. See [No Data in Reports & Dashboards after Correct Setup](#pwa-kit-only-no-data-in-reports--dashboards-after-correct-configuration). - **`einsteinId`**: Your Einstein API key that you received when you [configured Business Manager](#1-configure-business-manager). - **`siteId`**: Use the format `realm-siteId`. For example, `zzrf-RefArch.` - **`isProduction`**: Set this property to `true` if the data is from a production MRT environment. Data appears in Reports & Dashboards only if `isProduction`is set to `true`. Set this to `false` if the data isn’t from a production [Managed Runtime (MRT) environment](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/mrt-overview.html#environments). For example, if you’re working in a development environment. Replace placeholders in this example with actual values. Placeholders are formatted like this: `$PLACEHOLDER`. ```jsx einsteinAPI: { host: 'https://api.cquotient.com', einsteinId: '$EINSTEIN_ID', siteId: '$SITE_ID', isProduction: false } ``` After you complete the configuration, data appears in Reports & Dashboards in 24 hours. After that, any new data appears in Reports & Dashboards 24 hours after any corresponding event happens. ## Verify When Einstein Activity Events Are Sent Install the [B2C Commerce Recommendation Validator](https://chrome.google.com/webstore/detail/commerce-cloud-recommenda/dobmbolmcejainkefklnpkjbaibgjihn) Chrome addon to see the activity events that a page sends out. Alternatively, you can check the network requests in your browser and filter for `api.cquotient.com` requests. ## Verify Your Data After completing the [prerequisites](#prerequisites) and [configuration](#configure-reports--dashboards), verify your data in Reports & Dashboards. We recommend that you verify your order numbers. 1. Log into Business Manager. 2. Click App Launcher ![App Launcher](https://developer.salesforce.com/docs/media/shared/appLauncher.png) and then select **Merchant tools > _Your Site_ > Analytics > Reports & Dashboards**. 3. Confirm that order numbers on the Home and Sales tabs are what you expect based on the activity on your site. 4. Go to **Traffic > SHOPPER JOURNEY**. 5. Confirm that the Visits With Orders number is what you expect based on the activity on your site. For more granular analysis, you can filter the report by a specific date or date range. See [Set the Dashboard Date Range](https://help.salesforce.com/s/articleView?id=cc.b2c_set_dashboard_daterange.htm&type=5). ![Associated screenshot](https://developer.salesforce.com/docs/media/pwa-kit-managed-runtime/reports-dashboards2.png) ## Troubleshoot Reports & Dashboards This section provides suggested solutions for common errors that you can encounter while using Reports & Dashboards. ### No Data Right after Setup **Potential Cause:** You configured Reports & Dashboards less than 24 hours ago. **Suggested Solution:** Wait at least 24 hours after completing the [configuration](#configure-reports--dashboards) before you check your Reports & Dashboards. ### Inaccurate or Missing Data 24 hours After Configuration **Potential Cause:** The prerequisites weren’t met or Reports & Dashboards configuration is incorrect. **Suggested Solution:** View Einstein Activity API Calls for your site by using the Network tab in DevTools. Optionally, you can also install the [B2C Commerce Recommendation Validator](https://chrome.google.com/webstore/detail/commerce-cloud-recommenda/dobmbolmcejainkefklnpkjbaibgjihn) Chrome addon. These fields appear in the B2C Commerce Recommendation Validator. - **Realm:** If this field is empty, Reports & Dashboards doesn’t know which realm the data comes from. Ensure that your user role in Account Manager has the scopes of the permission set to the environments in your realm. Confirm that you have the Reports and Dashboards user role in Account Manager with the scopes of the permission set to the environments in your realm. See the [Prerequisites](#prerequisites). - **instanceType:** If this field isn’t set to `prd`, your data doesn't appear. Set the `isProduction` property to `true` so that `instanceType` is set to `prd`. See [Configure Reports & Dashboards](#configure-reports--dashboards). ### PWA Kit Only: No Data in Reports & Dashboards after Correct Configuration **Potential Cause:** Adblockers stop requests to the Einstein Activities API. **Suggested Solution:** 1. Set up a proxy in [Runtime Admin](https://runtime.commercecloud.com/) as described in [Configure Managed Runtime Environments](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/proxying-requests.html#configure-managed-runtime-environments). - Use the path `mobify/proxy/einstein`. - Direct all Einstein requests through that proxy by adding the Einstein API host as `api.cquotient.com`. 2. Setting up a proxy can prevent data from appearing in Reports & Dashboards. That’s because proxy requests previously replaced the User-Agent header with `Amazon Cloudfront`, causing all user agent request strings to appear in Reports & Dashboards as robots instead of real shoppers. As of June 8, 2026, the Managed Runtime proxy preserves the original User-Agent header. This workaround is only needed for storefronts deployed before that date. See [Request and Response Modifications](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/proxying-requests.md#request-and-response-modifications). To avoid this issue on older deployments, update the Einstein API code in your PWA Kit project to send `clientUserAgent = navigator.userAgent` in the Einstein request. In your project, go to `/template-retail-react-app/app/hooks/use-einstein.js` and add this code. ```jsx if (this.isProduction) { body.instanceType = instanceType_prd } else { body.instanceType = instanceType_sbx } // This is included in the Einstein request. body.clientUserAgent = navigator.userAgent return body ``` **note:** Setting up a proxy can slow down your site performance. ## See Also - Salesforce _Help_: [Reports & Dashboards](https://help.salesforce.com/s/articleView?id=cc.b2c_reports_and_dashboards.htm&type=5) - [Data and Analytics](https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/data-and-analytics.md)