edbizarro/laravel-facebook-ads

Facebook & Instagram Ads for Laravel 5.6

 , _(*1)

Laravel Facebook Ads

Get ads infos (campaigns, ads, insights, etc...) from Facebook & Instagram Ads API, _(*2)

• Supported Facebook API version: >= v3.0

[](https://packagist.org/packages/edbizarro/laravel-facebook-ads) [](https://codeclimate.com/github/edbizarro/laravel-facebook-ads) [](https://www.codacy.com/app/edbizarro/laravel-facebook-ads?utm_source=github.com&utm_medium=referral&utm_content=edbizarro/laravel-facebook-ads&utm_campaign=Badge_Grade) [](https://styleci.io/repos/55666212)  , _(*3)

Installation

Follow this steps to use this package on your Laravel installation, _(*4)

Installing with composer

composer require edbizarro/laravel-facebook-ads

The package will automatically register it's service provider., _(*5)

For Laravel <= 5.4 add the provider manually, _(*6)

Load service provider (optional Laravel <= 5.4 only)

You need to update your config/app.php configuration file to register our service provider, adding this line on providers array:, _(*7)

Edbizarro\LaravelFacebookAds\Providers\LaravelFacebookServiceProvider::class

Enable the facade (optional)

This package comes with an facade to make the usage easier. To enable it, add this line at config/app.php on alias array:, _(*8)

'FacebookAds' => Edbizarro\LaravelFacebookAds\Facades\FacebookAds::class

Configuration

If you want to change any configurations, you need to publish the package configuration file. To do this, run artisan vendor:publish --provider="Edbizarro\LaravelFacebookAds\Providers\LaravelFacebookServiceProvider" on terminal. This will publish a facebook-ads.php file on your configuration folder like this:, _(*9)

<?php
return [
    'app_id' => env('FB_ADS_APP_ID'),
    'app_secret' => env('FB_ADS_APP_SECRET'),
];

Note that this file uses environment variables, it's a good practice put your secret keys on your .env file adding this lines on it:, _(*10)

FB_ADS_APP_ID="YOUR_APP_ID"
FB_ADS_APP_SECRET="YOUR_APP_SECRET_KEY"

First steps

Before using it, it's necessary to initialize the library with an valid access token, php example with:, _(*11)

FacebookAds::init($accessToken);

Now that everything is set up, it's easy to start using!, _(*12)

Example getting all ads

$ads = FacebookAds::adAccounts()->all()->map(function ($adAccount) {
  return $adAccount->ads(
      [
          'name',
          'account_id',
          'account_status',
          'balance',
          'campaign',
          'campaign_id',
          'status'
      ]
  );
});

Usage

To obtain a list of all AdAccount available fields, look at this., _(*13)

adAccounts

To obtain an adAccounts instance:, _(*14)

$adAccounts = $adsApi->adAccounts();

all

Use this method to retrieve your owned Ad Accounts. This method accepts an array as argument containing a list of fields., _(*15)

To obtain a list of all available fields, look at this., _(*16)

$adAccounts->all(['account_id', 'balance', 'name']);

get

Use this method to get details of an AdAccount. This method accepts an array as argument containing a list of fields and an account_id act_<AD_ACCOUNT_ID>, _(*17)

To obtain a list of all available fields, look at this., _(*18)

$adAccounts->get(['account_id', 'balance', 'name'], 'act_<AD_ACCOUNT_ID>');

Campaigns

To obtain an Campaigns instance:, _(*19)

$campaigns = $adsApi->campaigns();

all

Use this method to retrieve your adAccount campaigns. This method accepts an array as argument containing a list of fields and an account_id act_<AD_ACCOUNT_ID>, _(*20)

To obtain a list of all available fields, look at this., _(*21)

$campaigns->all(['name'], 'act_<AD_ACCOUNT_ID>');

License

, _(*22)