Browser ID
The browser ID is a universally unique identifier (UUID) that Sitecore Personalize assigns to every user of your app. It associates sessions, events, and orders with the respective user.
The browser ID in integrations using the Engage SDK
The Engage SDK automatically creates the browser ID. Then, the web browser stores the browser ID as a first-party cookie. The cookie is persisted until it expires or gets deleted.
You can use the Engage.getBrowserId()
function to get the browser ID, then find data about the associated user in Sitecore Personalize.
When you send events, the Engage SDK automatically includes the browser ID in the event data object.
When you run experiences and experiments without including any optional guest identifier attributes in the personalization data object, the Engage SDK automatically includes the browser ID in the personalization data object.
The browser ID in integrations using direct HTTP requests
You have to manually request a browser ID first. To do this, you make a GET request to the Browser API (Stream API type). The response includes the browser ID. In every event that you send to Sitecore Personalize, you have to manually include the browser ID.
The browser ID in Sitecore Personalize
If you know the browser ID for a user of your app, you can use the browser ID to find data about the user in Sitecore Personalize.