Gideros Integration Guide


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

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


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


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

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

Use your Kiip 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 Kiip successfully.

Need Help?

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