Introduction

The purpose of this article is to guide publishers who want to use the Fyber FairBid SDK to load and display ads from AdMob via FairBid mediation.

This is a six-step process:

1. Create or login to your AdMob Account
2. Create an application and AdZone within AdMob
3. Activate AdMob in your Fyber Setup
4. Retrieve the parameters from the AdMob
5. Insert the AdMob parameters into the Fyber Console
6. Add the AdMob SDK to your integration

Supported Formats

AdMob currently supports the following ad formats:

• Banner
• Interstitial
• Rewarded (with Google Play Services version 9.0.2+ integrated in your app)

Refer to AdMob to learn about any additional formats they may now support.

Step 1: Create or Login to your AdMob Account

To access AdMob’s ad inventory through Fyber‘s Mediation platform, create or login to your AdMob account. For details on creating an account, click here.

You must have a valid AdSense Management and AdWords account to work with AdMob. You can create them during the sign-up process and connect them to your Google account, if you do not already have them. 

Step 2: Creating an Application and AdZone in AdMob

1. Sign in to the AdMob account you created, here.
2. Click Apps on the dashboard

3. Either search for your app, add your app manually or select an existing app to monetize

Adding a New App

Follow the steps below to begin the process of adding a new app.

1. Click on Add App

2. You are asked if your app has already been published in the Google Play or App Store

If you answer Yes

3. Enter the App Name, Developer Name or App ID

4. Click Search to find your app and follow the instructions on screen.

If you answer No the following window opens.

5. Enter a name for the new app

6. Select the Platform for your app

7. Click Add
   You app has now been added to the selected platform.

Linking your App

You must link your app with Google Play Store.

1. Go to App Settings >> App Info

2. Click the Edit icon

3. Click Link Your App with Google Play

4. Search for your app in the search window and click Select

5. Click Link App

You app has now been linked to Google Play.

The next step is to add Ad Units to your app.

1. From the AdMob homepage click Apps and select your app.
2. In the App Overview window, click Add Ad Unit.

3. Select the Ad Format you want

1. On the Create Ad Unit window, under Banner, click Select.

2. Enter a name for the Ad Unit
3. Click Advanced Settings and enter the details, as required
4. Click Create Ad Unit 

Interstitial

1. On the Create Ad Unit window, under Interstitial, click Select.

2. Enter a name for the Ad Unit

3. Click Advanced Settings and enter the details, as required
   Ad Type: Leave the two boxes checked as Fyber supports text, image, video and rich media in interstitials.

4. Click Create Ad Unit 

Rewarded

1. On the Create Ad Unit window, under Rewarded, click Select.

2. Enter a name for the Ad Unit
   Ad unit name: Fyber recommends naming the ad unit so it can be easily recognized as the ad unit you are serving AdMob Rewarded ads through the FairBid Mediation platform.

3. Click Advanced Settings and enter the details, as required

4. Click Create Ad Unit

5. Your App ID and Ad Unit ID are displayed, it is recommended to save these for use later in the process.

6. Click Done.

Step 3: Activate AdMob in your Fyber Network Setup Module

Sign in to your Google account when setting up AdMob on the FairBid SDK Networks Setup.

With AdMob, the Account Credentials (Account ID, Refresh Token and Client ID) are retrieved automatically and remain the same for all of your apps using AdMob as a mediated network.

You can either login with your Google account or enter the credentials manually.

Logging-In with Google

1. Click Sign in with Google
2. The Sign in with Google window opens.
3. Select the account details with which you want to login and confirm access rights.

Your account details are displayed in the AdMob Account Credentials.

Click the uncover icon to view the Account ID and Refresh Token that is valid for all of your apps.

If you want to switch the option and enter the credentials manually, click Revoke Access and enter the credentials manually into the relevant fields.

If you enter an email which is not recognised in the system, you receive the following error:

Step 4: Retrieve the Parameters from the AdMob

There are a several parameters from your AdMob account you must insert into the Fyber Console. Once you obtain this information, configure AdMob’s Parameters in your Fyber Account. By adding the above information correctly, you can take full advantage of AdMob’s ad inventory and reporting data on the Fyber FairBid Mediation platform.

Set out below are explanations of how to obtain these parameters.

Alternatively, watch and listen to the video below to find out how to obtain the required parameters:

Retrieving the Account ID/Unit ID

To retrieve your Account ID/Ad Unit ID:

1. Go to the Apps tab on the left side bar on AdMob’s platform

2. Click Ad Units

The application’s ad units and Ad Unit ID are displayed.

Retrieving the Client ID and Client Secret

Follow these steps to obtain the Client ID and Client Secret.

Enabling AdMob API

Follow these steps to enable the AdMob API.

1. Go to the Google APIs Library

2. In the search field enter AdMob API and click AdMob API.

3. Click Enable to use the AdMob API.

The AdMob API is now enabled.

Retrieving the Refresh Token

To retrieve the Refresh Token:

1. Go to OAuth 2.0 Playground, here.

2. On the top left-hand corner, click Step 1 Select & Authorize APIs.

3. Enter the following two URLs in the Input your own Scopes field (separated by a space)

• https://www.googleapis.com/auth/adsense.readonly
• https://www.googleapis.com/auth/admob.report

4. Click Authorize APIs.
5. Move to Step 2.

6. Click Exchange authorization code for tokens.

Your Refresh Token and Access Token are displayed. These are used for access to OAuth protected resources.

Now that you have obtained the required parameters, you can complete the configuration of AdMob in your Fyber Account. 

Step 5: Insert the AdMob Parameters into the Fyber Console

To enter the parameters obtained from AdMob and insert them into the Fyber Console, follow these steps.

1. Sign-in to your Fyber account.
2. Select your app from the App Management window.

3. On the App Management page, click Mediated Networks.

4. Select AdMob from the list.

The AdMob Mediation window opens:

5. Enter the parameters you obtained earlier, together with your Bundle ID and App ID.

• The Bundle ID is taken from the App itself (not the AdMob dashboard).
• The App ID can be found in the app's Play Store URL after 'id'. For example, in https://play.google.com/store/apps/details?id=com.company.appname the identifier would be com.company.appname

6. For each ad format, enter the Instance Name and your Ad Unit ID.

Instance name should be distinguishable in case you have multiple AdMob Instances.

7. Click Save
8. To complete the set up, you must associate the network instance that you just created to the relevant Placement set up on the Fyber dashboard. For a detailed guide click here. 

Step 6: Adding the AdMob SDK to your Integration

To add the AdMob SDK go to the Supported Networks page and follow the guide while selecting the Configuration for AdMob.

Simply replace the “[ADMOB_APP_ID]” with the APP ID value you obtain here.

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

Info.plist

In your app's Info.plist file,

1. add a GADApplicationIdentifier key with a string value of your AdMob app ID.

You can find your App ID in the AdMob UI. For more information, click here.

2. add a GADIsAdManagerApp key with a boolean value set to YES.

<key>GADIsAdManagerApp</key>
<true/>

For more information, click here

AdMob Reporting API

The AdMob Reporting API allows you to obtain information about your AdMob account.