arttiger / laravel-cpa
Laravel CPA (Cost Per Action) 网络集成包
v1.0.5
2022-10-17 13:18 UTC
Requires
- illuminate/support: ^5.6|^6.0|^7.0|^8.0|^9.0
Requires (Dev)
- mockery/mockery: ^1.4.2
- orchestra/testbench: ^3.0|^4.0|^5.0|^6.0
- phpunit/phpunit: ^8.5
- sempro/phpunit-pretty-print: ^1.0
- styleci/cli: ^1.2
README
Laravel CPA 网络集成和目标客户行为注册的 Laravel 包。目前支持:Admitad、Credy、DoAffiliate、Finline、LeadGid、Leads.su、PapaKarlo、Sales Doubler、Storm Digital、Loangate、Appscorp、PAP、GoodAff、LetMeAds、GuruLeads、Nolimit。
安装
通过 composer 安装此包
$ composer require arttiger/laravel-cpa
接下来,您需要运行迁移
$ php artisan migrate
对于 Laravel 5.4 及以下版本,需要注册服务提供者
配置
要编辑默认配置,您可以执行
php artisan vendor:publish --provider="Arttiger\Cpa\CpaServiceProvider"
之后,将创建 config/cpa.php
。
环境
此包可以通过环境变量直接配置
- SALES_DOUBLER_ID - 向 SalesDoubler 发起请求的个人 ID
- SALES_DOUBLER_TOKEN - SalesDoubler 请求 URI 的令牌
- STORM_DIGITAL_GOAL - StormDigital URL 中的目标(默认:1)
- STORM_DIGITAL_SECURE - StormDigital URL 中的安全设置
- PAPA_KARLO_TYPE - PapaKarlo 的 postback 类型('offer' 或 'goal')
- PAPA_KARLO_OFFER - PapaKarlo 的个人 offer ID(默认:35)
- PAPA_KARLO_GOAL - PapaKarlo 的个人 goal ID(默认:75)
- PDL_PROFIT_OFFER - PDL-Profit 系统中广告商的 ID
- DO_AFFILIATE_PATH - DoAffiliate API 的路径(例如:在 http://tracker2.doaffiliate.net/pozichka-ua 中的 pozichka-ua)
- LEADS_SU_TOKEN - LeadsSu 的令牌
- ADMITAD_POSTBACK_KEY - postback 请求认证密钥,32 位固定字符串
- ADMITAD_CAMPAIGN_CODE - AdmitAd 定义的广告活动代码,10 位固定字符串
- ADMITAD_ACTION_CODE - 目标行为代码,从 AdmitAd 获取
- CREDY_OFFER - offer 代码,从 Credy 获取
- LET_ME_ADS_PATH - LetMeAds API 的路径(例如:api/v1.1/y7r/dcfgs1tg:awvv47ghn1jv1f$am/get/postback.json)
- GURU_LEADS_PATH - GuruLeads API 的路径(例如:postback)
- CLICK2MONEY_PATH - Click2Money API 的路径(例如:cpaCallback)
- NOLIMIT_PATH - Nolimit API 的路径(例如:postback)
如果未设置某些 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' => \Arttiger\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
贡献
有关详细信息和工作待办事项,请参阅contributing.md
安全
如果您发现任何与安全相关的问题,请通过作者邮箱联系,而不是使用问题追踪器。
鸣谢
许可证
MIT许可证(MIT)。有关更多信息,请参阅许可证文件