GodotAds
Godot all in one ads module for Android. (Customizable)
Tip
If you are using goodt 2.X copy build.gradle.template
and AndroidManifest.xml.template
from godot 3.1 (master branch) into $(GODOT_2_ROOT)/platform/android/
,
Cloning
cd ${GODOT_ROOT}/modules/
git clone https://github.com/FrogSquare/GodotAds GodotAds
git clone https://github.com/FrogSquare/GodotSql GodotSql
and you must configure your module by editing ${GODOT_ROOT}/modules/GodotAds/config.py
build = {
"admob" : True, # add org/godotengine/godot/AdMob to the engine.cfg
"adcolony" : True, # add org/godotengine/godot/GDAdColony to the engine.cfg
"chartboost" : True, # add org/godotengine/godot/GDChartboost to the engine.cfg
"vungle" : True, # add org/godotengine/godot/GDVungle to the engine.cfg
"mopub" : True, # add org/godotengine/godot/GDMopub to the engine.cfg
"unity_ads" : True, # add org/godotengine/godot/GDUnityAds to the engine.cfg
}
Setting up
sdk and dependency for (Chartboost and Vungle)
Download the sdk to ${GODOT_ROOT}/modules/GodotAds/libs/
Chartboost: Chartboost SDk Vungle: Vungle SDK UnityAds: Unity-ads SDK
Edit engine.cfg and add
[android]
modules="org/godotengine/godot/GodotAds,org/godotengine/godot/AdMob,org/godotengine/godot/GDAdColony,org/godotengine/godot/GDChartboost,org/godotengine/godot/GDVungle,org/godotengine/godot/GDMopub,org/godotengine/godot/GDUnityAds"
On (on 2.X)
var gdads = Globals.get_singleton("GodotAds")
gdads.init(get_instance_ID())
gdads.set_debug(boolean) # set true for logs
On 3.X (latest from git)
var gdads = Engine.get_singleton("GodotAds")
gdads.init(get_instance_id())
calling init()
on GodotAds
is optional.
Initialize AdMob
var AdMob = Globals.get_singleton("AdMob")
var _dict = Dictionary()
_dict["BannerAd"] = false
_dict["InterstitialAd"] = false
_dict["RewardedVideoAd"] = false
_dict["BannerGravity"] = "BOTTOM" # or TOP
_dict["BannerAdId"] = "your banner ad id"
_dict["InterstitialAdId"] = "your interstitial ad id"
_dict["RewardedVideoAdId"] = "rewarded video ad id"
AdMob.init(_dict, get_instance_ID())
Initialize AdColony
var AdColony = Globals.get_singleton("GDAdColony")
var _dict = Dictionary()
_dict["app_id"] = "adcolotn app id"
_dict["zone_ids"] = "adcolony interstitial zone ids" # (e.g) "jkedbciujdcoidcj,iyhfecujncuofevef,ikyvejcnilnuvel"
_dict["reward_ids"] = "adcolony rewarded zone id" # (e.g) "jkedbciujdcoidcj,iyhfecujncuofevef,ikyvejcnilnuvel"
_dict["dialog"] = true # or false
AdColony.init(_dict, get_instance_ID())
Initialize Chartboost
var Chartboost = Globals.get_singleton("GDChartboost")
var _dict = Dictionary()
_dict["app_id"] = "Your chartboost app id"
_dict["app_signature"] = "your chartboost signature"
Chartboost.init(_dict, get_instance_ID())
Initialize Vungle
var Vungle = Globals.get_singleton("GDVungle")
var _dict = Dictionary()
_dict["app_id"] = "your vungle app"
Vungle.init(_dict, get_instance_ID())
Initialize MoPub
var Mopub = Globals.get_singleton("GDMopub")
var _dict = Dictionary()
_dict["BannerAd"] = true
_dict["InterstitialAd"] = true
_dict["BannerGravity"] = "BOTTOM" # or TOP
_dict["BannerAdId"] = "your banner unit id"
_dict["InterstitialAdId"] = "your interstitial unit id"
Mopub.init(_dict, get_instance_ID())
Initialize UnityAds
var Unityads = Globals.get_singleton("GDUnityAds")
var _dict = Dictionary()
_dict["GameId"] = "Your game ID"
Unityads.init(_dict, get_instance_ID())
Callbacks
adding the callback funtion so we can recive event log/states from the module
func _receive_message (tag, from, key, value):
if tag == "GodotAds" and from == "AdMob":
if key == "AdMob_Banner" and value == "loaded":
# Show banner here.
API
AdMob
AdMob.show_banner_ad(true) # show banner ad
AdMob.show_banner_ad(false) # hide banner ad
AdMob.show_interstitial_ad() # Show Interstitial Ad
AdMob.show_rewarded_video() # Show Rewarded Ad
AdMob.is_rewarded_video_loaded()
AdColony
AdColony.show(String zone_id) # Show AdColony for the zone id
Chartboost
Chartboost.show_interstitial_ad()
Chartboost.show_rewarded_video()
Vungle
Vungle.show()
MoPub
AdMob.show_banner_ad(true) # show banner ad
AdMob.show_banner_ad(false) # hide banner ad
AdMob.show_interstitial_ad() # Show Interstitial Ad
Unity Ads
Unityads.show("Location id")
Log adb
adb -d logcat godot:V GoogleService:V FrogSquare:V DEBUG:V AndroidRuntime:V ValidateServiceOp:V *:S