Godot AdMob Android

A Godot's plugin for Android of AdMob.

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 3.x to 4.x (when it is released), and also make the code compatible on Android and iOS, so each advertisement will work identically on both systems.

_(Preview)

Features

Ad Formats	Available 🤖
Banner	✔️
Interstitial	✔️
Rewarded	✔️
Rewarded Interstitial	✔️
Native is REMOVED	❗

Others	Available 🤖
EU consent	✔️
Targeting	✔️
Mediation	❌
CI/CD	✔️

Installation

First of all you need to install the AdMob Editor Plugin, you can download direcly from Godot Assets.

Android (v3.2.2+):

Tutorial: https://youtu.be/ZnlH3INcAGs
Download the android-?-template-v{{ your_godot_version }}.zip in the releases tab, we recommend you to use always the latest.
Enable Android Build Template. Check the tutorial here
Extract the content in android-?-template-v{{ your_godot_version }}.zip into res://android/plugins directory on your Godot project
Add your AdMob App ID to your app's res://android/build/AndroidManifest.xml file by adding a <meta-data> tag with name com.google.android.gms.ads.APPLICATION_ID, as shown below.

<!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
<meta-data
	tools:replace="android:value"
	android:name="com.google.android.gms.ads.APPLICATION_ID"
	android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

(Optional) If you are using UMP, you can add too the Delay app measurement inside AndroidManifest.xml

<meta-data
	android:name="com.google.android.gms.ads.DELAY_APP_MEASUREMENT_INIT"
	android:value="true"/>

Export the project enabling the Use Custom Build and AdMob Plugin:

iOS (v3.3+):

https://github.com/Poing-Studios/godot-admob-ios

User Messaging Platform (UMP):

To use UMP due of EUROPE ePrivacy Directive and the General Data Protection Regulation (GDPR), you first need to do configure your Funding Choices.
If your app is "ForChildDirectedTreatment" then the UMP won't appear and signals won't work for consent, this is normal so don't worry.
To show personalized or non-personalized ads, then you need to change inside your AdMob Account

Documentation

For a complete documentation of this Plugin, check our wiki.

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

Contribute

We are a dedicated area to how contribute for Android and iOS on our wiki.

hurryerman / godot-admob-android Goto Github PK