Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/poingstudios/godot-admob-ios
Godot's AdMob Plugin for iOS with support for Mediations.
https://github.com/poingstudios/godot-admob-ios
admob admob-demo gdscript github-actions godot godot-admob godot-engine ios mediation objective-c-plus-plus plugin ump
Last synced: about 18 hours ago
JSON representation
Godot's AdMob Plugin for iOS with support for Mediations.
- Host: GitHub
- URL: https://github.com/poingstudios/godot-admob-ios
- Owner: poingstudios
- License: mit
- Created: 2021-06-18T02:14:00.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-08-16T01:19:26.000Z (3 months ago)
- Last Synced: 2024-08-23T15:30:15.023Z (3 months ago)
- Topics: admob, admob-demo, gdscript, github-actions, godot, godot-admob, godot-engine, ios, mediation, objective-c-plus-plus, plugin, ump
- Language: Objective-C++
- Homepage: https://poingstudios.github.io/godot-admob-plugin/
- Size: 589 KB
- Stars: 98
- Watchers: 4
- Forks: 14
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
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](https://github.com/PoingStudios/godot-admob-android) and iOS**, so each advertisement will work **identically on both systems**.
### 🔑 Key features
- It's a wrapper for [Google Mobile Ads SDK](https://developers.google.com/admob/ios/download). 🎁
- 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](https://github.com/PoingStudios/godot-admob-plugin), reducing the need for extensive coding. 🔌
- There is also an [Android Plugin](https://github.com/PoingStudios/godot-admob-android) available, which has the same behavior. 🤖
## 🙋♂️How to use
- We recommend you to use the [AdMob Plugin](https://github.com/PoingStudios/godot-admob-plugin), you can download direcly from [Godot Assets](https://godotengine.org/asset-library/asset/2063).
- After download, we recommend you to read the [README.md](https://github.com/PoingStudios/godot-admob-plugin/blob/master/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](https://github.com/PoingStudios/godot-admob-ios/releases). We recommend checking the [supported Godot version](https://github.com/PoingStudios/godot-admob-versions/blob/master/versions.json) before proceeding. You can also use the [AdMob Plugin](https://github.com/PoingStudios/godot-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](https://support.google.com/admob/answer/13420272?hl=en), 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](https://developers.google.com/admob/ios/choose-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:
```bash
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](https://github.com/godotengine/godot/issues/44681#issuecomment-751399783).
## 📎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](https://poingstudios.github.io/godot-admob-plugin/).
Alternatively, you can check the docs of AdMob itself of [iOS](https://developers.google.com/admob/ios/quick-start).
## 🙏 Support
If you find our work valuable and would like to support us, consider contributing via these platforms:
[](https://patreon.com/poingstudios)
[](https://ko-fi.com/poingstudios)
[](https://www.paypal.com/donate/?hosted_button_id=EBUVPEGF4BUR8)
Your support helps us continue to improve and maintain this plugin. Thank you for being a part of our community!
## 🆘Getting help
[](https://github.com/PoingStudios/godot-admob-ios/discussions)
[](https://discord.com/invite/YEPvYjSSMk)
## ⭐ Star History
If you appreciate our work, don't forget to give us a star on GitHub! ⭐
