Have ideas to improve npm?Join in the discussion! »

    tapsell-plus-cordova-plugin

    1.2.3 • Public • Published

    Tapsell Plus Plugin

    Cordova / PhoneGap Plugin for Tapsell Plus.

    Contents

    1. Description
    2. Features
    3. Demo
    4. Quick Start
    5. Installation
    6. Usage
    7. API
    8. Wiki and Docs
    9. Screenshots
    10. License
    11. Credits

    Description

    This Cordova / PhoneGap plugin enables displaying mobile Ads with single line of javascript code. Designed for the use in HTML5-based cross-platform hybrid games and other applications.

    Features

    Platforms supported:

    • [ ] Amazon-FireOS, via Android SDK (part of Google Play service)
    • [x] Android, via Android SDK (part of Google Play service)
    • [ ] iOS
    • [ ] Windows Phone

    Ad Types:

    • [x] Banner
    • [x] Interstitial (picture, video), highly recommended. 🔥
    • [x] Reward Video, highly recommended. 🔥
    • [ ] Native Ads (on roadmap)
    • [ ] Native Ads Advanced (on roadmap)

    Quick Demo

    Wanna quickly see the mobile ad on your simulator or device? Try the following commands.

        # install cordova CLI
        [sudo] npm install cordova -g
    
        # install a small utility to run all the commands for you
        [sudo] npm install plugin-verify -g
    
        # Demo: run tapsell plus demo with sample index.html
        plugin-verify tapsell-plus-cordova-plugin

    Quick start

    	# create a demo project
        cordova create test1 com.miladesign.tapsellplus Test1
        cd test1
        cordova platform add android
    
        # now add the plugin, cordova CLI will handle dependency automatically
        cordova plugin add tapsell-plus-cordova-plugin
    
        # now remove the default www content, copy the demo html file to www
        rm -r www/*;
        cp plugins/tapsell-plus-cordova-plugin/test/* www/;
    
    	# now build and run the demo in your device or emulator
        cordova prepare; 
        cordova run android;
        # or import into eclipse

    Installation

    • If use with Cordova CLI:
    cordova plugin add tapsell-plus-cordova-plugin
    • If use with PhoneGap Build:
    <plugin name="tapsell-plus-cordova-plugin" source="npm"></plugin>

    Notice:

    • If build locally using tapsell-plus-cordova-plugin, to avoid build error, you need install some extras in Android SDK manager (type android sdk to launch it): android extra

    Usage

    Show Mobile Ad with single line of javascript code.

    Step 1: Create new application, in Tapsell portal, then write it in your javascript code.

    TapsellPlus.initialize('AppKey');

    Step 2: Want cheap and basic banner? single line of javascript code.

    // it will display small banner at top center, using the default options
    TapsellPlus.createBanner(zoneId, TapsellPlus.AD_POSITION.TOP_CENTER, TapsellPlus.AD_SIZE.BANNER_320x50);

    Step 3: Want interstitial Ad to earn more money ? Easy, 2 lines of code.

    // preppare and load ad resource in background, e.g. at begining of game level
    TapsellPlus.requestInterstitial(zoneId);
    
    // show the interstitial later, e.g. at end of game level
    TapsellPlus.showInterstitial(zoneId);

    Step 4: Want rewarded video Ad to earn more money ? Easy, 2 lines of code.

    // preppare and load ad resource in background, e.g. at begining of game level
    TapsellPlus.requestRewardedVideo(zoneId);
    
    // show the interstitial later, e.g. at end of game level
    TapsellPlus.showRewardedVideo(zoneId);

    API

    Methods:

    // initialize plugin
    initialize(appKey);
    
    // use banner
    createBanner(zoneId, position, size);
    createBannerAtXY(zoneId, x, y, size);
    removeBanner();
    showBanner();
    hideBanner();
    
    // use interstitial
    requestInterstitial(zoneId);
    showInterstitial(backDisabled);
    
    // use rewarded video
    requestRewardedVideo(zoneId);
    showRewardedVideo(backDisabled);

    Events:

    // response (on Ad Available)
    // error (on NoAd Available)
    // onError
    // onOpened
    // onClosed
    // onRewarded
    document.addEventListener('response', function(e){
        var data = e.detail || e.data || e;
    	
    	consoleLog("response. adType: " + data.adType);
    });

    Wiki and Docs

    Quick start, simply copy & paste:

    API Reference:

    Other Documentations:

    Screenshots

    Android Banner Android Interstitial Android Rewarded Video
    ScreenShot ScreenShot ScreenShot

    License

    You can use the plugin for free, or you can also pay to get a license. IMPORTANT!!! Before using the plugin, please read the following content and accept the agreement. THIS WILL AVOID POTENTIAL PROBLEM AND DISPUTE.

    There are 3 license options, fully up to you:

    1. Free and Open Source, no support
    2. Commercial, with email/skype support
    3. Win-win partnership, with forum support

    Credits

    This project is created and maintained by Milad Mohammadi Rezagah.

    More Cordova/PhoneGap plugins by Milad Mohammadi Rezagah, find them in plugin registry, or find them in npm.

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

    Install

    npm i tapsell-plus-cordova-plugin

    DownloadsWeekly Downloads

    1

    Version

    1.2.3

    License

    MIT

    Unpacked Size

    1.83 MB

    Total Files

    14

    Last publish

    Collaborators

    • avatar