arttiger/laravel-cpa

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

v1.0.5 2022-10-17 13:18 UTC

This package is auto-updated.

Last update: 2024-09-17 17:30:45 UTC


README

Laravel CPA Network Integration

StyleCI Status Total Downloads Latest Stable Version License

Laravel CPA 网络集成和目标客户行为注册的 Laravel 包。目前支持:AdmitadCredyDoAffiliateFinlineLeadGidLeads.suPapaKarloSales DoublerStorm DigitalLoangate、Appscorp、PAPGoodAffLetMeAdsGuruLeads、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

安全

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

鸣谢

Volodymyr Farylevych

许可证

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