This guide introduces the core concepts used in Personalize. It provides definitions and context to help you understand how experiences, audiences, variants, attributes, and events work together to deliver personalization.
An Experience is the top-level configuration where you define variants, target them to audiences, and set traffic distribution rules for A/B testing. Each experience represents a personalization setup applied to your digital property.
Experiences help you deliver content to specific audience segments through conditions you define. They support audience segmentation, experimentation, and targeted delivery.
Types of Experiences:
Personalize supports two types of experiences:
Segmented Experiences enable you to deliver precisely targeted, personalized content to specific audience groups. By dynamically showcasing tailored content variations based on demographics, referral sources, behaviors, and other key attributes, you can:
Example:
A "New Visitors" segment might see a welcome banner.
A "Returning Customers" segment is shown a loyalty offer.
Variant Prioritization resolves conflicts when a user satisfies conditions for multiple variants. It ensures the most relevant variant takes precedence by defining a hierarchy.
For an experience, only one variant is deemed active at a time. If match conditions for multiple variants are met, the first variant in the prioritized order for which the conditions are met will be considered as active.
Example: Imagine an experience targeting a hero banner.
A visitor who is both a VIP and located in the UK qualifies for both variants. By prioritizing “VIP Customers” above “UK Visitors,” the user sees the VIP version.
Additional Resource: For more information, refer to Create a Segmented Experience.
An A/B test experience is a controlled experiment that allows you to present two or more content variants of a webpage or app to different user groups simultaneously, helping you evaluate which version performs best.
In Contentstack Personalize, A/B Testing enables data-driven decision-making and helps you optimize content strategy by testing and comparing multiple content variations.
Through these experiments, you can:
In an A/B test, you can control how traffic is split among different variants. You can choose to split the traffic equally among all variants or set a custom distribution to direct a larger percentage of users to a specific variant, or automatically adjust traffic distribution over time based on real-time conversion performance.
Equally Split: This is standard for a fair A/B test to see which variant performs best with an equal audience size.
Custom Split: This is useful for "soft launching" a new design. You can show a radically new homepage design (20% variant) to a small subset of your traffic to gather data and feedback without risking a negative impact on the majority of your users (80% control).
Multi-Armed Bandit: Multi-Armed Bandit is an adaptive traffic optimization strategy available for A/B Test experiences in Contentstack Personalize.
Unlike traditional A/B testing, where traffic distribution remains fixed for the duration of the test, Multi-Armed Bandit dynamically adjusts how traffic is allocated across variants based on real-time conversion performance.
With Multi-Armed Bandit:
This approach allows you to optimize for conversions while the experiment is running, instead of waiting until the test completes.
Note: Multi-Armed Bandit does not change how A/B tests end or how winners are determined. Test duration and winner declaration follow the same rules as standard A/B Test experiences.
Additional Resource: For more information, refer to Create an A/B Test Experience.
Impressions track how often personalized content is displayed to users.
Each time a user encounters personalized content, it can be recorded as a single unique impression. Note that because Personalize records only unique impressions, even if the same user views that content multiple times, it is only counted once.
Tracking impressions helps you determine how effectively your personalized content is reaching its audience.
Example: If two different sale banners are shown to users in different locations, impressions reveal how often each banner is viewed, helping you measure visibility and engagement.
A conversion represents a meaningful user action (event), such as adding an item to the cart, completing a purchase, or reaching the end of a page.
These events serve as metrics to evaluate variant performance. When a visitor completes an action, metrics track unique conversions per user.
In A/B Test experiences, conversions help identify which variant performs better, with a higher number of conversions.
Example: Testing two “Buy Now” buttons can show which design generates more clicks.
When multiple experiences are active on a page, layering and prioritization of experiences ensure optimal personalization for your users as it helps reflect the whole visitor context on the content.
Personalize and the CMS automatically layer these experiences, optimizing each section based on the respective active variant.
Personalize uses the experience prioritization order defined by you, so the variant from the higher-priority experience is displayed. You can adjust the order of experiences in Personalize to control which content is shown when multiple experiences are active.
Audiences are groups of users who share attributes, behaviors, or contextual characteristics. They determine who qualifies to see particular variants.
Personalize supports two audience types:
Audiences help you deliver relevant content and tailor personalization based on user context.
Audiences help deliver relevant content to users who share similar attributes or behavior. Using audiences, you can tailor experiences to user context, optimize content delivery, and improve the effectiveness of personalization strategies.
Roles of Audiences in Personalize
Audiences are needed in Personalize in order to target Experience Variants to segments of your visitors, in order to:
Data & Insights (Lytics) audiences are created using unified customer data from multiple systems. They allow you to target users based on their full behavioral history and lifecycle stage.
Data & Insights (Lytics) Support:
1. Unified customer profiles: Consolidate CRM, email, mobile, and web data into a single profile. This creates a single, rich profile for each user, allowing you to personalize website content based on their entire relationship with your brand, not just their current web session.
2. Advanced segmentation: Build audiences based on behavioral patterns, affinities, or predictive indicators. You can create dynamic segments like "frequent buyers," "users at risk of churn," or "users likely to convert," allowing you to target users with incredible relevancy.
3. Lifecycle targeting: Deliver personalization aligned with user stages such as acquisition, engagement, or retention. This allows you to move beyond one-off promotions and guide users through a cohesive journey with your brand.
4. Audience analytics: Data & Insights (Lytics) audiences are not ephemeral (unlike Personalize Audiences, which are only used to determine active variants in real-time). They are processed and maintained for you to view, analyze and use to make informed decisions.
Personalize audiences are evaluated at the edge and are designed for first-page personalization, where speed and contextual accuracy matter most. Their evaluated memberships are ephemeral and not stored by Personalize. Thus, no analytics is available for Personalize Audiences.
Personalize Audiences Support:
Attributes are key-value pairs that define the characteristics, behaviors, or preferences of users interacting with your website or application. They form the foundation for building audience segments that enable targeted content delivery and personalized experiences.
Attributes can be applied across various use cases, including:
By combining preset (contextual) and custom attributes (defined by the user), you can create highly detailed audience segments and serve content that feels personally relevant, driving greater engagement, higher conversions, and improved customer satisfaction.
Events allow you to capture and track every interaction a user has with your website or application. In Contentstack Personalize, events play a vital role in evaluating the performance of your A/B tests.
By recording key user actions, such as clicks, form submissions, or video plays, as events, you can accurately assess which content variant delivers better results.
Contentstack Personalize supports tracking two primary types of user interaction events:
These metrics together provide a clear picture of how users engage with your personalized experiences and which variations drive the most impact.
In Contentstack CMS, Variants are alternative versions of content created to engage specific audience segments. Each experience you build within a Personalize project appears in the CMS as a Variant Group named after that experience, allowing you to create and manage individual entry variants directly from the Entry Editor.
Variant Groups and Variants are automatically created and synced for you based on the Experiences and Variants you define in Personalize, given that the Personalize Project is connected with the specific CMS Stack. Once created, you can create entry variants by making changes to the content you want to be personalized. The entry editor will display content from the base entry by default. You can enter or edit content in the fields as per the variant you want the content to be personalized for.
By creating and managing variants, you can:
By connecting user attributes, unified and real-time audiences, experience rules, and measurable events, these concepts create a complete and adaptable personalization model. This foundation helps you deliver more relevant content today while continuously refining your strategies as user behavior evolves.