search

merbin2012 / cordova-plugin-codeplay-facebookads-free

Free facebook audience network ads for cordova user. This supports banner ads, Interstitial ads and video ads.
23 stars 9 forks source link

readme

Code Play facebook audience network free ads

Developed by HTML Code Play and this plugin is used for showing facebook audience network ads.

Git URL

https://github.com/merbin2012/cordova-plugin-codeplay-facebookads-free

Facebook Audience Network SDK version

I will try to keep the latest version, current version is 'com.facebook.android:audience-network-sdk:6.+'

How to Instalation?

Using the Cordova CLI

$ cordova plugin add cordova-plugin-codeplay-facebookads-free

Using the phonegap CLI

$ phonegap local plugin add cordova-plugin-codeplay-facebookads-free

How to Uninstall?

Using the Cordova CLI

$ cordova plugin rm cordova-plugin-codeplay-facebookads-free

Using the phonegap CLI

$ phonegap local plugin rm cordova-plugin-codeplay-facebookads-free

Methods 1

Load and immediately show Banner Ads.

Note: Strongly recommended you to use loadAndShowBannerAds for banner ads instead of loading, showing, hiding separately.

Syntax

cordova.plugins.codeplayfacebookads.loadAndShowBannerAds(options,bannerSuccess,bannerFail);

Options

var options={
bannerid:"523519301434xxx_xxxxxxxxxxxxxxx"
,isTesting:true|false
}

Example


cordova.plugins.codeplayfacebookads.loadAndShowBannerAds(options,bannerSuccess,bannerFail);

function bannerSuccess(evt)
{

  if(evt === "AdLoaded"){
     console.log("Facebook AdLoaded");
  }
  else if(evt === "AdClicked"){
     console.log("Facebook AdClicked");
  }
  else if(evt === "AdImpression"){
     console.log("Facebook AdImpression");
  }
  else if(evt === "AdDistroyed"){
    console.log("Facebook banner AdDistroyed");
  }  
  else if(evt === "AdHidden"){
     console.log("Facebook AdHidden");
  }  

}
function bannerFail(result)
{
 console.log(result);
}

Screenshot

Facebook banner ads

Methods 2

Load only Banner Ads

Syntax

cordova.plugins.codeplayfacebookads.loadBannerAds(options,bannerSuccess,bannerFail);

Options

var options={
bannerid:"523519301434xxx_xxxxxxxxxxxxxxx"
,isTesting:true|false
}

Example


cordova.plugins.codeplayfacebookads.loadBannerAds(options,bannerSuccess,bannerFail);

function bannerSuccess(evt)
{

  if(evt === "AdLoaded"){
     console.log("Facebook AdLoaded");
  }
  else if(evt === "AdClicked"){
     console.log("Facebook AdClicked");
  }
  else if(evt === "AdImpression"){
     console.log("Facebook AdImpression");
  }
  else if(evt === "AdDistroyed"){
    console.log("Facebook banner AdDistroyed");
  }   
  else if(evt === "AdHidden"){
     console.log("Facebook AdHidden");
  }  

}
function bannerFail(result)
{
 console.log(result);
}

Methods 3

Show banner ad after load the banner Ad

Syntax

cordova.plugins.codeplayfacebookads.showBannerAds(bannerSuccess,bannerFail);

Example


cordova.plugins.codeplayfacebookads.showBannerAds(bannerSuccess,bannerFail);

function bannerSuccess(evt)
{

  if(evt === "AdLoaded"){
     console.log("Facebook AdLoaded");
  }
  else if(evt === "AdClicked"){
     console.log("Facebook AdClicked");
  }
  else if(evt === "AdImpression"){
     console.log("Facebook AdImpression");
  }
  else if(evt === "AdDistroyed"){
    console.log("Facebook banner AdDistroyed");
  }  
  else if(evt === "AdHidden"){
     console.log("Facebook AdHidden");
  }  

}
function bannerFail(result)
{
 console.log(result);
}

Methods 4

Hide/distroy Banner Ads

Syntax

cordova.plugins.codeplayfacebookads.distroyBannerAds(bannerSuccess,bannerFail);

function bannerSuccess(evt)
{

  if(evt === "AdLoaded"){
     console.log("Facebook AdLoaded");
  }
  else if(evt === "AdClicked"){
     console.log("Facebook AdClicked");
  }
  else if(evt === "AdImpression"){
     console.log("Facebook AdImpression");
  }
  else if(evt === "AdDistroyed"){
     console.log("Facebook AdDistroyed");
  }  

}
function bannerFail(result)
{
 console.log(result);
}

Screenshot

Hide facebook banner ads

Methods 5

Load interstitial ads

Syntax

cordova.plugins.codeplayfacebookads.loadInterstitialAds(options,interstitialSuccess,interstitialFail);

