SDK migration from existing Engagement tracking

👍

Welcome note

Data hub is our new upgraded platform, which we rolled out in August 2025. It offers a single unified integration for passing your data through to your Bloomreach products.

You have access to Data hub if you've implemented with Bloomreach after August 2025.

Customers who have implemented before August 2025 should follow the existing documentation for Engagement, Discovery, and Clarity.

Intro

This guide instructs in the steps necessary to migrate an existing setup.

Migrating from existing Engagement tracking

If you are migrating from an existing Engagement project and your existing tracking is already using exponea, then you should create an exponea alias for the new brweb snippet.

Normally, weblayers in migrating projects are also configured to use exponea and you can use a backwards-compatible alias to allow the old code to function.

For backwards compatibility, create an alias for brweb early in your JavaScript code, insert it right after your snippet and before calling the start() method:

...
}); // new snippet ends here
window.exponea = brweb; // create alias for backwards compatibility
exponea.start();