a1ex7 / cpa
Laravel CPA (Cost Per Action) 网络集成包
v1.0
2019-12-25 14:36 UTC
Requires
Requires (Dev)
- mockery/mockery: ^1.1
- orchestra/testbench: ~3.0
- phpunit/phpunit: ~7.0
- sempro/phpunit-pretty-print: ^1.0
This package is auto-updated.
Last update: 2024-09-29 05:22:15 UTC
README
受 wearesho-team/bobra-cpa 启发
Laravel 用于 CPA 网络集成和目标客户动作注册的包。当前支持: Admitad, Credy, DoAffiliate, Finline, LeadGid, Leads.su, PapaKarlo, Sales Doubler, Storm Digital
安装
使用 composer 安装包
$ composer require a1ex7/cpa
对于 Laravel 5.4 及以下版本,需要注册服务提供者
配置
要编辑默认配置,可以执行
php artisan vendor:publish --provider="A1ex\Cpa\CpaServiceProvider"
之后,将创建 config/cpa.php
文件。
环境
该包可以通过环境变量直接配置
- SALES_DOUBLER_ID - 请求 SalesDoubler 的个人 ID
- SALES_DOUBLER_TOKEN - 请求 URI 的 SalesDoubler 令牌
- STORM_DIGITAL_GOAL - (默认: 1),StormDigital URL 中的目标
- STORM_DIGITAL_SECURE - StormDigital URL 中的安全选项
- PAPA_KARLO_TYPE - (‘offer’ 或 ‘goal’),PapaKarlo 的 postback 类型
- PAPA_KARLO_OFFER - (默认: 35),PapaKarlo 的个人推广 ID
- PAPA_KARLO_GOAL - (默认: 75),PapaKarlo 的个人目标 ID
- DO_AFFILIATE_PATH - DoAffiliate API 的路径(例如:在 http://tracker2.doaffiliate.net/api/pozichka-ua 中的 pozichka-ua)
- LEADS_SU_TOKEN - LeadsSu 的令牌
- ADMITAD_POSTBACK_KEY - postback 请求认证密钥,32 位定长字符串
- ADMITAD_CAMPAIGN_CODE - AdmitAd 定义的推广代码,10 位定长字符串
- ADMITAD_ACTION_CODE - 目标动作代码,从 AdmitAd 获取
- CREDY_OFFER - 推广代码,从 Credy 获取
如果某些 CPA 网络的密钥未设置,则不会为此网络执行 postback 请求。
注册中间件
您可以在 app/Http/Kernel.php
文件中注册包中间件
<?php namespace App\Http; use Illuminate\Foundation\Http\Kernel as HttpKernel; class Kernel extends HttpKernel { /** * The application's route middleware. * * @var array */ protected $routeMiddleware = [ /**** OTHER MIDDLEWARE ****/ 'lead.check' => \A1ex7\Cpa\Middleware\LeadCheckMiddleware::class ]; }
您可以将中间件添加到您的组中,如下所示
Route::group( [ 'middleware' => [ 'lead.check' ] ], function(){ //... });
用法
当用户注册时创建线索
CpaLead::createFromCookie(auth()->user()); // or CpaLead::createFromCookie($userId);
当目标达成时注册转化
CpaConversion::register($user, $transactionId, 'sale');
事件(例如 'sale')必须在配置中指定。您可以为特定事件添加其他参数。请参阅 config/cpa.php
示例
变更日志
请参阅变更日志,了解最近发生了哪些变化。
测试
$ composer test
贡献
请参阅贡献.md,获取详细信息及待办事项列表。
安全
如果您发现任何与安全相关的问题,请通过作者邮箱联系,而不是使用问题跟踪器。
致谢
许可证
许可证。请参阅许可证文件以获取更多信息。