Dashboard Setup

Prerequisites

Before proceeding, make sure you have completed the steps outlined in the Getting Started section:

• Registered your app and created ad units in the Ogury Publisher Platform.

• Retrieved your asset key and ad unit IDs.

• Updated your app-ads.txt file.

Step 1: Add Ogury as a Yield Partner

In Google Ad Manager dashboard, configure Ogury as a yield partner.

• Click on Admin > Companies in the left-menu.

• Click on New company and select Ad Network.

• In the New ad network pop-up, select Other company as Ad network and enter Ogury as Name. Then enable the Mediation option.

The newly created Ogury yield partner should show in the list of Ad Networks.

Step 2: Create Yield Group

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

Step 3: Add Ogury in your Yield Group

In order to display Ogury Interstitial ads through Google Ad Manager mediation, you need to configure a Custom Event for Ogury within your yield group.

• In your GAM dashboard, navigate to Delivery > Yield groups from the left menu, and select the group where you want to add Ogury.

• Scroll to the bottom of the page and click on Add yield partner. From the Yield Partner dropdown menu, select Ogury (or Other company (Ogury))

• In the New yield partner pop-up, choose Custom Event as the Integration type, choose Android or iOS as Plaform according to your app and enter the CPM you agreed upon with your Ogury Account Manager as the Default CPM.

• Under Additional yield partner details, set the Label to match your ad unit name in the Ogury Publisher Dashboard (e.g., Ogury). This helps ensure that your settings are consistent across both Ogury and GAM.

• Configure the Class Name according to the ad format your are configuring:

• Configue the Parameter as follows, by replacing OGY-XXXXXXXXXXXX with your unique Ogury asset key and xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx with your Ogury ad unit ID. If you do not have these values yet, refer to the Application Registration and Ad Unit Creation guides to generate them.

{"assetKey":"OGY-XXXXXXXXXXXX","adUnitId":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}

• Click on SAVE.

Additional Resources

Integration Testing

Ensure your implementation works correctly by testing with sample ads and verifying ad behavior.

See the Testing Guide.

Advanced Integration

Create a dedicated Ad Unit for Thumbnail ads

• Access your Google Ad Manager dashboard.

• Navigate to the list of Ad units and click on the New ad unit button.

• Configure the ad unit as following:

  • Name: enter a name for the ad unit (e.g., Thumbnail Ad).

  • Code: set a unique code for the integration.

  • Size Mode: select Fixed size.

• Sizes: Choose the various sizes of Thumbnail Ads you plan to use in your app. We recommend using a size of 200x200 to enhance the readability of the Thumbnail ad content

• Refresh Rate: Select No refresh, to prevent Thumbnail ads from appearing in front of users every few seconds.

The following constraints apply to the values you can assign to these parameters:

• maxWidth and maxHeight must not exceed the screen size.

• Both maxWidth and maxHeight must be greater than or equal to 101dp.

• The longest side, either maxWidth or maxHeight, must be at least 180dp.

Create a dedicated Yield Group for Thumbnail ads

In order to display Ogury Thumbnail ads through Google Ad Manager mediation, you need to configure a Custom Event for Ogury within a dedicated yield group.

• In your GAM dashboard, navigate to Delivery > Yield groups from the left menu.

• Click on Delivery > Yield groups in the left-menu of your Google Ad Manager dashboard.

• Click on New yield group.

• Configure the details of the yield group as follows:

  • Name: Enter a name for the yield group (e.g., Thumbnail Ad Android).

  • Status: Set to Active.

  • Ad Format: Select Banner.

  • Inventory Type: Choose Mobile app.

• Scroll down to the Targeting section.

• Expand the Inventory size section.

  • Locate the size you selected during the creation of the dedicated Ad Unit for Thumbnail ads step.

  • Click the checkbox next to this size to select it.

• Expand the Inventory section.

  • Click the arrow next to Ad units.

  • Search for the ad units where you want to display a Thumbnail ad.

  • Click the check mark to include them in the targeting.

Integrate Thumbnail using Ogury's dedicated SDK API

To manage a Thumbnail ad through Google Ad Manager mediation, Ogury provides a dedicated API that simplifies the integration process:

• Thumbnail Integration – Android

• Thumbnail Integration – iOS