Integrate with Enhance - Defold
Rewarded Ads
Rewarded Ads are usually full-screen video ads which users can view to receive a reward inside the app, like an additional in-game currency or a health bonus for example.
Example Usage
function show_ad()
if enhance.isRewardedAdReady() then
enhance.showRewardedAd(on_reward_granted, on_reward_declined, on_reward_unavailable)
end
end
function on_reward_granted(self, reward_value, reward_type)
if reward_type == "REWARDTYPE_ITEM" then
write_log("Reward granted (item)")
elseif reward_type == "REWARDTYPE_COINS" then
write_log("Reward granted (coins), value: " .. reward_value)
end
end
function on_reward_declined()
write_log("Reward declined")
end
function on_reward_unavailable()
write_log("Reward unavailable")
end
Methods
enhance.isRewardedAdReady
boolean enhance.isRewardedAdReady(
optional string placement = "default"
)
Parameters:
optional string placement
- Specifies the internal placement of the ad (from the Enhance mediation editor).
Return Value:
Returns true if any ad is ready, false otherwise. When app is not Enhanced, always returns true.
enhance.showRewardedAd
nil enhance.showRewardedAd(
optional string placement = "default",
function onRewardGrantedCallback,
function onRewardDeclinedCallback,
function onRewardUnavailableCallback
)
Parameters:
optional string placement
- Specifies the internal placement of the ad (from the Enhance mediation editor).
function onRewardGrantedCallback
- Called when an ad is finished and a reward is granted to the user. As parameters, this function will receive the reward's type, and its value as an integer (if applicable, depending on ad network's configuration). The type is either equal to "REWARDTYPE_ITEM" or "REWARDTYPE_COINS".
function onRewardDeclinedCallback
- Called when a reward is declined (e.g. user closed the ad before it finished displaying).
function onRewardUnavailableCallback
- Called when a reward is unavailable for an unknown reason and cannot be granted.