Laravel Ads SDK
For Google Ads, Bing Ads and Facebook Ads APIs.
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 them all.
(1) Installation
Use Composer to install package.
Run composer require grayscale/laravel-ads-sdk:^1.2
(2) Laravel Config
Run php artisan vendor:publish, then copy these to your .env and update with your credentials.
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
(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 Customer Client Id
$googleAds = LaravelAds::googleAds()->with('CLIENT_ID');
// calling the Bing Ads Service and including the Customer Client Id
$bingAds = LaravelAds::bingAds()->with('CLIENT_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
- Fetching - All Campaigns
- Fetching - All Ad Groups
- Management - Campaigns
- Management - Ad Groups
- Advanced Options
Reports
- Account Performance
- Campaign Performance
- Ad Group Performance
- Final URL Performance
- Placement Domain Performance
- Placement URL Performance
- Search Term Performance
- Age Range Performance
- Gender Performance
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
- Account Performance
- Campaign Performance
- Ad Group Performance
- Final URL Performance
- Search Term Performance
- Age Range Performance
- Gender Performance
Facebook Ads
This uses the facebook-php-business-sdk for Facebook Marketing API
Coming Soon. Looking for contributors.
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.