bart/ab

A/B testing tool for Laravel apps

Laravel A/B Testing

AB is a server-side A/B testing tool for Laravel applications and provides a pretty simple feature set that is a great free alternative to services like Optimizely. It allows you to experiment with different variations of your website while test selection will be handled automatically., _(*1)

Installation

Install using composer:, _(*2)

composer require bart/ab

Add the service provider to app/config/app.php:, _(*3)

Bart\Ab\ServiceProvider::class,

Register the AB alias:, _(*4)

'AB' => Bart\Ab\Facade::class,

Configuration

Publish the included configuration file like this:, _(*5)

php artisan vendor:publish --provider="Bart\Ab\ServiceProvider"

Next, edit the config/packages/bart/ab/config.php file. The following configuration options are available:, _(*6)

Enabled

Enables or disbales the A/B testing., _(*7)

'enabled' => true

Default

If A/B testing is disbaled, AB::getCurrentTest() will return this., _(*8)

'default' => 'none'

Tests

An array of test identifiers with an assigned level of distibution., _(*9)

'tests' => [
    'teaser1' => 1,
    'teaser2' => 2,
    'teaser3' => 1,
]

The above (default) configuration will display teaser version 2 to 50% of your users, whereas version 1 and 3 will be displayed to 25% of your users each., _(*10)

Usage

After you have defined your tests and enabled testing in the config you can start designing your A/B tests. It's as easy as 1-2-3 because the only thing you need to do is displaying a different peace of content for each test. Let's assume you have defined the tests from above, your view could look like this:, _(*11)

@test('teaser1')
    Teaser 1 is being displayed
@endtest

@test('teaser2')
    Teaser 2 is being displayed
@endtest

@test('teaser3')
    Teaser 3 is being displayed
@endtest

Tracking

This package doesn't handle any goal or conversion tracking because every company is approaching this in a slightly different way. We would suggest to use a custom Google Analytics dimension and pass the assigned test version in your master view:, _(*12)

dataLayer.push({'version': '{{ AB::getCurrentTest() }}'});

Contribution and questions

If you have any questions or suggestions please feel free to ask or create megre request. Happy testing!, _(*13)