Google AdMob integration

Integrate AdMob with Unity LevelPlay mediation by setting up AdMob ad units and configuring the integration in the LevelPlay dashboard.

読み終わるまでの所要時間 3 分

最終更新 1日前

重要

The following documentation discusses products or services (“Third-party Products”) not developed, owned, or operated by Unity. This information might be outdated or incomplete and is provided for your convenience. Your use of any Third-party Product is subject to its own terms. Unity makes no warranties regarding these products and isn't liable for any damages or losses arising from their use, including issues related to content, advertising, or materials from Third-party providers.

注

To view the adapter changelog for this mediation network, refer to Mediation Networks for Android.

This guide instructs you step-by-step on how to set AdMob and AdMob Native as live ad networks on Unity LevelPlay Mediation.

Prerequisites

Make sure you have correctly integrated LevelPlay SDK interstitial, rewarded or banner mediation in your application. Google Ad Manager ads are served using the AdMob SDK. As of AdMob SDK 7.69.0+, AdMob are using XCFramework. If you are using CocoaPods for your AdMob integration, make sure you have CocoaPods Version 1.9.0+. AdMob Supports Android Operating Systems Version 4.1 (API level 16) and up. The required Gradle Build Tool is 3.5.4.\ AdMob SDK supports iOS version 10+, and will server ads for users on iOS version 11+.

Step 1. Create an AdMob Account

To access AdMob’s banner and native ad inventory through Unity LevelPlay Mediation, you need to create an account with AdMob.
It’s recommended to adjust the time zone of your AdMob account to UTC to align with the ironSource platform. This will ensure accurate reporting. Learn more.

Step 2. Create an Application and Ad Zone in Admob

Next, you must add your app and set up Ad Zones in your AdMob account. AdMob does not allow setting up more than 3 ad zones of the same Ad Type in the same setup.
for example no more than three Rewarded ads are allowed for the mediation group.

Add Your App

Log into your AdMob account. On your dashboard, select Apps.
A modal will appear where you can either search for your app, add your app manually or simply select an existing app to monetize.
注
You'll need a unique AdMob application per platform (iOS + Android), just like your LevelPlay account.
Select interstitial, rewarded, banners, or native advanced (native ads for banners) as your ad unit format and enter the relevant details.

Interstitial

Ad Type: You can leave the two boxes checked as we support text, image, video, and rich media in interstitials.
Ad unit name: The recommended best practice is to name the ad unit intuitively so it will be easy to recognize as the ad unit you'll be serving AdMob Interstitials through Unity LevelPlay Mediation.

Rewarded ads

Ad unit name: The recommended best practice is to name the ad unit intuitively so it will be easy to recognize as the ad unit you'll be serving AdMob's Rewarded ads through Unity LevelPlay Mediation.

Banners

Ad Unit Name: The recommended best practice is to name the ad unit intuitively so it will be easy to recognize as the ad unit you'll be serving AdMob Banners Unity LevelPlay Mediation
eCPM floor - Enable and enter an eCPM value according to your country and waterfall strategy

重要

Automatic refresh: Select the "Do not refresh" option. (Reminder - you can control the refresh rate on the mediation platform)

Native Banners

Native ads for banners enables you to access native ad demand from Google AdMob. This means that you can increase banner performance by accessing both Google’s native and banner demand.

Ad unit name: Type a name that you are going to easily recognize
- Advanced settings: Select both Image and Video
- eCPM floor: Enable and enter an eCPM value according to your country and waterfall strategy

Now retrieve your App ID and Ad Unit ID and save them for later use. Then, select Done.

Step 3. Activate AdMob in Your LevelPlay Network Setup Module

Sign in to your Google account when setting up AdMob on the LevelPlay SDK Networks Setup page and the necessary parameters to run AdMob interstitials, rewarded, banners, and native ads will automatically be retrieved. There are a few pieces of data from your AdMob account which need to be inserted into your ironSource Network Setup Module in order for AdMob to work correctly with the LevelPlay SDK:

Data	Description
App ID	The unique ID assigned to your app on Admob's dashboard.
Ad Unit ID	The unique ID assigned to your app's ad unit on Admob's dashboard.
Client ID	The unique identifier that specifies the relationship between your account and the ad unit.
Client Secret	The secret key that pairs with the Client ID
Refresh Token	The refresh token the client application already received.

