Skip to content

Get started

This get started guide will walk you through integrating the Google Mobile Ads into your Unreal project, and then displaying your first ad with it! Here we will focus on an interstitial ad, but detailed guides on implementing different ad formats will be linked at the bottom of the page.

Set up your app in your AdMob account

Register your app as an AdMob app by completing the following steps:

  1. Sign in to or sign up for an AdMob account.
  2. Register your app with AdMob. This step creates an AdMob app with a unique AdMob App ID that is needed later in this guide.

Configure your project

Enable the plugin

The plugin is typically enabled by default upon installation. However, if it's not, follow these steps:

  1. Navigate to Edit > Plugins in Unreal Engine.
  2. Search for Google AdMob in the plugin list.
  3. If the plugin is disabled, enable it by checking the corresponding box.

Disable build-in AdMob support for ads

To avoid any compatibility issues and library conflicts, disable build-in AdMob support. Inside Project Settings, go to Platforms > Android > Google Play Services and set Include AdMob support for ads to false.

Disable build-in AdMob support

Enter your App IDs in Project Settings

  1. Copy your AdMob app ID, as identified in the AdMob web interface. You'll need to separate AdMob apps for Android and iOS, i.e. two different App IDs for these platforms.
  2. Open Project Settings > Plugins > Google AdMob in Unreal Engine, and paste the copied values into the corresponding AdMob App ID fields.

AdMob App ID fields example

Enable automatic SDK initialization

