API Reference

This documentation offers a comprehensive guide for integrating the HyBid SDK with IronSource Mediation in order to serve advertisements within your app. Publishers can achieve this integration by utilizing a custom adapter specifically designed for IronSource. It is important to note that the latest version of the HyBid SDK is fully compatible with IronSource version 7.9.0. Presently, we support rewarded video, interstitial and banner ad formats.

To use HyBid SDK directly in IronSource Mediation you will need to integrate the IronSource SDK and the Hybid SDK into your app.

Integrate IronSource SDK

To integrate IronSource SDK into your app you should follow the instructions on their website for Android .

Integrate HyBid SDK

To integrate the HyBid SDK follow the instruction in the integration pages for Android and iOS.

📘

The SDK initialization step on integration pages can be skipped since the IronSource adapters will handle it automatically.

Next, you will need to import the IronSource Adapters module from the HyBid SDK:

implementation 'net.pubnative:hybid.sdk:3.2.1'
implementation 'net.pubnative:hybid.adapters.ironsource:3.2.1'

Set up the placements on IronSource Dashboard

To set up the HyBid Adapters in the IronSource mediation you need to follow a few steps.

If you already have an app and ad units created then you can skip these steps.

Create an app:

  1. Create a new app in the IronSource Dashboard.
  2. Enter the required information in the dialog.
  1. Enable the ad formats you want to integrate into your app.
  2. Use the provided app key to initialize the IronSource SDK on the app's main activity, as specified in the documentation.

🚧

If you already have an app and ad units created, skip this step.

Set up the Verve mediation network:

  1. Select the SDK Networks tab on the side menu.
  2. Choose the Manage Networks option.
  3. Click on the Custom Adapter button and search for Verve as a network.

  1. Input the Verve network key: 15ba9be25

  1. After Verve appears as one of the mediation networks configured for your app, use the app token and zone IDs you received from your account manager to set up the adapters for each ad format. You can set up more than one adapter per format.

Set up placements with the Verve network:

  1. Go to the Ad Units and placements section on the dashboard.
  2. Create placements for each ad format.
  1. After creating your placements, use the names to request ads.

Request Ads

Request ads using the regular IronSource process with the generated placement names. You can find the instructions on the IronSource developers page.

Interstitial ads for Android

Rewarded video for Android

Banner/MREC for Android

IronSource SDK version support per HyBid version

Hybid SDK automatically adopts minor releases of IronSource SDK (e.g., v7.8.1 to 7.8.2). Major releases (e.g., v.9.0) require manual integration due to significant changes. Ensure compatibility before updating major versions.

HyBid versionIronSource versionSupported formats
3.0.18.2.0Banners, Interstitial and Rewarded ads
3.0.28.1.0Banners, Interstitial and Rewarded ads
3.0.18.1.0Banners, Interstitial and Rewarded ads
3.0.08.0.0Banners, Interstitial and Rewarded ads
2.21.17.9.0Banners, Interstitial and Rewarded ads
2.21.17.8.1Banners, Interstitial and Rewarded ads
2.21.17.8.0Banners, Interstitial and Rewarded ads
2.21.17.7.1Banners, Interstitial and Rewarded ads
2.20.07.5.1Banners, Interstitial and Rewarded ads
2.20.07.5.0Banner, Interstitial and Rewarded ads
2.19.07.3.1.1Banners, Interstitial and Rewarded ads
2.18.17.3.0Interstitial and Rewarded ads
2.18.07.3.0Interstitial and Rewarded ads
2.17.07.2.5Interstitial and Rewarded ads
2.16.27.2.5Interstitial and Rewarded ads
2.16.17.2.4.1Interstitial and Rewarded ads
2.16.07.2.4.1Interstitial and Rewarded ads
2.15.17.2.3.1Interstitial and Rewarded ads
2.15.07.2.3.1Interstitial and Rewarded ads
2.14.07.2.2.1Interstitial and Rewarded ads
2.13.17.2.1.1Interstitial and Rewarded ads
2.13.07.2.1.1Interstitial and Rewarded ads
2.12.17.1.14Interstitial and Rewarded ads
2.12.07.1.14Interstitial and Rewarded ads
2.11.17.1.14Interstitial and Rewarded ads
2.11.07.1.14Interstitial and Rewarded ads
2.10.07.1.12.1Interstitial and Rewarded ads
2.9.07.1.12.1Interstitial and Rewarded ads