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
  • Introduction
  • Exclusive enterprise feature
  • Segments and shopper profiles
  • Resources
  • Articles
  • Endpoints
DocsAdminCustomersCustomer Segmentation

Customer Segmentation API Overview

Was this page helpful?
Previous

Creating channel-specific customers

Next

User Guide

Built with
  • Create manual segments with the API - leverage externally-defined customer segments using third-party tools and quickly transfer this data into and out of BigCommerce.
  • Add a shopper to multiple segments - shoppers, or registered customers, can belong to up to 1000 segments, meaning you can target a registered customer with multiple promotional experiences.
  • Use segments with the Promotions API - apply a promotion to target multiple segments of shoppers, and exclude shoppers within a segment from receiving this promotion.

Introduction

A customer segment is a collection of shoppers that share specific characteristics. Segmentation defines groups of shoppers that a merchant wants to target with a Promotion, or dedicated value proposition.

As a BigCommerce merchant, agency, and/or tech partner needing to improve a merchant store’s personalization strategy, the Customer Segmentation API enables the creation of externally defined segments that you can target within a promotion.

Manual segments created with the Segmentation API will be visible within the Promotions standard editor control panel UI Targeting section.

Promotion targeting segment.png

For participants using the Promotions API, manual segments created with the Segmentation API will also be available to be targeted within the Promotions API.

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.

Segments and shopper profiles

This API introduces two new objects that are both high-level entities with a many-to-many relationship: segments and shopper profiles.

Screen Shot 2021-08-06 at 3.50.00 pm.png

Resources

Articles

  • Customer Segmentation API Guide
  • Definitions and Logical Relationships
  • Promotions API
  • Promotions standard editor (Support Center)

Endpoints

  • Customer Segmentation V3 API Reference Overview