For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dev Portal
DocsAPI ReferenceLearnCommunityChangelog
DocsAPI ReferenceLearnCommunityChangelog
  • Overview
    • Quick Start
    • Sandboxes
    • Tools & SDKs
    • Support
  • Docs
      • Getting Started
        • Customers and Subscribers
        • Creating channel-specific customers
          • Overview
          • User Guide
          • Promotions API
          • Definitions and Relationships
          • FAQs
    • Archive
    • Closed Beta Programs
Dev Portal
LogoLogo
On this page
  • Exclusive enterprise feature
  • Segment
  • Manual segment
  • Shopper profile
  • Customer
  • Guest
  • Promotion
  • Summary of entity relationships
  • Many-to-many
  • One-to-one
  • Other entity relationships
  • Resources
  • Articles
  • Customer Segmentation reference
DocsAdminCustomersCustomer Segmentation

Definitions and Logical Relationships

Was this page helpful?
Previous

Promotions API

Next

FAQs

Built with

Exclusive enterprise feature

The Customer Segmentation API is available to enterprise customers. If you would like to become an enterprise customer, please contact your BigCommerce Customer Service Manager or our support team.

Segment

An entity that classifies shoppers into groups or buckets, referred to as segments.

Manual segment

A collection of shoppers that a merchant or application has grouped together using the API. Manual segments are not a distinct entity in our API; they are a subset of segments.

Shopper profile

An entity that represents a registered customer. Current plans for future releases include supporting shopper profiles for guest customers.

Customer

An existing entity that represents a shopper who is registered with the store. In the Customer Segmentation API documentation, assume that customers are signed in to the subject storefront. For more on the customer entity, see the public Customers API reference.

Guest

A shopper who is not signed in to the subject storefront.

A guest may or may not be a registered customer, but because they are not signed in, your application doesn’t know their registration status.

Promotion

A way to give discounts based on whether the shopper meets specific criteria, such as ordering a certain amount, purchasing certain brands, being a repeat customer, or being associated with a shopper profile that belongs to a segment.

For more on using promotions with segments, see Targeting a segment with a promotion. For more on the promotion entity, see the Promotions documentation.

Summary of entity relationships

Many-to-many

  • Segments and shopper profiles
  • Segments and promotions

One-to-one

  • Shopper profiles and customers

Other entity relationships

Relationships that don’t currently involve the Customer Segmentation API:

  • Many-to-many: guests and promotions

Relationships that don’t yet exist:

  • Shopper profiles and guests

Resources

Articles

  • Customer Segmentation API Overview
  • Customer Segmentation API Guide
  • Promotions and Customer Segmentation
  • Promotions API documentation

Customer Segmentation reference

  • Customer Segmentation V3 API Reference Overview
  • Create segments
  • Create shopper profiles
  • Add shopper profiles to a segment
  • Update Segments
  • Remove shopper profiles from a segment
  • Delete segments
  • Get all shopper profiles in a segment
  • Get all segments for a shopper profile