User Cohorts

Configure brand visibility and discounts at cohort level for different user segments.

The Hubble SDK supports user cohort-based configurations, allowing you to customize brand visibility and discount rates for different customer segments. This powerful feature enables you to create personalized experiences based on user groups such as premium members, VIP customers, or regional segments.

What are User Cohorts?

User cohorts are logical groupings of users that share common characteristics. Each cohort can have its own configuration for:

Brand Visibility: Control which brands are available to specific cohorts
Discount Percentages: Set custom discount rates for different brands within each cohort

How It Works

1. SSO Integration

Your SSO API must return the user’s cohort information when authenticating with Hubble. The cohort identifier should be included in the SSO response:

{
  "success": true,
  "user": {
    "id": "xxx",
    "name": "Shiv Sagar",
    "phoneNumber": "9405552313",
    "cohort": "premium-customers"
  }
}

See the SSO Integration guide for more details on implementing SSO.

2. Cohort Configuration

Once the user’s cohort is identified, Hubble will apply the appropriate brand visibility and discount configuration for that cohort.

Managing Cohort Configurations

There are two ways to manage cohort configurations:

Option 1: Hubble Team Management

Contact your Hubble integration team to set up and manage cohort configurations on your behalf.

Option 2: Self-Service via API

You can manage cohort configurations programmatically using the Partner Cohort Configuration API. This gives you full control to:

Create new cohorts
Update existing cohort configurations
View all your cohort settings
Adjust discount percentages for specific brands

Use Cases

Premium Customer Tier

Create a “premium” cohort with higher discounts across popular brands to reward loyal customers.

Regional Segments

Configure different brand availability and pricing for customers in different geographic regions.

Corporate Partnerships

Set up specialized cohorts for corporate partners with negotiated discount rates.

Promotional Campaigns

Temporarily adjust discounts for specific user segments during promotional periods.

Next Steps

Set up your SSO Integration to return user cohort information
Learn how to manage cohorts using the Cohort Configuration API
Contact your Hubble integration team for assistance with cohort setup