Add experiments allocation function to RoktManager

[patrick-wu]

Summary

• Adding setExperimentAllocationData to the RoktManager for clients to save experiment allocation data
• data will be passed down to the Rokt Kit during select placement call with specific attribute keys

Testing Plan

• TODO: Write unit tests for the new function

Reference Issue (For mParticle employees only. Ignore if you are an outside contributor)

• Closes https://go.mparticle.com/work/REPLACEME

[alexs-mparticle]

You should put this in the try/catch block below. The queuing logic should be the first thing in this function because it runs before the rokt web sdk and kit initialize.

[Copilot]

Pull Request Overview

This PR adds the experiment allocation functionality to the RoktManager, enabling clients to pass experiment allocation data to the Rokt Kit during placement selection.

• Introduces the IRoktExperimentAllocation interface.
• Adds the experimentAllocation property and updates selectPlacements to include experiment allocation attributes if available.
• Implements the setExperimentAllocationData function for setting experiment allocation data.

[Copilot]

[nitpick] Consider adding a JSDoc comment above setExperimentAllocationData to clarify its purpose, input parameters, and usage.

Suggested change

	/**
	* Sets the experiment allocation data for a user.
	*
	* @param {string} userId - The unique identifier for the user.
	* @param {string} experimentId - The unique identifier for the experiment.
	* @param {string} bucketId - The unique identifier for the bucket within the experiment.
	*
	* This method stores the provided experiment allocation data in the `experimentAllocation` object.
	*/

[alexs-mparticle]

Another useful suggestion and something we should be doing more often. Not a blocker.

[Copilot]

Consider extracting the hard-coded attribute keys ('rokt.experimentid', 'rokt.bucketid', 'rokt.userid') to constants to improve maintainability and reduce potential typos.

Suggested change

	mappedAttributes['rokt.experimentid'] = this.experimentAllocation.experimentId;
	mappedAttributes['rokt.bucketid'] = this.experimentAllocation.bucketId;
	mappedAttributes['rokt.userid'] = this.experimentAllocation.userId;
	mappedAttributes[ROKT_EXPERIMENT_ID] = this.experimentAllocation.experimentId;
	mappedAttributes[ROKT_BUCKET_ID] = this.experimentAllocation.bucketId;
	mappedAttributes[ROKT_USER_ID] = this.experimentAllocation.userId;

[alexs-mparticle]

I think this is a useful suggestion but not a blocker.

[alexs-mparticle]

Suggested change

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud