Android Mediation

Android Google Ad Manager Adapter

Android Google Ad Manager (GAM) Mediation Adapter supports all display.io ad units.

Google Ad Manager/ display.io ad units mapping:

display.io       GAM
 mceclip29.png          Interscroller    Banner                format-banner.svg
 mceclip33.png Headline    Banner                format-banner.svg
 mceclip34.png Interstitial    Interstitial                format-interstitial.svg
 mceclip31.png Infeed    Banner                format-banner.svg
 mceclip32.png Medium Rectangle    Banner                format-banner.svg
 mceclip30.png Banner    Banner                format-banner.svg

 

To set it up:

1. Import DisplayIO SDK to your project following simple steps according to manual.

Add adapter dependenciy to your app-module’s build.gradle file:

implementation ‘com.brandio.ads:google-ads-adapter:5.0.0'

Follow guide to initialize DisplayIO SDK.

2. Create new Company in Admin – Companies section, choose “Other company” and turn on “Mediation” toggle.

3. Create a new Yield Group (Banner or Interstitial) and add Yield Partner (DisplayIO) to the Yield Group. Link created Yield Group to the ad unit you want to mediate. If you require more instruction on this please consult the link below: https://support.google.com/admanager/answer/7390828

 

4. Add Yield Partner to Yield Group and define a Custom  Event using settings:

 

Define Custom Class Name:

com.brandio.ads.adapters.googleads.DisplayIOCustomEvent

Define  JSON formatted string as Parameter where put your <APP_ID> and <PLACEMENT_ID>. Both can be found on display.io platform.

{"appID" : "6494", "placementID" : "6430"} //example

 

5. Create a new ad unit and specify the newly created network as a source. Disable auto-refreshing option.

 

6. Make sure that DisplayIO network has a higher priority than any other sources (usually Google adds its own source by default).

 

7. Use Banner or Interstitial tutorials to get ads from Google Ad Manager.

 

8. Interscroller ad unit support additional customisation. You can set ad unit behaviour using next parameters:

{"appID" : "6494", "placementID" : "6430", "isReveal" : false , "showHeader" : false, "showTapHint" : false} //example

Note: above parameters are optional and has true value by default.

9. You also can customise Interscroller top offset and height (usefull when app’s UI elements overlap Interscroller from top or bottom).

Bundle bundleExtra = new Bundle();
// "-" decrease top IS offset "+" increase top IS offset
bundleExtra.putInt("interscrollerOffset", -headerHeight); 
// set IS height equal webview height minus bottom nav panel height
bundleExtra.putInt("interscrollerHeight", webView.getHeight() - bottomNavigationPanel.getHeight()); 
AdManagerAdRequest adRequest = (AdManagerAdRequest) new AdManagerAdRequest.Builder()
        .addNetworkExtrasBundle(DisplayIOCustomEvent.class, bundleExtra)
        .build();
adView.loadAd(adRequest);

10. Deep customisation is also possible for Interscroller as well as for others ad units. To customise ad unit on placement level retrieve Placement object after DIO SDK initialisation:

Placement placement = 
     Controller.getInstance().getPlacement(placementId);

Still have Questions?

Contact Us