tmarois/laravel-ads-sdk

There is no license information available for the latest version (v1.2.18) of this package.

A Laravel Ads SDK for Google Ads, Bing Ads and Facebook Ads

v1.2.18 2020-06-03 00:51 UTC

README

Slack

For Google Ads and Bing Ads API.

This is a wrapper for connecting each ad source into your Laravel application. This SDK provides simpler and consistent methods across many ad source integrations than the traditional SDKs; ultimately making it a lot easier to implement in your projects. You shouldn't have to learn how to communicate and understand the responses to every API.

The goal of this package is to provide you with one SDK to manage all the platforms.

Note: You do not need to use the Laravel Framework, it's not required, using the manual-configuration allows this package to be used in any project. Using Laravel helps with using commands for authentication and initial setup.

(1) Installation

Use Composer to install package.

Run composer require tmarois/laravel-ads-sdk:^1.2

(2) Laravel Config

Run php artisan vendor:publish, then copy these to your .env and update with your credentials.

Only if using the Laravel Framework, Otherwise you can use the manual-configuration to use in any project.

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=""

(3) For GoogleAds

Follow the steps in the command line to generate a refresh token.

Run php artisan laravelads:token:generate --service=GoogleAds

Having Trouble? Learn More

(4) For BingAds

Follow the steps in the command line to generate a refresh token.

Run php artisan laravelads:token:generate --service=BingAds

Having Trouble? Learn More

(5) Usage

Accessing GoogleAds or BingAds services use the following:

// The namespace to the Facade
use LaravelAds;

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

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

Google Ads

This uses the googleads-php-lib SDK for the Google Ads API

NOTICE – You will need to Request Google Ads API Access.

Management

Reports

Bing Ads

This uses the BingAds-PHP-SDK for the Bing Ads API

NOTICE – You will need to Request Bing Ads API Access.

Management

Reports

Facebook Ads

This uses the facebook-php-business-sdk for Facebook Marketing API

Looking for and accepting contributors to help implement this.

Contributions

We are actively looking for new contributors.

If you want to help, join the slack channel and/or submit pull requests.

License

Laravel Ads SDK (This Package) is open-sourced software licensed under the MIT license. USE AT YOUR OWN RISK. Laravel Ads SDK is a tool to help you manage your accounts, it does not guarantee features listed here will work as described. If you do find a bug, please feel free to submit an issue. This package is not affiliated with Laravel LLC or the Laravel Framework team.