After you obtain this information, you must configure AdMob's Parameters in your LevelPlay Account. By adding the above information correctly, you will be able to take full advantage of AdMob's ad inventory and reporting data on Unity LevelPlay Mediation.

App ID To retrieve your App ID, go to Apps tab on the left side bar on Admob's platform and select App Settings. You will then see the application's settings, as well as the App ID.

Ad Unit ID To retrieve your Ad Unit ID, go to Apps tab on the left side bar on Admob's platform and select Ad Units. You will then see the application's ad units, as well as the Ad Unit ID.

Client ID and Client Secret
1. To retrieve your Client ID & Client Secret, go to Google's API Manager.
2. Select the API Project drop-down at the upper-left of the page, select Create a project or select the project you already created for this app. In the case you are creating a new project for this purpose, provide a Project name, Billing account and Location in the dialog box that appears and select Create.
3. In the left sidebar, select Credentials, then select the OAuth consent screen tab. On this page, provide a Product Name. Select Save.
4. In the left sidebar, select Dashboard**,** and go to ENABLE APIS AND SERVICES.
5. Next, enable the AdMob API.
6. Select the Credentials tab in the left sidebar. Select the Create Credentials drop-down and select OAuth client ID.
7. Select Web application, and provide a name for your app. In the fields below, you must enter https://developers.google.com/oauthplayground for at least one Authorized redirect URI. For example:
  - Authorized JavaScript origins:
```
https://YOUR_NAMESPACE **(Optional)**
```
  - Authorized redirect URI: https://developers.google.com/oauthplayground
8. Select Create, and you will be presented with your Client ID and Client Secret.
Refresh Token
1. To retrieve your Refresh Token, go to the OAuth 2.0 Playground.
2. Select the settings icon in the upper right corner. Uncheck the box labeled Force approval prompt and check Use your own OAuth credentials. Input your Client ID and Client Secret.

Next, in Step 1: Select & Authorize APIS, enter https://www.googleapis.com/auth/admob.report and select Authorize APIs.

Grant your project access to your AdMob data.
You should then receive the Authorization Code from Step 1 and will be able to select the Exchange authorization code for tokens button. Then you will get a Refresh token as well as an Access Token.

Configure AdMob Parameters in your LevelPlay Account

After you have all of these parameters, log in to your ironSource account and go to Monetize > SETUP > SDK Networks.

Select Admob from the list of Manage Networks and enter the Admob Client ID, Client Secret and Refresh Token or select the Login with Google option.

Select Save. AdMob and AdMob Native will then be enabled in the Available Ad Networks table.

Next, select the app on which you'd like to run Unity LevelPlay's Mediation with AdMob.
Select Admob from the Setup list of Ad Networks and select the tool Define icon. Then insert the App ID and Ad Unit ID under Interstitial, Rewarded ads Video or Banner Settings.

Verify your integration with the Reporting API; this column will check your integration through the Reporting API and return three possible responses: Verified, Failed and No Response. Double check your integration and the information you entered above; then select Retry until you see Verified.

Step 4. Add the Admob Adapter to Your Build

重要

As of V17.0.0 (Adapter version 4.3.1 onwards), AdMob’s SDK requires publishers to add their AdMob App ID to the app’s AndroidManifest as a child of the

<application/>

tag:


<meta-data android:name="com.google.android.gms.ads.APPLICATION_ID"            android:value="[ADMOB_APP_ID]"/>

Replace the “[ADMOB_APP_ID]” with the APP ID value you retrieve in step 3.

Make sure you have the following lines inside allprojects > repositories block


allprojects {    repositories {       flatDir {           dirs 'libs'       }       google()    }}

Add the following dependency into the dependencies block


dependencies {    implementation fileTree(dir: 'libs', include: ['*.jar'])}

LevelPlay SDK supports both Gradle dependencies and manual download mechanisms.

Integrate the Admob Adapter with Gradle

Make sure the following Maven URL exist in your build.gradle script of your app module (should appear only once for all the adapters).


repositories {    google()    mavenCentral()}

Add the adapter’s Maven name to your build.gradle script of your app module:


