@truebill/ab-testing

A/B testing made easy.

Usage no npm install needed!

<script type="module">
  import truebillAbTesting from 'https://cdn.skypack.dev/@truebill/ab-testing';
</script>

README

ab-testing

Build Status Latest Stable Version License

A/B testing made easy.

Install

npm install ab-testing

Initialize

var ABTesting = require('ab-testing');

var testObject = ABTesting.createTest('firstTest', 	// This name has to be unique across all the tests
[
    {
        name: 'A',
        weight: 0.1 	// If not set, the default value is 0.5
    },
    {
        name: 'B',
        weight: 0.9
    }
]);

Assign a group

// Given a unique ID of the user, returns 'A' or 'B'
var testGroup = testObject.getGroup(user.id);

Get test name

// Returns the name of the test, in this case 'firstTest'
var testName = testObject.getName();

A/B Test

// Executes the corresponding function for the given group
testObject.test(testGroup, [
    function () {
        // Test A code here
    },
    function() {
        // Test B code here
    }
], this);

Useful usage tips

// Use the test name and the group name to track analytics
sendToAnalytics(testName, testGroup);

Create multiple A/B tests

var ABTesting = require('ab-testing');

var landingPageTest = ABTesting.createTest('landingPage', [{ name: 'oldLandingPage' }, { name: 'newLandingPage' }]);
var pricingPageTest = ABTesting.createTest('pricingPage', [{ name: 'oldPricingPage' }, { name: 'newPricingPage' }]);

...

var landingPageGroup = pandingPageTest.getGroup(req.account.username);
var pricingPageGroup = pricingPageTest.getGroup(req.account.username);

...

landingPageTest.test(landingPageGroup, [
    function () {
        // oldLandingPage code
    },
    function () {
        // newLandingPage code
    }
], this);

pricingPageTest.test(pricingPageGroup, [
    function () {
        // oldPricingPage code
    },
    function () {
        // newPricingPage code
    }
], this);

NB: the last parameter this is optional. If the scope is not required, this paremeter can be ignored.