Google Ad Manager integration guide

Follow these instructions to set Google Ad Manager live as an ad network on the ironSource mediation platform.

Before you start Make sure you have correctly integrated ironSource’s interstitial, rewarded video or banner mediation in your application.

Google Ad Manager ads are served using the AdMob SDK.


Step 1. Create a Google Ad Manager account

To access Google Ad Manager ad inventory through ironSource‘s mediation platform, create an Ad Manager account.

Step 2. Create an application and ad units in Google Ad Manager

Add your app and set up Ad units in your Ad Manager account. You can find all the information you need here.

Step 3. Activate Google Ad Manager in your ironSource account

Sign in to your Google account when setting up Ad Manager on the ironSource SDK Networks Setup page. This will ensure that all of the necessary parameters to run Ad Manager’s interstitials, rewarded videos, and banners will be automatically retrieved.

  1. In your Google Ad Manager account, obtain the following information
App ID The unique ID assigned to your app on the Ad Manager dashboard
API Key The unique identifier for your Ad Manager account. This allows the ironSource Mediation Platform to import performance data from your Ad Manager account to use in reporting and optimization
Ad Unit ID The unique ID assigned to your app’s ad unit on the Ad Manager dashboard
Client ID The unique identifier that specifies the relationship between your account and the ad unit
Client Secret The unique identifier that specifies the relationship between your account and the ad unit
Refresh Token The refresh token the client application already received

     2. Configure Google Ad Manager’s parameters in your ironSource account.

  • Log in to your ironSource account and go to ‘Monetize‘ ➣ ‘SETUP‘ ➣ ‘SDK Networks‘.

  • Select Google Ad Manager from the list of Available Networks and enter the Ad Manager’s API Key, Client ID, Client Secret, and Refresh Token; or click the Login with Google option.

     Login with Google

  Click Save. Ad Manager will be enabled and listed in the Available Ad Networks table.

  • Select the app on which you’d like to run ironSource’s Mediation with Ad Manager.
  • Select Ad Manager from the setup list of ad networks and click on the tool Define button. Insert the App ID and Ad Unit ID  under interstitial, rewarded 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. If you do not see Verified, double check your integration and the information you entered, then click Retry until you see Verified.

Step 4. Add the Admob Adapter to Your Build

Important!

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+.

As of V7.42.0 (Adapter version 4.3.3 onwards), AdMob’s SDK requires publishers to add their AdMob App ID to the app’s plist as described here.
Alternatively, you can make this change programmatically

<key>GADApplicationIdentifier</key>
<string>[APP_ID]</string>

Replace the “GADApplicationIdentifier” value with the APP ID value you retrieve in step 3.

ironSource supports both Cocoapods and Manual download mechanisms.

Cocoapods

To integrate the AdMob SDK with Cocoapods, enter the following line in your podfile and you’re good to go!

pod 'IronSourceAdMobAdapter','4.3.27.0'

Manual Download

  1. Download the AdMob Adapter
    Add the AdMob Adapter and SDK to your build. You can find the latest AdMob Adapter and SDK here.
    As the AdMob Adapter does not contain the AdMob SDK. You need to add the AdMob SDK to your project as well.
  2. Add the AdMob frameworks to your Project
    After you download the Adapter and SDK, drop the Adapter and SDK framework files into your Xcode Project.
  3. Open TargetBuild SettingsArchitectures and confirm that your Xcode Project uses Base SDK version 8.0 or greater and that it does not use armv6 architecture.
  4. Linker Flags:
    Add two separate linker flags to TargetBuild SettingsLinkingOther Linker Flags:
    ObjC

Step 5. Update Info.plist

As of V7.42.0 (Adapter version 4.3.3 onwards), AdMob’s SDK requires publishers to add their AdMob App ID to the app’s plist as described here.
Alternatively, you can make this change programmatically

<key>GADApplicationIdentifier</key>
<string>[APP_ID]</string>

Replace the “GADApplicationIdentifier” value with the APP ID value you retrieve in step 3.
Not doing so results in crashes originated with AdMob’s SDK. For more information please refer to AdMob’s guide.

Step 6. Additional Steps

Child-directed setting – COPPA

ironSource’s mediation platform lets publishers communicate AdMob Child-directed settings directly to the AdMob network.
This feature is enabled using ironSource SDK 6.14.0+, AdMob iOS Adapter 4.3.11+.

Use the following syntax, to set AdMob tagForChildDirectedTreatment with the parameter YES:

 [IronSource setMetaDataWithKey:@"AdMob_TFCD" value:@"true"];

Use the following syntax, to set AdMob tagForChildDirectedTreatment with the parameter NO:

[IronSource setMetaDataWithKey:@"AdMob_TFCD" value:@"false"];

To learn more about Child-directed settings Under AdMob network visit here.
here.

ironSource’s mediation platform lets publishers communicate with AdMob network, a Tag For Users under the Age of Consent in Europe (TFUA) request.
This feature is enabled using ironSource SDK 6.14.0+, AdMob iOS Adapter 4.3.11+.

Use the following syntax, to set tagForUnderAgeOfConsent with YES:

[IronSource setMetaDataWithKey:@"AdMob_TFUA" value:@"true"];

Use the following syntax, to set tagForUnderAgeOfConsent with NO:

[IronSource setMetaDataWithKey:@"AdMob_TFUA" value:@"false"];

To learn more about Child-directed settings Under AdMob network visit here.
here.

Note:

Verify Your Ad Network Integration

The ironSource SDK provides an easy way to verify that your mediation integration was completed successfully. To verify your ironSource and additional Ad Networks’ integration, follow this document.

Done!
You are now all set to deliver Admob Ads within your application!


What’s Next?

To leverage additional mediation ad networks, integrate the adapters and follow our integration guides.