Skip to content
Cordova/PhoneGap plugin for Facebook Audience Network Ads
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs refactoring based on generic ad interface, add support to native ad Nov 9, 2014
src add gradle file to fix android support version conflict Aug 20, 2017
test Update index.html Mar 6, 2017
www refactoring based on generic ad interface, add support to native ad Nov 9, 2014
.gitignore first commit, tested on android and ios Oct 24, 2014 Update Nov 5, 2015
plugin.xml add gradle file to fix android support version conflict Aug 20, 2017

Cordova Plugin for Facebook AudienceNetwork

Quick Demo

# install cordova CLI
[sudo] npm install -g cordova

# install a small utility to run all the commands for you
[sudo] npm install -g plugin-verify

# Demo 1: run admob demo with sample index.html
plugin-verify cordova-plugin-facebookads

How to use?

If use with Cordova CLI:

cordova plugin add cordova-plugin-facebookads

If use with Intel XDK: Project -> CORDOVA 3.X HYBRID MOBILE APP SETTINGS -> PLUGINS AND PERMISSIONS -> Third-Party Plugins -> Add a Third-Party Plugin -> Get Plugin from the Web, input:

Name: FacebookAdsPluginPro
Plugin ID: com.rjfun.cordova.facebookads
[x] Plugin is located in the Apache Cordova Plugins Registry

Quick Start Example Code

Step 1: Prepare your Facebook Audience Network Placement Id for your app, create it in Facebook Developers website

var ad_units = {
	ios : { 
	android : {

// select the right Ad Id according to platform
var adid = (/(android)/i.test(navigator.userAgent)) ? : ad_units.ios;

// set your hashed device id if testing on device (optional)
if(FacebookAds) FacebookAds.setOptions({
	isTesting: true,
	deviceHash: 'copy_your_hash_id_from_console_here'

Step 2: Create a banner with single line of javascript

// it will display smart banner at top center, using the default options
if(FacebookAds) FacebookAds.createBanner( adid.banner );

Or, show the banner Ad in some other way:

// or, show a default banner at bottom
if(FacebookAds) FacebookAds.createBanner( {
	adId: adid.banner, 
	autoShow:true} );

Step 3: Prepare an interstitial, and show it when needed

// preppare and load ad resource in background, e.g. at begining of game level
if(FacebookAds) FacebookAds.prepareInterstitial( {adId:adid.interstitial, autoShow:false} );

// show the interstitial later, e.g. at end of game level
if(FacebookAds) FacebookAds.showInterstitial();

You can even embed the Ad into web content with Native Ad.

Check the example code [test/index.html] (

Javascript API Overview


// set default value for other methods
setOptions(options, success, fail);

// for banner
createBanner(adId/options, success, fail);
showBannerAtXY(x, y);

// for interstitial
prepareInterstitial(adId/options, success, fail);

// for native ad
createNativeAd(adId, success, fail);

Detailed Documentation

The APIs, Events and Options are detailed documented.

Read the detailed API Reference Documentation English.


If encounter problem when using the plugin, please read the FAQ first.

Full Example Code

This FacebookAds Plugin Pro offers the most flexibility and many options.

Check the [test/index.html] (


iPhone Banner iPhone Interstitial
ScreenShot ScreenShot

iPhone Landscape


iPhone Native Ad Android Native Ad
ScreenShot ScreenShot

Ad PluginPro series for the world leading Mobile Ad services:

More Cordova/PhoneGap plugins by Raymond Xie, find them in npm.

If use in commercial project or need prompt support, please buy a license, you will be served with high priority.

Project outsourcing and consulting service is also available. Please contact us if you have the business needs.

You can’t perform that action at this time.