Options

var options={
interstitialid:"52351930143xxx_xxxxxxxxxxxxxxx"
,isTesting:true|false
}

Example

var options={
interstitialid:"52351930143xxx_xxxxxxxxxxxxxxx"
,isTesting:true
};

cordova.plugins.codeplayfacebookads.loadInterstitialAds(options,interstitialSuccess,interstitialFail);

function interstitialSuccess(evt)
{

  if(evt === "AdDisplayed"){
     console.log("Facebook AdDisplayed");
  }
  else if(evt === "AdClosed"){
     console.log("Facebook AdClosed");
  }
  else if(evt === "AdLoaded"){
     console.log("Facebook AdLoaded");
  }
  else if(evt === "AdClicked"){
     console.log("Facebook AdClicked");
  }
  else if(evt === "AdImpression"){
     console.log("Facebook AdImpression");
  }
}
function interstitialFail(result)
{
 console.log(result);
}

Methods 6

Show interstitial ads

Syntax

cordova.plugins.codeplayfacebookads.showInterstitialAds(interstitialSuccess,interstitialFail);

Example

cordova.plugins.codeplayfacebookads.showInterstitialAds(interstitialSuccess,interstitialFail);

function interstitialSuccess(evt)
{

  if(evt === "AdDisplayed"){
     console.log("Facebook AdDisplayed");
  }
  else if(evt === "AdClosed"){
     console.log("Facebook AdClosed");
  }
  else if(evt === "AdLoaded"){
     console.log("Facebook AdLoaded");
  }
  else if(evt === "AdClicked"){
     console.log("Facebook AdClicked");
  }
  else if(evt === "AdImpression"){
     console.log("Facebook AdImpression");
  }
}
function interstitialFail(result)
{
 console.log(result);
}

Screenshot

Facebook Interstitial

Methods 7

Load Video ads

Syntax

cordova.plugins.codeplayfacebookads.loadRewardVideoAd(options,videoRewardSuccess,videoRewardFail);

Options

var options={
videoid:"52351930143xxx_xxxxxxxxxxxxxxx"
,isTesting:true|false
}

Example

var options={
videoid:"52351930143xxx_xxxxxxxxxxxxxxx"
,isTesting:true
};

cordova.plugins.codeplayfacebookads.loadRewardVideoAd(options,videoRewardSuccess,videoRewardFail);

function videoRewardSuccess(evt)
{

  if(evt === "AdLoaded"){
     console.log("Facebook AdLoaded");
  }
  else if(evt === "AdClicked"){
     console.log("Facebook AdClicked");
  }
  else if(evt === "AdPlaying"){
     console.log("Facebook AdPlaying");
  }
  else if(evt === "AdCompleted"){
     console.log("Facebook AdCompleted");
  }
  else if(evt === "AdClosed"){
     console.log("Facebook AdClosed");
  }
}
function videoRewardFail(result)
{
 console.log(result);
}

Important Note : If you get the following error "Rewarded video ad failed to load: The display format in the ad request does not match the display format specified for this placement. Each placement can only be used with a single display format. You can create multiple placements in order to use multiple display formats.", please follow the steps to resolve the issue. 1) You must have the Audience Network SDK integrated in your game 2) Your app must have an active, approved Audience Network account with payment information. 3) Game only: Your game app is active and added to your account. 4) Ad position: You must already have a rewarded video ad unit in your game. Reference : https://stackoverflow.com/questions/50532615/facebook-rewarded-video-ad-failed-to-load

Methods 8

Show Video ads

Syntax

cordova.plugins.codeplayfacebookads.showRewardVideoAd(videoRewardSuccess,videoRewardFail);

Example

cordova.plugins.codeplayfacebookads.showRewardVideoAd(videoRewardSuccess,videoRewardFail);

function videoRewardSuccess(evt)
{

  if(evt === "AdLoaded"){
     console.log("Facebook AdLoaded");
  }
  else if(evt === "AdClicked"){
     console.log("Facebook AdClicked");
  }
  else if(evt === "AdPlaying"){
     console.log("Facebook AdPlaying");
  }
  else if(evt === "AdCompleted"){
     console.log("Facebook AdCompleted");
  }
  else if(evt === "AdClosed"){
     console.log("Facebook AdClosed");
  }
}
function videoRewardFail(result)
{
 console.log(result);
}

Support Platfrom

Our Apps

https://play.google.com/store/apps/details?id=com.HTML.AngularJS.Codeplay

https://play.google.com/store/apps/details?id=sql.code.play

https://play.google.com/store/apps/details?id=html.editor.codeplay

https://play.google.com/store/apps/details?id=php.code.play

https://play.google.com/store/apps/details?id=cordova.code.play

https://play.google.com/store/apps/details?id=com.kids.learning.master