Skip to content

MMaurice256/chartboost-android-plugin-godot-3.2.2

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CHARTBOOST ADS-SDK (v8.1.0) ANDROID PLUGIN FOR GODOT ENGINE v3.2.2

This is a plugin for Android projects powered by Godot 3.2.2. For other versions of Godot, please check other similar repositories.

About the plugin

This plugin uses Chartboost sdk to allow your Godot project support:

  • Intersitial ads
  • Rewarded Video ads This plugin does NOT support banner ads. Please refer to the official Chartboost documentation for more info. Also feel free to communicate or contribute. I hope you find this useful.

About Chartboost

  • Since 2011, Chartboost is a leading in-app programmatic advertising and monetization platform.
  • Can be used in both games and non-game applications.
  • Used by many featured and popular games and development studios.
  • High quality ads with well designed imagery.
  • For more, visit there website at https://www.chartboost.com

How to use

  1. Download the plugin https://github.com/MMaurice256/chartboost-android-plugin-godot-3.2.2/releases/tag/v1.0
  2. Open your project with Godot Engine v3.2.2.
  3. Enable custom build in your Android export settings.
  4. If you have not yet installed an Android Build Template into your project, you should.
  5. Then close the Godot Engine, and first manually add this plugin's required files to your project.
  6. Navigate to your Godot project folder, this is where your project files are located.
  7. Copy this pulgin's chartboost-godot-class folder and paste it into your Godot project folder.
  8. Open the "android" folder in your project, which is the Android Build Template, and locate plugins folder.
  9. Copy this plugin's GodotChartboost.release.aar and GodotChartboost.release.gdap and paste in plugins.
  10. Open Godot Engine, then select and load your project.
  11. You can now add the Chartboost node if chartboost-godot-class was added correctly.
  12. You can also select Chartboost plugin in the Android Export menu if the .aar and .gdap files were setup.
  13. Android plugins require you to enable "custom build" option, and (obviously) they will only work on Android.
  14. Be sure to ENABLE TESTING MODE in your Chartboost Admin Panel to avoid testing with real ads.
  15. Use the Admin Panel to get your App-Id and App-Signature. And paste them in your Chartboost node properties.
  16. One rule, avoid adding more than one Chartboost node in the same scene! Let one node reference the ads-sdk.
  17. When building your project, Gradle might require an active internet connection to download some dependencies.
  18. Happy programming!

Helpful Tips

  • Targetted ads tend to make more revenue, so consider turning them on by default.
  • Enable ad-targetting (targetted ads) using setPIDataUseConsent(true) as used in the Godot class provided.
  • Disable ad-targetting (targetted ads) using setPIDataUseConsent(false) as used in the Godot class provided.
  • Offer an option to turn off targetted ads (opt-out) in your game settings and save that value for later usage.
  • Targetted ads must be disabled if your app is meant for/directed towards children. This is a GDPR rule.
  • Rewarded videos offer the best consumer experience. Avoid forcing ads on users.
  • Do not depend entirely on ad-revenue, also consider adding In-App purchases. Diversify revenue sources.

Donate

Satisfied? Feel like making a donation? Use the links provided below and special thanks:

References

Based on similar work done by https://github.com/Shin-NiL/Godot-Android-Admob-Plugin

Disclaimer

I do NOT work for or represent Chartboost in any way, manner or form. This is a plugin that was initially developed for personal projects that use the Godot Engine.

License

MIT license