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)

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 an Interstitial Ad ad unit

In all the following code samples, we will refer to this Ad unit id by using the string YOUR_OGURY_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 2: Create Yield Group

Follow the Google Ad Manager guide to create a yield group for your Banner ad unit.

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.

  • 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.ogury.mobileads.OguryBannerAdCustomEvent

In case you are already using the old custom event class(com.admob.mobileads.PresageBannerCustomEvent),do not update the Class Name field to (com.ogury.mobileads.OguryBannerAdCustomEvent).A new yield group and partner should be created in order to not impact the users already using an older library. Ads will be served with the new SDK even if the custom event class is not updated.

Parameter:

{"assetKey":"OGY-XXXXXXXXXXXX","adUnitId":"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.

Additionally, you can follow the integration logs to get useful information on your integration status and any issue that might occur when displaying ads. Connect your device to Android Studio. Then filter the logs after the OGURY keyword to separate them from everything else.

Last updated