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:
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:
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