panchalmukundak / ads-api-sample Goto Github PK

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 into the ./inc
directory of your Ads API sample app.
 
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. 

Point your browser to the index.php file and that's it.