Banner Ad

This article will go through all the steps required to display banner ads in your application through AdMob mediation.

Banner Ads are small or medium rectangle ads that have specific dimensions and occupy a certain position of the screen width and they can be freely integrated within the content of the app.

The banner comes with two predefined dimensions:

  • small banner (320x50)

  • MPU (300x250)

In case you publish your application on Android and iOS, you should do the following steps twice, once for the Android application and once for the iOS application. Otherwise just select the platform you publish for.

Requirements

You have registered an application on your Ogury Dashboard. If not, please refer to the Getting Started section before the next steps.

Step 1: Create Banner Ad ad units

In all the following code samples, we will refer to:

  • the Ad unit id for the Android application by using the string ANDROID_AD_UNIT_ID.

  • the Ad unit id for the iOS application by using the string IOS_AD_UNIT_ID.

Ogury Banner Ad ad units are designed to display only the size that they have been created with.

When loading your Google Ad Manager Banner Ad, please make sure to load using an AdSize matching the size of your Ogury ad unit:

  • For a small banner, use AdSize.BANNER.

  • For a MPU, use AdSize.MEDIUM_RECTANGLE.

Step 3: Add Ogury in your Yield Group

In order to display Ogury Banner Ad through GAM mediation, you need to configure a Custom Event for Ogury in your yield group.

In case you publish your application on Android and iOS, you should do the following steps twice, once for the Android application and once for the iOS application. Otherwise just select the platform you publish for.

  • Click on Delivery > Yield groups in the left-menu of your GAM dashboard, and select the group where you want to add Ogury.

  • Scroll to the very bottom of the page, click on Add yield partner and select Ogury under the Yield Partner dropdown.

  • In the New yield partner pop-up, select Custom Event as Integration type and set up CPM that you agreed with your Ogury Account Manager as Default CPM.

  • Under Additional yield partner details, set up Label to match with your Ad unit name on Ogury dashboard (e.g. Ogury). This makes it easier for you to track the settings are matching on both sides - Ogury and GAM. Then configure Class Name and Parameter as following:

Class Name:

com.admob.mobileads.PresageBannerCustomEvent

Parameters:

{"assetKey":"ANDROID_ASSET_KEY","adUnitId":"ANDROID_AD_UNIT_ID"}

Don't forget to replace ANDROID_ASSET_KEY and ANDROID_AD_UNIT_ID by your Ogury Asset Key and your Ogury Ad unit id.

  • Click on SAVE.

If you wish to set up multi-placements for Ogury, you can add Ogury multiple times as a yield partner inside your Yield Group. Each time, you should make sure to use the corresponding Ad unit ids from Ogury dashboard, with the agreed CPM value

Step 4: Test your integration

Ogury exclusively serves ads to users who have given consent. It is essential to have responded to a valid TCFv2 consent form before conducting any tests.

As our algorithm works with personified targeting, you may not receive any ad while testing your application.

You can test your integration by adding the suffix _test to your interstitial ad unit id, for more details go to Test your implementation page.

Note that if you have just registered your application in the Ogury Dashboard, it will take around 15 minutes until you can successfully load an ad.

Last updated