Skip to main content
Users
CloudPortalLogin
  • Powered byPowered by
Introduction to Sitecore Personalize
Managing accounts and system settings
Identifying guests
Introduction to experiments
Introduction to experiences
Decisioning
View dashboards
Developer Center
Connecting to an external system
Using client-side JavaScript
Using server-side JavaScript
AI in Personalize
Glossary
  • Sitecore Personalize
  • Introduction to experiences
  • Introduction to experience goals
  • Add a custom conversion rate goal to an experience in Sitecore Personalize

Add a custom conversion rate goal to an experience in Sitecore Personalize

You can add a custom conversion rate goal to an experience to measure the conversion performance from a custom event. For a conversion to occur, the custom event you define must be triggered during the session.

For example, you can create an experience in Sitecore Personalize and create a goal to monitor conversions when a custom ADD_TO_FAVORITES event occurs. Additionally, you can specify a goal target, quantifying the conversion percentage you are hoping to achieve with the experience.

We recommend that you do not add more than one goal with the same event to an experience. For example, if you create two goals that both use the ADD_TO_FAVORITES event, Sitecore Personalize only counts the first goal and ignores the second goal.

Warning

The Personalize API is what developers use to run interactive experiences. If you add a custom conversion rate goal to an interactive experience, ensure that your organization uses the browserId attribute when calling the Personalize API. This ensures that the goal is attributed to the correct browser session and the attribution rate is accurate when viewing performance analytics.

To add a custom conversion rate goal:

  1. In the experience builder, click the Goals tile and click Add Goals.

  2. In the Goals pane, click Custom goal.

  3. In the Custom goal pane, in the Goal name field, enter a descriptive name for the goal. This name will display on the Performance screen.

    Adding a custom conversion rate goal to an experience in Sitecore Personalize.
  4. In the Goal definition section, do the following:

    • In the first drop-down list, select Increase or Decrease to set whether a higher or lower conversion is considered a successful outcome.

    • In the second drop-down list, select Conversion rate to choose conversion measurements.

    • In the third drop-down list, select one of the following options to measure the conversion:

      •  Per session – calculates the conversion rate per session of the experience. This is done by dividing the number of converted sessions in the experience by the total number of sessions in the experience.

      •  Per guest – calculates the guest conversion rate of the experience. This is done by dividing the number of converted guests in the experience by the total number of guests that were exposed to the experience. If the same guest has multiple converted sessions within the experience, the average conversion rate shows the average as it applies across unique guests in the experience.

  5. In the Goal target field, enter the conversion rate you want to achieve. For example, if you set a target of 20%, this means the experience will meet the goal when there are two out of ten conversions from the tracked event.

    Note

    Adding a Goal target does not affect any calculations. This value will be displayed as a baseline metric on the Performance screen, designed to help you compare the actual conversion rate against your targeted goal.

  6. In the Track event section, select one of the following operators to track the custom event:

    • Equals - matches the event name you enter in the text field exactly with the type parameter from the custom event.

      Example: If you entered ADD_BAG in the adjacent text field, this option will only track the event with a parameter that exactly matches this string.

    • Regex - matches the type parameter from the custom event using a Regular Expression (RegEx) pattern. The RegEx should result in a full match of the event name, not a partial match.

      Example: If your type parameter is ADD_BAG, using the RegEx pattern [a-zA-Z] will not match the full string but only one of its letters, like A. However, if you used the pattern [a-zA-Z]+, it will match the entire string and be able to track that event.

    • Starts with - matches the beginning of the type parameter from the custom event with a specific string.

      Example: If you entered ADD_BAG in the adjacent text field, this option will track any event with a parameter that begins with ADD_BAG such as ADD_BAG or ADD_BAG_DISCOUNTED.

  7. In the adjacent text field, enter the full or partial name, or RegEx pattern of the custom event you want to track. This corresponds to the type parameter from the custom event.

    Warning

    You must enter the exact event name, attribute name, and attribute value that your organization passes to the Sitecore Personalize platform, for accurate tracking and goal calculation.

  8. Optionally, to refine event tracking, you can use additional custom attributes included in the ext object of the custom event.

    To do this, click Add Attribute and specify the following:

    • Attribute Name - enter the name of the custom attribute. For example, bagConverted.

    • Operator - select either String Equals or String Not Equals to choose how the attribute value should be matched.

    • Attribute value - enter the required string value of the custom attribute to consider the event successful. For example, when the string equals true.

    To add more attributes, click Add attributes and enter the necessary details. Multiple attributes are evaluated using the AND logic.

  9. Optionally, to add more details about the goal, click Description.

  10. Sitecore Personalize automatically creates a Friendly ID as you enter a Goal name. You can use this ID to refer to the goal when integrating.

    To edit the ID, click and enter the new ID for the goal.

    Note

    When editing, use a-z, 0-9, and underscores for spaces.

  11. Click Save. The goal is added to the Goals tile.

Custom conversion rate goal snapshot

  • What it tracks - the percentage of users or sessions that result in a conversion of a custom event, such as a form submission, button click, or any other user-defined event.

  • Conversion - occurs when the user successfully triggers the custom event during their session.

  • Attribution - identifies and credits the experience that contributed to triggering the custom event.

  • Multi-touch example - if a user interacts with a personalized homepage, then navigates to a product category page, and finally submits a form (the custom event), each touchpoint is credited for contributing to the conversion of the goal.

Next steps

  • Start the experience for personalization to take effect.

  • View the analytics. After starting the experience, you can immediately see operational data. Within 24 hours, you’ll see the goal target as a baseline on the Performance screen. This lets you easily identify whether the experience has reached its target.

Do you have some feedback for us?

If you have suggestions for improving this article,

Privacy policySitecore Trust CenterCopyright © 1999-2026 Sitecore