Skip to main content

Integration: A/B Treatments

When you’re running your own A/B test, it’s important that the RichRelevance system knows what treatment a user is in. Setting the A/B treatment allows the RichRelevance code to stay the same across both treatments. It also gives RichRelevance the ability to verify proper split, verify users are not swapping treatments, and monitor the test as it progresses.

The treatment is typically set to “a” or “b.” RichRelevance needs to know what treatment will be showing RichRelevance recs. We configure the non-RichRelevance display side to not return or display RichRelevance recs.

JavaScript Integration

How To Make This Code Work For You

  1. Create the integration code on each of the pages on your site, following the HTML integration and JSON integration guides.
  2. Add this function to your integration code:
Function Requirement
R3_COMMON.setMVTForcedTreatment(‘A_OR_B’); Replace A_OR_B with identifiers for the treatment the current user is in. You need to work with your RichRelevance team to choose treatment names. (Usually they’re simply A and B.)

Sample Code

Call setMVTForcedTreatment() in the Primary Code Block.


<!-- Place this code inside the <body> element as close to the top as possible -->
<script charset="utf-8" type="text/javascript">
  var R3_COMMON = new r3_common();
  R3_COMMON.setUserId('10987');  // if exists, set it; if not, set it as session ID
  // here's an example requesting recommendations for 1 page area
  var R3_HOME = new r3_home();


External A/B treatments are not supported via API.

  • Was this article helpful?