BigCommerce Integration Guide

Flexsee connects to BigCommerce via OAuth, imports catalog and order data, and can install the Flexsee storefront tracking script for behavioral events.

1. Connect your store

1. In the Flexsee dashboard go to Integrations → Data sources → BigCommerce.
2. Select Connect to BigCommerce and install the Flexsee app in your BigCommerce admin.
3. After authorization you return to the Flexsee app inside BigCommerce (or the dashboard integration page).

2. Complete setup

1. Review Connection details (store name and URL).
2. Leave Automatically add Flexsee onsite javascript enabled unless you plan to install the script manually.
3. Select Complete setup to start the historical import (products, customers, and orders).

Progress appears under Historical data with a sync bar and counts. Use Restart import to run a fresh sync later.

Storefront tracking

When onsite tracking is enabled during setup, Flexsee installs a Script Manager snippet that loads:

• flexsee-tracking-bigcommerce.js — Flexsee's storefront tracker
• A small inline config block with your organization and store identifiers

The script sends batched events to Flexsee. When BigCommerce's data layer (BODL) is enabled on the storefront, Flexsee also subscribes to native cart, checkout, and product events for richer payloads.

Events captured

Event	When
page_viewed	Every storefront page
product_viewed	Product detail pages (BCData, BODL, or theme data attributes)
collection_viewed	Category, collection, or brand pages
search_submitted	Search form, quick search, or search results page
search_result_clicked	Product click in search / quick-search results
cart_viewed	Cart page or BODL cart view
add_to_cart	Add-to-cart form, BODL, or Storefront Cart API
remove_from_cart	Cart remove actions
cart_updated	After cart add/remove/quantity changes
wishlist_added	Wishlist form submit or button click
product_variant_selected	Variant change via Stencil utils (optional theme hook)
promotion_viewed	Banner viewed (BODL)
consent_updated	Cookie consent loaded or updated (BODL)
checkout_started	Checkout entry
checkout_contact_info_submitted	Checkout email captured (DOM or BODL)
checkout_shipping_info_submitted	Shipping step (BODL)
checkout_address_info_submitted	Shipping / address step (BODL)
payment_info_submitted	Payment step (BODL)
checkout_completed	Order confirmation / BODL purchase
customer_identified	Logged-in shopper or checkout email

Optional Stencil utils bridge

Cornerstone and other Stencil themes can expose richer hooks if the theme assigns stencil-utils globally. Add this once in theme JavaScript (after importing @bigcommerce/stencil-utils):

import utils from '@bigcommerce/stencil-utils';
window.stencilUtils = utils;
// or after Flexsee loads:
window.flexsee.bindStencilUtils(utils);

Flexsee listens for cart quantity updates, quick search, and variant changes through that bridge.

Verify tracking is working

1. Open your storefront in a browser tab (not the BigCommerce admin).
2. Browse a few pages, including a product detail page if possible.
3. In Flexsee, confirm behavioral events are arriving for your organization (Events / model training flows).

Enable BODL (recommended)

For the richest event data on Stencil themes, enable BigCommerce Open Data Layer (BODL) in your store control panel. Flexsee automatically subscribes to BODL cart, checkout, and product events when present.

Manual installation (Script Manager)

If auto-install did not run (for example missing OAuth scope), add the script yourself:

1. In BigCommerce admin go to Storefront → Script Manager.
2. Create a script:
   • Location: Footer
   • Pages: All pages
   • Script type: Script
3. Paste the snippet shown on the Flexsee BigCommerce integration page, or use this pattern:

<script>
  window.flexseeTrackingConfig = {
    orgId: "YOUR_FLEXSEE_ORG_ID",
    storeHash: "YOUR_STORE_HASH",
    storeId: YOUR_FLEXSEE_STORE_ID,
    storeUrl: "https://your-store.example.com",
    ingestBatchUrl: "https://api.flexsee.ai/ingest/events/batch",
    enableConsoleLogging: false
  };
</script>
<script src="https://dashboard.flexsee.ai/scripts/flexsee-tracking-bigcommerce.js" async></script>

Use https://api.staging.flexsee.ai and https://dashboard.staging.flexsee.ai on staging.

Viewed product tracking

The default Flexsee script emits product_viewed when BigCommerce exposes product context (BCData.product_attributes on Stencil themes, or data-product-id on the page).

For custom Stencil themes or headless storefronts, add product identifiers to your product template so the script can read them. Example Stencil data attributes:

<div data-product-id="{{product.id}}" data-product-title="{{product.title}}">

For advanced theme hooks and headless SDK usage, contact Flexsee support or extend flexsee.track('product_viewed', { ... }) from your theme JavaScript.

Troubleshooting

Issue	What to check
Stuck on Finish setup	Open the Flexsee app in BigCommerce admin and click Complete setup.
Historical import at 0%	Confirm API credentials in BigCommerce app settings; retry Restart import.
No storefront events	Confirm Script Manager script is present; browse the live storefront (not admin).
Partial sync warning	Customers or orders may need additional BigCommerce OAuth scopes on the app.

Disconnect

Disconnect from Flexsee in the integration page, then uninstall the app under Apps → My Apps in BigCommerce admin.