wanderreisen / ab-test
Laravel A/B实验测试工具
Requires
- php: ^8.0
- illuminate/support: ~8
- jaybizzle/crawler-detect: ^1.2
Requires (Dev)
- mockery/mockery: ^1.0
- orchestra/testbench: 3.6.* | 3.7.* | 3.8.*
- phpunit/phpunit: ^7.0 | ^8.0
This package is auto-updated.
Last update: 2024-09-23 15:33:25 UTC
README
此包可以帮助您找出哪些内容在您的网站上有效,哪些无效。
它允许您创建实验和目标。访客将随机收到下一个实验,并且您可以定制您的网站以适应该实验。视图和目标转换将被跟踪,您可以在报告中查看结果。
安装
此包可用于Laravel 5.6或更高版本。
您可以通过Composer安装此包
composer require wanderreisen/laravel-ab
配置
安装后发布配置文件
php artisan vendor:publish --provider="Wanderreisen\AbTesting\AbTestingServiceProvider"
您可以在其中定义您的实验和目标。
最后,运行新添加的迁移
php artisan migrate
应添加两个新迁移。
使用方法
实验
@if (AbTesting::isExperiment('logo-big')) <div class="logo-big"></div> @elseif (AbTesting::isExperiment('logo-grayscale')) <div class="logo-greyscale"></div> @elseif (AbTesting::isExperiment('brand-name')) <h1>Brand name</h1> @endif
这是包最基本的使用方法。您无需初始化任何内容。如果调用isExperiment
,则包会为您处理一切。
或者,您可以使用自定义blade if语句
@ab('logo-big') <div class="logo-big"></div> @elseab('logo-grayscale') <div class="logo-greyscale"></div> @elseab('brand-name') <h1>Brand name</h1> @endab
这将按完全相同的方式工作。
如果您不想进行任何连续渲染,可以调用
AbTesting::pageView()
直接,并用随机实验触发新页面视图。此函数也将从isExperiment
调用。
在底层,一个新的会话项目将跟踪当前实验。会话只会得到一个实验,并且只会触发一个页面视图。
您可以使用以下方式获取当前实验
// get the underlying model AbTesting::getExperiment() // get the experiment name AbTesting::getExperiment()->name // get the visitor count AbTesting::getExperiment()->visitors
或者,这里有为您提供的请求助手
public function index(Request $request) { // the same as 'AbTesting::getExperiment()' $request->abExperiment() }
目标
要完成目标,只需调用
AbTesting::completeGoal('signup')
该函数将增加分配给活动实验的目标的转换。如果会话中没有运行活动实验,则会创建一个。您在每个会话中只能触发一次目标转换。这将通过另一个会话项目来防止。该函数返回底层的目标模型。
要获取当前会话中完成的全部目标
AbTesting::getCompletedGoals()
机器人和爬虫
包可以尝试忽略机器人和爬虫注册页面视图。只需在配置中启用ignore_crawlers
选项。
报告
要获取页面视图、完成的目标和转换的报告,请调用报告命令
php artisan ab:report
这将打印类似以下内容
+---------------+----------+-------------+
| Experiment | Visitors | Goal signup |
+---------------+----------+-------------+
| big-logo | 2 | 1 (50%) |
| small-buttons | 1 | 0 (0%) |
+---------------+----------+-------------+
重置
要重置所有访客和目标完成情况,请调用重置命令
php artisan ab:reset
事件
此外,您还可以挂钩两个事件
ExperimentNewVisitor
在实验被分配给新访客时触发一次。您可以获取实验作为事件的属性。GoalCompleted
在目标完成时触发一次。您可以获取目标作为事件的属性。
测试
composer test
更新日志
有关最近更改的更多信息,请参阅更新日志。
贡献
有关详细信息,请参阅贡献。
安全
如果您发现任何与安全相关的漏洞,请通过moin@benjaminbortels.de发送电子邮件,而不是使用问题跟踪器。
许可
MIT许可(MIT)。有关更多信息,请参阅许可文件。
Laravel包模板
此包是使用Laravel包模板生成的。