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

v3.0.1 2024-04-11 18:50 UTC

README

灵感来源于 wearesho-team/bobra-cpa

Latest Version on Packagist Total Downloads

laravel cpa

Laravel 用于集成 CPA 网络和注册应用中目标客户行为的包。当前支持:AdmitadCredyDoAffiliateFinlineLeadGidLeads.suPapaKarloSales Doubler,Storm Digital,Loangate,Appscorp,PAP,GoodAff,LetMeAds,GuruLeads,Nolimit,MoneyGo,LeadLoan。

安装

通过 composer 安装包

$ composer require artjoker/cpa

对于 Laravel 5.4 及以下版本,需要注册服务提供者

配置

要编辑默认配置,可以执行以下操作

php artisan vendor:publish --provider="Artjoker\Cpa\CpaServiceProvider"

之后,将创建 config/cpa.php

环境

此包可以开箱即用通过环境变量进行配置

  • SALES_DOUBLER_ID - 请求 SalesDoubler 的个人 ID
  • SALES_DOUBLER_TOKEN - 请求 URI 的 SalesDoubler 令牌
  • 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)
  • MONEY_GO_PATH - MoneyGo API 的路径(例如:postback)
  • SD_TOP_ID - 请求 SD_Top 的个人 ID
  • SD_TOP_TOKEN - 请求 URI 的 SD_Top 令牌
  • LEAD_LOAN_PATH - LeadLoan 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' => \Artjoker\Cpa\Middleware\LeadCheckMiddleware::class
    ];
}

您可以将中间件添加到您的组中,如下所示

Route::group(
    [
        'middleware' => [ 'lead.check' ]
    ], 
    function(){ //...
});

用法

当用户注册时创建线索

CpaLead::createFromCookie(auth()->user());
// or
CpaLead::createFromCookie($userId);

当目标达成时注册转换

CpaConversion::register($user, $transactionId, 'sale');

事件(例如'销售')必须在配置中指定。必须指定。您可以针对特定事件添加额外的参数。请参阅 config/cpa.php 示例。

变更日志

有关最近更改的更多信息,请参阅变更日志

测试

$ composer test

贡献

有关详细信息和工作清单,请参阅contributing.md

安全

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

鸣谢

Volodymyr Taranenko @ VT2

许可证

许可证。有关更多信息,请参阅许可证文件