Skip to main content
Users
CloudPortalLogin
  • Powered byPowered by
Developing with Sitecore CDP
Data privacy
Before you start sending data
Integrating with Sitecore CDP
Stream API
Batch API
REST APIs
Data lake export service
  • Sitecore CDP for developers
  • Stream API
  • Boxever JavaScript Library (legacy) reference
  • Functions
  • Boxever.getBucketNumber([callback])

Boxever.getBucketNumber([callback])

The getBucketNumber() function updates the bucket number cookie in the browser to match the latest bucket number in Sitecore CDP. Call this function after an IDENTITY event triggers. This updates the cookie in the browser to match the bucket number in Sitecore CDP.

Note

This function is specific to Web Experiences and Web Experiments in Sitecore Personalize, and it is only available if you specified web_flow_target when you integrated with Sitecore CDP using the Boxever JavaScript Library.

Parameters

Parameter

Type

Description

Note

[callback]

optional

function

This callback function handles the response.

N/A

Return value

undefined

Example

This example describes how to test that the getBucketNumber() function updates the bucket number cookie in the browser.

First, you get the latest bucket number from Sitecore CDP using the getBucketNumber() function and log the bucket number cookie to the console using the getCookie() function.

RequestResponse
Boxever.getBucketNumber(() => console.log(Boxever.getCookie("bx_bucket_number")));
// 49

Then, you call the reset() function to reset the guest reference:

RequestResponse
Boxever.reset();

Sitecore CDP creates a new guest reference and assigns a bucket number to this guest. But the bucket number cookie in the browser stays unchanged.

To update the cookie in the browser, you get the latest bucket number from Sitecore CDP again using the getBucketNumber() function. Then, you log the bucket number cookie to the console using the getCookie() function:

RequestResponse
Boxever.getBucketNumber(() => console.log(Boxever.getCookie("bx_bucket_number")));
// 21

The bucket number cookie is now different.

Do you have some feedback for us?

If you have suggestions for improving this article,

Privacy policySitecore Trust CenterCopyright © 1999-2025 Sitecore