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
  • How will a promotion be applied to shoppers associated with a targeted segment?
  • Can you segment guests where customer_id=0?
  • How many segments are supported?
  • What’s the difference between customer segments and customer groups?
  • Resources
  • Articles
  • Endpoints
DocsAdminCustomersCustomer Segmentation

FAQ

Was this page helpful?
Previous

Definitions and Relationships

Next

Store configuration

Built with

How will a promotion be applied to shoppers associated with a targeted segment?

For a promotion to apply, you must assign a customer to the targeted segment, and they must sign in to the subject storefront.

For automatic promotions, the discount automatically applies itself to the cart of each eligible signed-in customer. For coupon promotions, the signed-in customer must enter a valid coupon code associated with the promotion during checkout.

Can you segment guests where customer_id=0?

Not currently. This version of the Customer Segmentation API doesn’t support segmenting guest shoppers; only registered customers can be assigned to segments.

How many segments are supported?

We currently support up to 1000 segments per store.

What’s the difference between customer segments and customer groups?

Customer groups allow you to group shoppers based on more permanent characteristics, like tax zones or shopper consent to collect GDPR-compliant data. A registered customer can only belong to one group at a time.

Customer segments provide greater flexibility. They leverage both the permanent and transient characteristics of a shopper to drive highly personalized shopping experiences. A shopper profile can belong to multiple segments.

Resources

Articles

  • Customer Segmentation API Overview
  • Customer Segmentation API Guide
  • Definitions and Logical Relationships
  • Promotions API

Endpoints

  • Customer Segmentation V3 API Reference