a1ex7/cpa

Laravel CPA (Cost Per Action) 网络集成包

v1.0 2019-12-25 14:36 UTC

This package is auto-updated.

Last update: 2024-09-29 05:22:15 UTC


README

受 wearesho-team/bobra-cpa 启发

Packagist 上的最新版本 总下载量 构建状态 laravel 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,获取详细信息及待办事项列表。

安全

如果您发现任何与安全相关的问题,请通过作者邮箱联系,而不是使用问题跟踪器。

致谢

许可证

许可证。请参阅许可证文件以获取更多信息。