Godot AdMob Android

A Godot's plugin for Android of AdMob.

About • How to use • Docs • Downloads

❓ About

This repository is for a Godot Engine Plugin that allows showing the ads offered by AdMob in an easy way, without worrying about the building or version, just download and use.

The purpose of this plugin is to always keep up to date with Godot, supporting ALMOST ALL versions from v4.2+, and also make the code compatible on Android and iOS, so each advertisement will work identically on both systems.

🔑 Key features

• It's a wrapper for Google Mobile Ads SDK. 🎁
• Easy Configuration. 😀
• Supports nearly all Ad Formats: Banner, Interstitial, Rewarded, Rewarded Interstitial. 📺
• GDPR Compliance with UMP Support. ✉️
• Targeting Capabilities. 🎯
• Seamless integration with Mediation partners: AdColony, Meta, Vungle. 💰
• CI/CD for streamlined development and deployment. 🔄🚀
• Features a dedicated Godot Plugin, reducing the need for extensive coding. 🔌
• There is also an iOS plugin available, which has the same behavior. 🍎

🙋‍♂️How to use

• Video tutorial: https://youtu.be/WpVGn7ZasKM.
• Download AdMob Plugin, you can download directly from Godot Assets.
• After download, we recommend you to read the README.md of the Plugin to know how to use.
• Add your AdMob App ID to your app's res://addons/admob/android/config.gd script by changing APPLICATION_ID const.

📦 Manual Installation:

📥Download

• To get started, download the poing-godot-admob-android-v{{ your_godot_version }}.zip file from the releases tab. We recommend checking the supported Godot version before proceeding. You can also use the AdMob Plugin for this step by navigating to Tools -> AdMob Download Manager -> Android -> LatestVersion.

🧑‍💻Usage

• Enable Android Build Template. Check the tutorial here.
• Extract the .zip and paste the content inside your res://addons/admob/android/bin/ folder in your Godot project.

📎Useful links:

• 🦾 Godot Plugin: https://github.com/poingstudios/godot-admob-plugin
• 🍏 iOS: https://github.com/poingstudios/godot-admob-ios
• ⏳ Plugin for Godot below v4.1: https://github.com/poingstudios/godot-admob-android/tree/v2
• ⏱️ For strictly Godot v4.1 version use the v3.0.x versions, recommended: https://github.com/poingstudios/godot-admob-android/releases/tag/v3.0.6

📄Documentation

For a complete documentation of this Plugin: check here.

Alternatively, you can check the docs of AdMob itself of Android.

🙏 Support

If you find our work valuable and would like to support us, consider contributing via these platforms:

Your support helps us continue to improve and maintain this plugin. Thank you for being a part of our community!

🆘Getting help

Development

All scripts must be executed within the project root folder

Downloading

Clear Download & Build Script:

Unix (Linux & MacOS):

./scripts/unix/clean_build.sh 4.6.0

Windows:

./scripts/windows/clean_build.ps1 4.6.0

Just Download:

Unix (Linux & MacOS):

./scripts/unix/download_godot.sh 4.6.0

Windows:

./scripts/windows/download_godot.ps1 4.6.0

Building, Exporting, Zipping

Just Build:

./gradlew build

Export files:

./gradlew exportFiles -PpluginExportPath=D:\godot-admob-editor\android\plugins

Build and exporting plugin files into the desired directory:

./gradlew build ; ./gradlew exportFiles -PpluginExportPath=D:\godot-admob-editor\android\plugins

Zip:

(-PgodotVersion is optional)

./gradlew zipPlugins -PgodotVersion=4.6.0

Logging

If you are having some issues with crashing or any expected behavior, you can easily get the log of the plugin with ADB:

Logcat AdMob Plugin & Godot (recommended)

adb logcat -s poing-godot-admob godot

Logcat AdMob Plugin

adb logcat -s poing-godot-admob

Logcat Godot

adb logcat -s godot

⭐ Star History

If you appreciate our work, don't forget to give us a star on GitHub! ⭐