dependencies {    implementation 'com.unity3d.ads-mediation:admob-adapter:5.11.0'    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'}

Integrate the Admob Adapter through Manual Download

Download the Admob Adapter:
Add the Admob Adapter to your build. You can find the latest Admob Adapter here. Important! The Admob Adapter Does not contain the Admob SDK. You need to additionally add the Admob SDK directly.
Add the Admob Adapter to your Project:
After you download the Adapter; drop the Admob Adapter jar into the libs folder in your Android Project.
Make sure you add the following to your Gradle build file under the dependencies section:


dependencies {    implementation 'com.unity3d.ads-mediation:admob-adapter:5.11.0'    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'}

Step 5. Update AndroidManifest.xml

As of LevelPlay Android SDK Version 6.17.0 (AdMob Android adapter version 4.3.10+), AdMob adapter will be released as AAR. Only if you intend to keep your Jar integration, add the manifest.

Manifest Permissions


<uses-permission android:name="android.permission.INTERNET"/><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

Manifest Activities

Add the following activities inside the <application> tag on your manifestAdditions:


<activity android:name="com.google.android.gms.ads.AdActivity"android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize" android:theme="@android:style/Theme.Translucent" />

As of V17.0.0 (Adapter version 4.3.1 onwards), AdMob’s SDK requires publishers to add their AdMob App ID to the app’s AndroidManifest as a child of the

<application></application>

tag:


<meta-data android:name="com.google.android.gms.ads.APPLICATION_ID"android:value="[ADMOB_APP_ID]"/>

Replace the “[ADMOB_APP_ID]” with the APP ID value you retrieved in step 3. Not doing so results in crashes originated with AdMob’s SDK. For more information, refer to AdMob’s guide.

Step 6. Additional Steps

Child-directed setting – COPPA

Unity LevelPlay mediation lets publishers communicate AdMob Child-directed settings directly to the AdMob network. This feature is enabled using LevelPlay SDK 6.14.0+, AdMob Android Adapter 4.3.9+. Use the following syntax, to set AdMob setTagForChildDirectedTreatment with the parameter TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE:


LevelPlay.setMetaData("AdMob_TFCD","true");

Use the following syntax, to set AdMob setTagForChildDirectedTreatment with the parameter TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE:


LevelPlay.setMetaData("AdMob_TFCD","false");

To learn more about Child-directed settings under the AdMob network, visit here. Unity LevelPlay mediation lets publishers communicate with AdMob network, a Tag For Users under the Age of Consent in Europe (TFUA) request. This feature is enabled using LevelPlay SDK 6.14.0+, AdMob Android Adapter 4.3.9+. Use the following syntax, to set setTagForUnderAgeOfConsent with TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE:


LevelPlay.setMetaData("AdMob_TFUA","true");

Use the following syntax, to set setTagForUnderAgeOfConsent with TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE:


LevelPlay.setMetaData("AdMob_TFUA","false");

To learn more about Child-directed settings under the AdMob network, visit here.

Ad Content filtering

Unity LevelPlay mediation lets publishers communicate with AdMob network, maximum ad content rating for all ad requests. This feature is enabled using LevelPlay SDK 7.12.0+, AdMob Android Adapter 4.3.23+. Use the following syntax, to set maxAdContentRating:


LevelPlay.setMetaData("AdMob_MaxContentRating","MAX_AD_CONTENT_RATING_G");

The possible values for this property are based on digital content label classification as defined by Google:

MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA

To learn more about Ad Content Rating property Under AdMob network visit here.

Content URL mapping support

Unity LevelPlay supports Google’s content mapping for apps, and allows you to share URLs using “Google_Content_Mapping” settings. This feature is enabled using LevelPlay SDK 7.7.0+, AdMob Adapter 4.3.41+. Learn more about Google’s content mapping here. To pass a single-content URL, use the following syntax:


LevelPlay.setMetaData("Google_Content_Mapping","https://www.example.com");

To support multiple urls, use the same key and share up to 4 URLs:


LevelPlay.setMetaData("Google_Content_Mapping",["https://www.example1.com","https://www.example2.com"]);

Verify Your Ad Network Integration

To verify your LevelPlay and additional Ad Networks’ integration, follow this document.

Next steps

To leverage additional ad networks through Unity LevelPlay, integrate the adapters and follow our integration guides.