apprever.*

Type library
Revision 2014.2439
Keywords apprever, ads
Sample code
See also
Availability Starter, Basic, Pro, Enterprise

Overview

The AppRever plugin enables free app cross-promotion through banner ads and interstitial ads. We focus on app cross-promotion with an easy to use and a high performance system. Ads are served in order, every user sees every ad, none are favored. Ads are auto automatically pre-cached, ensuring that your app is never stalled while waiting for an ad.

Our core philosphy is to build your user base first, through cross-promotion. Monetization should come after you have grown your user base. We will soon feature unique monetization options as well.

Features include:
* Easy sign up. Once you register, you can upload an ad immediately. After approval, your ad will be served to our worldwide network. All you need is one ad size and the URLs to your app.
* Easy integration. Only 3 lines of code are needed to serve ads.
* Fast ad serving. Due to our caching, your app will never look bad, waiting for an ad to show up.
* Robust. If your user's internet goes down (or our server does), we will never crash your app and an ad will still be served.
* Animated ads. The animation of our banner ads increase click through rates to higher than industry standards.
* Interstitials with a message. The interstital version of your ad includes a marketing message.
* No redirects. When someone clicks on your ad, we take them straight to the URLs you provide. No redirects to annoy your user base.
* Install tracking. When someone clicks on your ad and later installs and uses your app, we track it.
* Real-time stats. Including gelocation (for WiFi users), time stamping, an optional message which can be used to track progress in your app, and much more to come. All in real-time.

Future enhancements as our network grows:
* Monetization. We are currently testing a variety of unique ideas for monetizing your app!
* Tiers. We will soon address the 'fairness' issue of some apps servng more than they receive by grouping like-performing apps together in smaller ad groups
* Enhanced analytics. We collect enough real-time data to soon offer very valuable analytics of your app's performance.
* Partnerships. We are creating partnerships with industry-leading companies that can get you more downloads!

We will offer premium services in the near future but all of our basic services will always be FREE!

Sign Up

To use AppRever, please sign up for an account. We will gladly serve your ads at no charge but we do expect you to serve ads for others by integrating our plugin.

Platforms

Syntax


    local apprever = require "plugin.apprever"

    apprever.initAppRever("YOUR_APPUID")    
        YOUR_APPUID will be emailed upon site registration

    apprever.requestInterstitial( [ {f=yourFunctionAfterClick} ])  
        Optional table, where yourFunctionAfterClick will be called after the ad is clicked.

    apprever.requestBannerAds({x=0, y = 0 [, w=width ,h=height,  m="yourMessage", a=1] }) 
        The table is required, with:
            x is the x location of the banner ad 
            y is the x location of the banner ad 
            w is the width of the banner ad 
            h is the height of the banner ad 
        Optionally:
            m is a message, such as which level generated the ad, to be shown in upcoming tables available to you on our site
            a = 1 for animated ads, a = 0 for no animation

Functions

Project Settings

SDK

When you build using the Corona Simulator, the server automatically takes care of integrating the plugin into your project.

All you need to do is add an entry into a plugins table of your build.settings. The following is an example of a minimal build.settings file:

    settings =
    {
    plugins =
    {
        -- key is the name passed to Lua's 'require()'
        ["plugin.apprever"] =
        {
            -- required
            publisherId = "com.apprever",
        },
    },      
   }

Sample Code

You can access sample code here.

Interstitials


    -- Call initAppRever in your main.lua
    apprever.initAppRever("xxxxyyyyzzzz")  -- use the APPUID you received when you registered

    -- do some other app things, then whenever you want a full screen ad:
    apprever.requestInterstitial()

Basic banner ads


    -- Call initAppRever in your main.lua
    apprever.initAppRever("xxxxyyyyzzzz")  -- use the APPUID you received when you registered

    -- So, do some other app things, then whenever you want a banner ad, set your width and height and:
    apprever.requestBannerAds( {x=0, y=0,  w=width, h=height, m="beat level 10", a=1} )

Scaling banner ads

Banner ads should be scaled up or down from 960x100 in landscape mode. They are automatically scaled down proprtionally for portrait mode on each ad request. So for a perfect fit on any device:


    local width = math.round((display.contentWidth-2*display.screenOriginX) / display.contentScaleX)    
    -- this scales proportionally to the 960x100 ad units currently used by AppRever
    local height = (width/960)*100     

    apprever.requestBannerAds( {x=0, y = 0, w=width, h=height, m="beat level 10", a=1} )    

Bottom banner ads

To place a banner ad at the bottom of your screen, simply calculate your actual screen height and set the y location in the function call as follows: ``````lua

local width = math.round((display.contentWidth-2*display.screenOriginX) / display.contentScaleX)

-- this scales proportionally to the 960x100 ad units currently used by AppRever
local height = (width/960)*100     

local actualScreenHeight = math.round((display.contentHeight-2*display.screenOriginY) / display.contentScaleY)

apprever.requestBannerAds( {x=0, y = actualScreenHeight-height,  w=width, h=height, m="beat level 10", a=1} )   

``````

Support

More support is available from the AppRever team: