Readme File for Facebook Ads API Sample Code ------------------------------------------------------------- The Facebook Ads API is currently in a closed beta. If you would like to have an application enabled for the Facebook Ads API; please go to: http://developers.facebook.com/docs/adsapi and follow the instructions. This repository contains the open source Ads API Sample code that allows you to utilize the above on your website. Except as otherwise noted, the Facebook Ads API Sample code is licensed under the Apache Licence, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0.html) This sample code is built using the Facebook PHP-SDK v3.x available at http://github.com/facebook/php-sdk. Please checkout the php-sdk first and copy the src/facebook.php file in the ./inc directory. The source code is provided as a reference. Directories and Files images/ login.gif - login image for facebook connect logout.gif - logout image for facebook connect inc/ Prevent direct access to inc/ through web server config. adlib.php - implementation for the advertising API common.php - Initialization functions for the library base_facebook.php & facebook.php - these are the facebook php-sdk files. Please see http://github.com/facebook/php-sdk header.php - common header file to print the html header, essential java script for facebook connect includes.php - include all relevant files tmp/ Web Server should be able to write to tmp/ Empty directory for temporary image uploads ./ create_campaign.php - create a campaign example index.php - ads sample app home page create_adgroup.php - create an ad example multi_create_batch.php - Example for creating multiple adgroups with a single batch call Getting Started Please refer to: http://developers.facebook.com/docs/adsapi To get started with the ads api, modify the common.php file to enter your application ID and secret. Make sure that the base domain is set for the Facebook app to base domain where the code is hosted. Please follow instructions listed here to setup your application - http://wiki.developers.facebook.com/index.php/Connect/Setting_Up_Your_Site#Setting_Up_Your_Application_and_Getting_an_API_Key Point your browser to the index.php file and that's it. Any questions - please email ads-api-bugs@publists.facebook.com FAQ: Q) I am getting an error even after granting permissions to the application "Fatal error: Uncaught Exception: 294: Managing advertisements requires the extended permission ads_management, and a participating API key" A) Make sure you've accepted the terms; please refer to "Agreeing to the Ads API Terms" on http://developers.facebook.com/docs/adsapi