laravel-ab - GitLite

KO | EN

gitlite — search

#python #ai #typescript #go #machine-learning #rust #deep-learning #linux #windows #vue #pytorch #mcp #ios #open-source

laravel-ab

(★ 289)

A server-side A/B testing tool for Laravel.

파일 탐색기

최종 버전 다운로드 (.zip)

- - ExportCommand.php
  - FlushCommand.php
  - InstallCommand.php
  - ReportCommand.php
- - config.php
- - AB.php
- - Experiment.php
  - Goal.php
- - CookieSession.php
  - LaravelSession.php
  - SessionInterface.php
- Tester.php
- TesterServiceProvider.php
- CommandTest.php
- GeneralTest.php
- SessionTest.php
- TestCase.php
.gitignore
.travis.yml
composer.json
phpunit.xml
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/jenssegers/laravel-ab

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd laravel-ab

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. PHP (Composer)

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
PHP PHP 실행 환경이 필요합니다.
Composer PHP 라이브러리 설치를 위한 패키지 매니저입니다.

composer require jenssegers/ab

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ php -S localhost:8000 같은 내장 서버로 실행한 뒤 브라우저에서 http://localhost:8000 으로 접속해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Laravel A/B Testing
===================

[![Build Status](http://img.shields.io/travis/jenssegers/laravel-ab.svg)](https://travis-ci.org/jenssegers/laravel-ab) [![Coverage Status](http://img.shields.io/coveralls/jenssegers/laravel-ab.svg)](https://coveralls.io/r/jenssegers/laravel-ab)

A server-side A/B testing tool for Laravel, a great free alternative for services such as optimizely. Use A/B testing to figure out which content works, and which doesn't.

This tool allows you to experiment with different variations of your website and tracks what the difference in engagement or reached goals is between them. Whenever you ask the A/B testing class for the current experiment, it will select the next experiment that has the least visits so that every experiment is tested equally. When there is an active experiment going on, it will start tracking engagement (click a different link, or submitting a form) and check if certain defined goals are reached. These goals are generally urls or routes, but can also be triggered manually.

Installation
------------

Install using composer:

composer require jenssegers/ab

Add the service provider in `app/config/app.php`:

'Jenssegers\AB\TesterServiceProvider',

Register the AB alias:

'AB'           => 'Jenssegers\AB\Facades\AB',

Configuration
-------------

Publish the included configuration file:

php artisan config:publish jenssegers/ab

Next, edit the `config/packages/jenssegers/ab/config.php` file. The following configuration options are available:

### Database Connection

This is your Laravel database connection that is used to store the A/B testing data. This is handy when you want to store the A/B testing data in a different database. When empty, it will use your default database connection.

'connection' => 'mysql',

### Experiments

These are your A/B experiments. These are unique identifiers that you can use in your code or views to decide which version you should be showing.

'experiments' => [
        'big-logo',
        'small-buttons',
        'short-form'
    ],

### Goals

Without goals, each experiment will track the number of visitors that saw the experiment and detect engagement. Additionally, you can define certain goals that you want to reach with your experiments. If, your main goal is for your visitors to buy your product or contact you for more information, and you have specific routes set up for both of these pages, your goals could look like this:

'goals' => [
        'pricing/order',
        'contact'
    ]

Your goals can be relative urls, named routes or can be triggered manually.

Preparing the A/B test database
-------------------------------

Once you have selected your database connection, use the included install command to prepare the required tables:

php artisan ab:install

The database structure is small and lightweight, so it will not impact your application.

Usage
-----

After you have defined your experiments and goals, you can start designing your A/B tests. All your visitors will be given the next experiment that has the least visits. You can request the current experiment identifier with the `AB::experiment()` method. For example, if you have defined the following experiments `['a', 'b', 'c']`, your view could look like this:

@if (AB::experiment('a'))
        <div class="logo-big"></div>

@elseif (AB::experiment('b'))
        <h1>Brand name</h1>

@elseif (AB::experiment('c'))
        <div class="logo-greyscale"></div>

@endif

Once the visitor is assigned to an experiment, his next clicks are automatically tracked to see if he is engaging with your website or completing certain goals. These goals are relative urls or named routes, and will be marked as completed when a visitor visits that url during an experiment.

**NOTE**: Visitors are only tracked if you are conducting an experiment. Only when you ask the current `AB::experiment()`, it will assign an experiment to that user using the current Laravel session.

### Adding new experiments

If you want to add new experiments, it may be best to clear the existing A/B testing data with this command:

php artisan ab:flush

If you don't flush your existing experimental data, all new visitors will see the new experiment first until it catches up with the pageviews of the old experiments.

Reports
-------

A/B testing reports are available through an artisan command:

php artisan ab:report

This will generate a simple output containing the results for each experiment and their goals.

+------------+----------+----------------+---------------+---------------+---------------+
    | Experiment | Visitors |     Engagement |           Buy |       Contact |       Pricing |
    +------------+----------+----------------+---------------+---------------+---------------+
    |          a |  173,074 | 6.0 % (10,363) | 1.3 % (2,249) | 4.8 % (8,307) | 5.3 % (9,172) |
    |          b |  173,073 |  5.1 % (8,826) | 1.1 % (1,903) | 3.5 % (6,057) | 3.9 % (6,749) |
    |          c |  173,073 |  5.0 % (8,653) | 1.0 % (1,730) | 1.3 % (5,538) | 3.2 % (5,538) |
    +------------+----------+----------------+---------------+---------------+---------------+

You can also export these reports to .csv format using this command:

php artisan ab:export /path/to/file.csv

If you run that command without a filepath, it will write it to the console.

Advanced
--------

**AB::pageview()**

Used to manually trigger an pageview.

**AB::interact()**

Used to manually trigger an interaction which results in engagement.

**AB::complete($goal)**

Used to manually trigger goals. Useful when you want to track goals that are not linked to urls or routes.

**AB::getExperiments()**

Get the list of experiments.

**AB::getGoals()**

Get the list of goals.