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 8.0.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 iOS.

Integrate HyBid SDK

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

📘

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

Next, head over to IronSource HyBid Adapters repository and import all the adapter files to your project.

If you are using CocoaPods you can directly use the pod dependency:

pod 'ironSource-HyBid-Adapters', '3.1.4.0'

👍

Recommended Installation Method: Cocoapods

We recommend using Cocoapods for installation to ensure the best compatibility and ease of updates. However, we also offer a drag-and-drop method for your convenience.

Please note: The drag-and-drop option is not available as of version 2.21.1.

Swift integration

To use the IronSource Adapters in your Swift project, ensure that you have a Bridging Header file in your project and the Objective-C Bridging Header build setting under Swift Compiler - Code Generation has a path to the header.

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 iOS

Rewarded video for iOS

Banner/MREC for iOS

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., v9.0) require manual integration due to significant changes. Ensure compatibility before updating major versions.

HyBid versionIronSource versionAdapter versionSupported formats
3.0.18.2.03.0.1Banners, Interstitials and Rewarded ads
3.0.18.1.03.0.1Banners, Interstitials and Rewarded ads
3.0.08.0.03.0.0Banners, Interstitials and Rewarded ads
2.21.17.8.02.21.1.0Banners, Interstitials and Rewarded ads
2.21.17.7.02.21.1.0Banners, Interstitials and Rewarded ads
2.20.07.5.1.02.20.0.0Banners, Interstitials and Rewarded ads
2.20.07.5.0.02.20.0Banners, Interstitial and Rewarded ads
2.19.07.4.0.02.19.0.1Interstitial and Rewarded ads
2.19.07.3.0.02.19.0.0Interstitial and Rewarded ads
2.18.17.3.0.02.18.1.0Interstitial and Rewarded ads
2.18.07.3.0.02.18.0.1Interstitial and Rewarded ads
2.18.07.2.02.18.0.0Interstitial and Rewarded ads
2.17.07.2.02.17.0.0Interstitial and Rewarded ads
2.16.27.2.02.16.2.0Interstitial and Rewarded ads
2.16.17.2.02.16.1.0Interstitial and Rewarded ads
2.16.07.2.02.16.0.0Interstitial and Rewarded ads
2.15.07.2.02.15.0.0Interstitial and Rewarded ads
2.14.07.2.02.14.0.0Interstitial and Rewarded ads