PHPackages                             yish/laravel-facebook-php-ads-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. yish/laravel-facebook-php-ads-sdk

AbandonedArchivedLibrary[API Development](/categories/api)

yish/laravel-facebook-php-ads-sdk
=================================

Facebook ads api sdk for laravel

2.6.10(7y ago)95.8k1PHPPHP >=7.0.0

Since Mar 30Pushed 6y ago1 watchersCompare

[ Source](https://github.com/Mombuyish/LaravelFacebookAdsSdk)[ Packagist](https://packagist.org/packages/yish/laravel-facebook-php-ads-sdk)[ RSS](/packages/yish-laravel-facebook-php-ads-sdk/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (10)Dependencies (1)Versions (24)Used By (0)

LaravelFacebookAdsSdk
=====================

[](#laravelfacebookadssdk)

This project is developing now.

**update! facebook ads api 3.1 !**

Installation
============

[](#installation)

```
$ composer require yish/laravel-facebook-php-ads-sdk

```

app.php
-------

[](#appphp)

```
//Provider
  Yish\LaravelFacebookAdsSdk\FacebookAdsServiceProvider::class,

//Facade
  'FacebookAds' => Yish\LaravelFacebookAdsSdk\Facades\LaravelFacebookAdsSdk::class,

```

config publish
--------------

[](#config-publish)

```
$ php artisan vendor:publish

```

.env

```
FB_APP_ID=
FB_APP_SECRET=

```

functions
=========

[](#functions)

Reference `FacebookAds\Object\Fields\AdAccountFields` consts.

```
  FacebookAds::getAdAccountList($facebookToken, ['ACCOUNT_ID', 'BUSINESS']);

```

or you can do on string for one.

```
  FacebookAds::getAdAccountList($facebookToken, 'ACCOUNT_ID');

```

Reference `FacebookAds\Object\Fields\CampaignFields` consts.

```
  FacebookAds::getCampaignList($facebookToken, $account_id, ['OBJECTIVE', 'NAME']);

```

or you can do on string for one.

```
  FacebookAds::getCampaignList($facebookToken, $account_id, 'OBJECTIVE');

```

Reference `FacebookAds\Object\Fields\AdInsightsFields` consts.

By default.

```
//DEFAULT:$parameters = ['IMPRESSIONS', 'SPEND'], $preset = 'last_30_days', $time_range = null, $amount = 50
  FacebookAds::getInsightList($userFbToken, $type, $ids);

```

Example:

```
	FacebookAds::getInsightList($userFbToken, $type, $ids, 'last_month');
	FacebookAds::getInsightList($userFbToken, $type, $ids, null, ['2015-01-01', '2015-03-01']);

	//Note
	date_preset: his field is ignored if time_range or time_ranges is specified.
	FacebookAds::getInsightList($userFbToken, $type, $ids, 'last_month', ['2015-01-01', '2015-03-01']); //you will get '2015-01-01', '2015-03-01' data.

```

or you can do on string for one.

```
  FacebookAds::getInsightList($userFbToken, $type, $ids, 'COST_PER_UNIQUE_CLICK');
//$type = [
        'adaccount',
        'campaign',
        'adset',
        'ad',
];

//$preset @see https://developers.facebook.com/docs/marketing-api/reference/ad-campaign/insights/

```

Exceptions
==========

[](#exceptions)

I add `LaravelFacebookAdsSdkException` to handle exceptions. You can handle it in `App\Exceptions` handler.php

```
    if ( $e instanceof LaravelFacebookAdsSdkException ) {
        return respond($e->getMessage(), $e->getCode());
    }

```

Transform
=========

[](#transform)

Transform AdAccount status you can call this:

```
    FacebookAds::transAdAccountStatus($adaccount_status);

```

//reference: //account\_status, Status of the account //1 = ACTIVE //2 = DISABLED //3 = UNSETTLED //....

Transform DisableReason status you can call this:

```
    FacebookAds::transDisableReason($disable_reason);

```

//reference: //0 = NONE //1 = ADS\_INTEGRITY\_POLICY //2 = ADS\_IP\_REVIEW //3 = RISK\_PAYMENT //4 = GRAY\_ACCOUNT\_SHUT\_DOWN //5 = ADS\_AFC\_REVIEW

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 94.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~45 days

Recently: every ~208 days

Total

20

Last Release

2833d ago

Major Versions

0.5.8 → 2.6.02016-04-20

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/8007787?v=4)[Yish](/maintainers/Mombuyish)[@Mombuyish](https://github.com/Mombuyish)

---

Top Contributors

[![Mombuyish](https://avatars.githubusercontent.com/u/8007787?v=4)](https://github.com/Mombuyish "Mombuyish (37 commits)")[![eddieace](https://avatars.githubusercontent.com/u/12055213?v=4)](https://github.com/eddieace "eddieace (2 commits)")

---

Tags

laravelsdkfacebookads

### Embed Badge

![Health badge](/badges/yish-laravel-facebook-php-ads-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/yish-laravel-facebook-php-ads-sdk/health.svg)](https://phpackages.com/packages/yish-laravel-facebook-php-ads-sdk)
```

###  Alternatives

[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[facebook/php-ads-sdk

PHP SDK for Facebook Business

9014.1M8](/packages/facebook-php-ads-sdk)[edbizarro/laravel-facebook-ads

Facebook & Instagram Ads for Laravel 5.6+

13629.5k](/packages/edbizarro-laravel-facebook-ads)[spotonlive/laravel-facebook-ads

Facebook integration for Laravel

2017.0k](/packages/spotonlive-laravel-facebook-ads)[missael-anda/laravel-whatsapp

A Whatsapp Business Cloud API wrapper for Laravel.

677.5k](/packages/missael-anda-laravel-whatsapp)[octw/aramex

A Library to integrate with Aramex APIs

2925.2k](/packages/octw-aramex)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)