README

加入Discord – 用于支持、更新和协作。

用于Google Ads、Bing Ads和Facebook Ads API。

这是一个将每个广告源连接到您的Laravel应用的包装器。此SDK比官方SDK提供了更简洁、更一致的跨多个广告平台的集成，最终使得在项目中实现它变得容易得多。您不需要学习如何与每个API进行通信和理解其响应。

安装

使用Composer安装包。

运行composer require tmarois/laravel-ads-sdk

配置

运行php artisan vendor:publish --tag=laravel-ads-sdk
将其复制到您的.env文件并使用您的凭据更新（如果您没有凭据，请继续下一步）。

ADWORDS_DEVELOPER_TOKEN=""
ADWORDS_OAUTH2_CLIENT_ID=""
ADWORDS_OAUTH2_CLIENT_SECRET=""
ADWORDS_OAUTH2_REFRESH_TOKEN=""

BING_DEVELOPER_TOKEN=""
BING_CLIENT_ID=""
BING_CLIENT_SECRET=""
BING_REFRESH_TOKEN=""

FB_APP_ID=""
FB_APP_SECRET=""
FB_ACCESS_TOKEN=""
FB_REFRESH_TOKEN=""

身份验证

👉 对于GoogleAds

您需要继续您的开发人员令牌、客户端ID和客户端密钥。了解更多

按照命令行的步骤来生成刷新令牌。

运行php artisan laravelads:token:generate --service=GoogleAds

遇到问题？了解更多

👉 对于BingAds

您需要继续您的开发人员令牌、客户端ID和客户端密钥。了解更多

按照命令行的步骤来生成刷新令牌。

运行php artisan laravelads:token:generate --service=BingAds

遇到问题？了解更多

👉 对于FacebookAds

您需要您的应用ID、应用密钥和访问令牌。了解更多

注意：对于Facebook，似乎您不需要生成刷新令牌，一旦您有了访问令牌，只要您已经给自己提供了正确的访问、权限、营销API和广告账户的权限范围，API就应该能够连接。

🚀 使用方法

访问GoogleAds、BingAds或FacebookAds请使用以下方法

// The namespace to the Facade for laravel Ads SDK
use LaravelAds;

// calling Google Ads and including the Account ID
$googleAds = LaravelAds::googleAds()->with('ACCOUNT_ID');

// calling Bing Ads and including the Account ID
$bingAds = LaravelAds::bingAds()->with('ACCOUNT_ID');

// calling Facebook Ads and including the Account ID
$facebookAds = LaravelAds::facebookAds()->with('ACCOUNT_ID');

Google Ads

这使用的是googleads-php-lib SDK，用于Google Ads API

注意 – 您需要请求Google Ads API访问权限。

需要帮助进行身份验证？

管理

报告

Bing Ads

本程序使用BingAds-PHP-SDK，用于Bing Ads API

注意 – 您需要申请Bing Ads API访问权限。

需要帮助进行身份验证或沙盒模式吗？

管理

报告

Facebook Ads

本程序使用facebook-php-business-sdk，用于Facebook Marketing API

管理

报告

自定义

我们意识到无法添加每个端点，因此为了帮助改进您的开发者体验，我们已经使服务类可宏化。宏是一种向类添加新自定义方法的方式。这样您就可以利用现有的认证以及本程序带来的所有其他好处。

通常，您应该从您应用程序的服务提供者（例如 App\Providers\AppServiceProvider 服务提供者）的启动方法中调用此方法

public function boot()
{
    LaravelAds\Services\BingAds\Service::macro('addUetTags', function($tags){
        $serviceCall = $this->call(ServiceClientType::CampaignManagementVersion13);

        try {
            $request = new AddUetTagsRequest();
            $request->UetTags = $tags;

            $serverResponse = $serviceCall->GetService()->AddUetTags($request);

            return $serverResponse;
        } catch (\Exception $e) {
            print $serviceCall->GetService()->__getLastRequest()."\n";
            print $serviceCall->GetService()->__getLastResponse()."\n";
        }
    });

    LaravelAds\Services\GoogleAds\Service::macro('dd', function(){
        dd($this);
    });
}

然后在您的控制器或作业中调用

$bingAds = LaravelAds::bingAds()->addUetTags([
    [
        'Name' => 'Extensible!',
        'Description' => 'No PR Needed!',
    ]
]);

$bingAds = LaravelAds::googleAds()->dd();

贡献

我们正在积极寻找新的贡献者。

如果您想做出贡献，请加入Discord频道并/或提交拉取请求。

许可证

Laravel Ads SDK（本包）是开源软件，受MIT许可证许可。自行承担风险。Laravel Ads SDK是帮助您管理账户的工具，它不保证此处列出的功能将按描述的方式工作。如果您发现任何错误，请随时提交问题。本包与Laravel LLC或Laravel框架团队无关。

tmarois / laravel-ads-sdk

维护者

详细信息