README.md

Godot AdMob iOS

A Godot's plugin for iOS 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.1+, 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: Meta, Vungle. 💰
• CI/CD for streamlined development and deployment. 🔄🚀
• Features a dedicated Godot Plugin, reducing the need for extensive coding. 🔌
• There is also an Android Plugin available, which has the same behavior. 🤖

🙋‍♂️How to use

• We recommend you to use the AdMob Plugin, you can download direcly from Godot Assets.
• After download, we recommend you to read the README.md of the Plugin to know how to use.

📦Installing:

📥Download

• To get started, download the poing-godot-admob-ios-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 -> iOS -> LatestVersion.

🧑‍💻Usage

• Video tutorial: https://youtu.be/WpVGn7ZasKM.
• Inside poing-godot-admob-ios-v{{ your_godot_version }}.zip you downloaded, you will face some folders like 'ads', 'meta', 'vungle'. To AdMob works only 'ads' is required, but if you want Mediation, you need the other folders.
• Move the content inside the folder which you need into res://ios/plugins directory on your Godot project.
• Update the configuration in res://ios/plugins/poing-godot-admob-ads.gdip. The GADApplicationIdentifier is required to change when release your game.
• If you are using Mediation: On SKAdNetworkItems in .gdip file, you can remove the comments of the Mediations Networks which you are using.
• Export the project enabling the Ad Mob, if you have Mediation, also mark Ad Mob Meta, etc...

💻Xcode preparation

• Go to {{ ios_xcode_export_folder }}/{{your_project_name}}/ios/plugins/poing-godot-admob/scripts/ folder and open the terminal (must be inside this folder).
• Run the commands:

chmod +x update_and_install.sh
./update_and_install.sh

• This will create for your a {{ your_project_name }}.xcworkspace file on your {{ ios_xcode_export_folder }}, open this file.
• Go to the Target of your Application and them General -> Frameworks, Libraries, and Embedded Content and add all Pods in section.
• Run the Game.
• If you are trying to run on Simulator and is not working read this.

📎Useful links:

• 🦾 Godot Plugin: https://github.com/PoingStudios/godot-admob-plugin
• 🤖 Android: https://github.com/PoingStudios/godot-admob-android
• ⏳ Plugin for Godot below v4.1: https://github.com/PoingStudios/godot-admob-ios/tree/v2

📄Documentation

For a complete documentation of this Plugin: check here.

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

🙏 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

⭐ Star History

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