Typically, you would want manual control over Privacy & Messaging in your game (it's even required in some cases!), but for this tutorial we are going to ask plugin to attempt initializing Google AdMob SDK automatically on game's start-up. Once again, go to Project Settings > Plugins > Google AdMob, and set the Enable automatic SDK initialization on startup field to true (it's disabled be default).

Enable automatic SDK initialization on startup

Add dependency to your modules (C++ projects)

To use the plugin in your C++ code, you must include GoogleAdMob as either a public or private dependency in your module's build configuration, for example: 

PrivateDependencyModuleNames.Add("GoogleAdMob");

Implement your first ad

Now you're ready to add your first interstitial ad to your game! Follow the steps below to make it a reality!

  1. Create an interstitial ad object and store it in a variable. In Blueprints, add a Construct Object from Class node and choose UGoogleAdMobInterstitialAd as a class to create the object from. Think of it as a communication interface between your Unreal project and Google AdMob.

    // In header file:
class UGoogleAdMobInterstitialAd;
// ...
UPROPERTY()
TObjectPtr<UGoogleAdMobInterstitialAd> InterstitialAd;

// In source file:
#include "GoogleAdMobInterstitialAd.h"
// ...
InterstitialAd = NewObject<UGoogleAdMobInterstitialAd>(this);

    Tip

    It's generally recommended to keep your ads in a class/blueprint derived from PlatformGameInstance, as they often need to persist between levels.

  2. Check if ads can be requested. Before loading any ads, you should first check if the consent has been gathered from a user using the UGoogleAdMob::CanRequestAds() function.

    // In header file:
class UGoogleAdMobInterstitialAd;
// ...
UPROPERTY()
TObjectPtr<UGoogleAdMobInterstitialAd> InterstitialAd;

// In source file:
#include "GoogleAdMobInterstitialAd.h"
#include "GoogleAdMob.h"
// ...
InterstitialAd = NewObject<UGoogleAdMobInterstitialAd>(this);
// ...
if (UGoogleAdMob::CanRequestAds()) 
{
    // ...
}

  3. Bind an event to the ad being loaded. Prior to loading the ad, you should also bind some event to the OnLoaded multicast delegate, so that you know when your ad is loaded and is ready to be shown.

    // In header file:
class UGoogleAdMobInterstitialAd;
struct FGoogleAdMobResponseInfo;
// ...
UPROPERTY()
TObjectPtr<UGoogleAdMobInterstitialAd> InterstitialAd;

UFUNCTION()
void InterstitialAdLoaded(const FGoogleAdMobResponseInfo& ResponseInfo);

// In source file:
#include "GoogleAdMobInterstitialAd.h"
#include "GoogleAdMob.h"
#include "GoogleAdMobResponseInfo.h"
// ...
void UYourClass::InterstitialAdLoaded(const FGoogleAdMobResponseInfo& ResponseInfo) 
{      
}
// ...
InterstitialAd = NewObject<UGoogleAdMobInterstitialAd>(this);
// ...
if (UGoogleAdMob::CanRequestAds()) 
{
    InterstitialAd->OnLoaded.AddDynamic(this, &UYourClass::InterstitialAdLoaded);
}

  4. Load the ad. Now you can finally load your ad by calling UGoogleAdMobInterstitialAd::Load(const FString& AdUnitID) function! Just remember that the function must be called on the created ad object (i.e. the function won't appear in Blueprints unless the context menu is shown after dragging the pin from this object), and that there are two different Ad Unit IDs for Android and iOS.

    // In header file:
class UGoogleAdMobInterstitialAd;
struct FGoogleAdMobResponseInfo;
// ...
UPROPERTY()
TObjectPtr<UGoogleAdMobInterstitialAd> InterstitialAd;

UFUNCTION()
void InterstitialAdLoaded(const FGoogleAdMobResponseInfo& ResponseInfo);

// In source file:
#include "GoogleAdMobInterstitialAd.h"
#include "GoogleAdMob.h"
#include "GoogleAdMobResponseInfo.h"
// ...
void UYourClass::InterstitialAdLoaded(const FGoogleAdMobResponseInfo& ResponseInfo) 
{      
}
// ...
InterstitialAd = NewObject<UGoogleAdMobInterstitialAd>(this);
// ...
if (UGoogleAdMob::CanRequestAds()) 
{
    InterstitialAd->OnLoaded.AddDynamic(this, &UYourClass::InterstitialAdLoaded);
#if PLATFORM_ANDROID
    InterstitialAd->Load(TEXT("ca-app-pub-3940256099942544/1033173712"));
#elif PLATFORM_IOS
    InterstitialAd->Load(TEXT("ca-app-pub-3940256099942544/4411468910"));
#endif
}

  5. Show your interstitial ad. The last step here is obviously showing your ad when it's loaded. Just call UGoogleAdMobInterstitialAd::Show() when the OnLoaded delegate is broadcast, and you're done!

    // In header file:
class UGoogleAdMobInterstitialAd;
struct FGoogleAdMobResponseInfo;
// ...
UPROPERTY()
TObjectPtr<UGoogleAdMobInterstitialAd> InterstitialAd;

UFUNCTION()
void InterstitialAdLoaded(const FGoogleAdMobResponseInfo& ResponseInfo);

// In source file:
#include "GoogleAdMobInterstitialAd.h"
#include "GoogleAdMob.h"
#include "GoogleAdMobResponseInfo.h"
// ...
void UYourClass::InterstitialAdLoaded(const FGoogleAdMobResponseInfo& ResponseInfo) 
{     
    InterstitialAd->Show(); 
}
// ...
InterstitialAd = NewObject<UGoogleAdMobInterstitialAd>(this);
// ...
if (UGoogleAdMob::CanRequestAds()) 
{
    InterstitialAd->OnLoaded.AddDynamic(this, &UYourClass::InterstitialAdLoaded);
#if PLATFORM_ANDROID
    InterstitialAd->Load(TEXT("ca-app-pub-3940256099942544/1033173712"));
#elif PLATFORM_IOS
    InterstitialAd->Load(TEXT("ca-app-pub-3940256099942544/4411468910"));
#endif
}

Congratilations! You've successfully loaded your first interstitial ad! It might seem a bit overwhelming at first, but once you get it, this plugin will become a powerful tool in your developer hands, and will help you implement a robust mobile ad system in your game. Go on and check out what other features it has to offer!

Select an ad format

Google Mobile Ads SDK is now imported and you're ready to implement other ads. AdMob offers a number of different ad formats, so you can choose the one that best fits your app's user experience.

Banner ad units display rectangular ads that occupy a portion of an app's layout. They can refresh automatically after a set period of time. This means users view a new ad at regular intervals, even if they stay on the same screen in your app. They're also the simplest ad format to implement.

Implement banner ads

Interstitial

Interstitial ad units show full-page ads in your app. Place them at natural breaks and transitions in your app's interface, such as after level completion in a gaming app.

Implement interstitial ads

Rewarded

Rewarded ad units enable users to play games, take surveys, or watch videos to earn in-app rewards, such as coins, extra lives, or points. You can set different rewards for different ad units, and specify the reward values and items the user received.

Implement rewarded ads

Rewarded interstitial

Rewarded interstitial is a new type of incentivized ad format that lets you offer rewards, such as coins or extra lives, for ads that appear automatically during natural app transitions.

Unlike rewarded ads, users aren't required to opt in to view a rewarded interstitial.

Instead of the opt-in prompt in rewarded ads, rewarded interstitials require an intro screen that announces the reward and gives users a chance to opt out if they want to do so.

Implement rewarded interstitial ads

App open

App open is an ad format that appears when users open or switch back to your app. The ad overlays the loading screen.

Implement app open ads

Sample projects