Getting started

Since June 2021, Ogury is a certified mediation partner of MoPub. Therefore, MoPub mediation officially supports the following Ogury ad formats:

Ogury Ad Formats

MoPub formats

Interstitial

Interstitial

Opt-in Video

Rewarded Ad

Banner (320x50)

Banner

MPU (300x250)

Medium Rectangle

Supporting Thumbnail Ad

As the Thumbnail Ad format is an Ogury's own format, there is no equivalent in the MoPub mediation. However, Ogury provides an in-house adapter dedicated to the Thumbnail Ad format allowing you to load and display Thumbnail ads via the MoPub mediation. This adapter uses the custom events of the MoPub's Banner format so that you are be able to follow all your stats in the MoPub UI.

Whatever the format used, please complete the following steps.

If you are already using Ogury as network of the MoPub mediation, please read the migration guide to see what changes you need to make.

We recommend you to check our migration guide to handle iOS 14 changes

Step 1: Register your application

The Asset Key follows the pattern: OGY-XXXXXXXXXXXX, where X is an uppercase letter or digit. In all the following code samples, we will refer to this Asset Key by using the string ASSET_KEY.

Step 2: Create the ad units you need

  • Go to your Asset list in the Ogury Dashboard and select your Asset.

  • Click on the Monetization settings in the left-menu.

  • ‚ÄčCreate the ad units corresponding to the ad formats you want to integrate.

  • Copy the Ad unit id as you will need this information to set up Ogury in the Mopub UI and/or to integrate the Thumbnail Ad.

Please note that when creating ad units, a default CPM pricing will be set-up and you can modify it by contacting your Ogury Account Manager.

In all the following code samples, we will refer to this Ad unit id by using the string YOUR_OGURY_AD_UNIT_ID.

Step 3: Load and display Ogury ads

You are now ready to integrate the Ogury ad formats via the MoPub mediation.

To integrate the formats certified by MoPub, i.e. Interstitial, Opt-in Video, Banner and MPU Ad, please refer to the MoPub integration instructions.

For Thumbnail Ad integration, please refer to the dedicated section: Thumbnail Ad.

We suggest you setup a test device before you start integrating so that the device configuration has time to propagate while you perform your integration.

Step 4: Collect the user consent

The European GDPR regulation requires obtaining the users' consent in order to display them personalized ads, (i) when the company processing personal data is based in the EU, or (ii) when the users are EU citizens.

As a company based in the EU, Ogury accordingly requires an explicit consent from the users to collect their personal data and display them personalized ads. The consent collection can be operated:

Please get in touch with your account manager to make sure Ogury has a way to receive a valid user consent status.

Note that the Ogury SDK meets privacy requirements by design. Shall it not receive a valid consent status from the Ogury Choice Manager or from a validated third-party consent solution, it will display by default an End User License Agreement (EULA) before serving the first ad. Another way to put it: no targeted ad will be displayed to the users if they didn't give their consent first.

Before going live

Ogury is part of the IAB Authorized Sellers for Apps initiative to fight inventory fraud for applications. It is recommended to update your app-ads.txt to include Ogury as described in the app-ads.txt section.