Gideros Integration Guide


NinthDecimal can be used directly within your Gideros implementation using the Ads plugin within Gideros Studio.

Note: Due to GDPR regulations, NinthDecimal is now blocking all ad requests from the affected EEA regions.


NinthDecimal support is available for Gideros Mobile since version 2017.3. To enable NinthDecimal, enable the Gideros Ads plugin in export dialog, then tick ‘Enable NinthDecimal support’ checkbox. Supply NinthDecimal App Keys (found in the NinthDecimal Dashboard) for your target platforms, and that’s all.


NinthDecimal moments are managed through Gideros generic Ads API. Create an Ads instance for NinthDecimal with the folowing code:

require "ads"
ads ="kiip")
ads:setKey("<secret key>") -- replace with your app's secret key

Use your NinthDecimal moment name as the ‘ad type’ parameter in further calls to the Ads API.

Example code:

require "ads"

ads ="kiip")
ads:setKey("<secret key>") -- replace with your app's secret key
ads:enableTesting() -- Required for test mode, remove this for production

ads:addEventListener(Event.AD_DISPLAYED, function()
    print("ads AD_DISPLAYED")

ads:addEventListener(Event.AD_RECEIVED, function()
    print("ads AD_RECEIVED")

ads:addEventListener(Event.AD_FAILED, function(e)
    print("ads AD_FAILED", e.error)

ads:addEventListener(Event.AD_ACTION_BEGIN, function()
    print("ads AD_ACTION_BEGIN")

ads:addEventListener(Event.AD_ACTION_END, function()
    print("ads AD_ACTION_END")

ads:addEventListener(Event.AD_DISMISSED, function()
    print("ads AD_DISMISSED")

ads:addEventListener(Event.AD_ERROR, function(e)
    print("ads AD_ERROR", e.error)

ads:addEventListener(Event.AD_REWARDED, function(e)
    print("ads AD_REWARDED",e.amount)

local function onVideo(btn, event)
    if btn:hitTestPoint(event.x, event.y)then
        ads:showAd("interstitial") -- Use your kiip moment name here

video =, "VIDEO")
video:addEventListener(Event.MOUSE_DOWN, onVideo, video)
video:setScale(5, 5)
video:setPosition(10, 200)

Trouble with test rewards?

If your test device is not located in the US and you’re having trouble retrieving a test reward, please use a VPN with set to a US location.

VPN Assistance

We’re aware of occurances where developers using a US-based VPN experience IP leakage which prevents them from seeing test rewards. We suggest using a service like or a similar service to detect potential IP leaks to ensure you can test NinthDecimal successfully.

Need Help?

We’re happy to answer any questions about integrating NinthDecimal. Please email us.