Fyber Mediation Integration Guide

This guide instructs you step-by-step on how to set Fyber live as an Ad Network on the ironSource Mediation platform.

Before You Start
Make sure you have correctly integrated ironSource’s Rewarded Video or Interstitial into your application. 

Step 1. Create an Fyber Account

  1. Create an account with Fyber. You can do so here.
  2. Once your account has been verified, you can log in to their partner login here.

Step 2. Create an Application and Ad Spot in Fyber

To gain access to Fyber’s inventory within ironSource’s Mediation platform, you must first add your app and set up Ad Spots in your Fyber account.

  1. Add Your App
    1. Log into your Fyber account, navigate to ‘Inventory’  ‘Manage Apps & Sites’. select ‘Add App Or Site’.
    2. Define the settings of your app.
  2.  Create an Ad Spot
    Once your application has been added, you can create an Ad Spot. In Fyber’s system Ad Spots defines the Placement & Ad Unit to which Fyber delivers ads.

    1. Select ‘+ New Ad Sopt’
    2. Create the Ad Spot settings:
      1. Ad Spot Name
      2. Select Ad Units: Make sure to chose a single Ad Unit to use in this Ad Spot
    3. Setup Ad Unit:
      1. Interstitial:
        1. Select between Display, Video or both
      2. Banner:
        1. Keep ‘Request Intervals’ Disabled
    4. Save Ad Unit
    5. Continue twice

Step 3. Activate Fyber in the SDK Networks Setup Module

There are a few parameters from your Fyber account which need to be inserted into your SDK Network Setup Module on the ironSource platform in order for Fyber to work correctly in connection with ironSource:

Publisher ID, 

Consumer Key, 

Consumer Secret

This is a unique identifiers for your Fyber account, which allows the ironSource Mediation Platform to import performance data from your Fyber account to use in reporting & optimization.
App ID This is a unique identifier of your application in Fyber’s system.
Ad Spot ID This is the unique spot which Fyber will deliver ads to.
Ad Unit ID This is the unique Ad Unit mapped to the relevant Spot

Once you obtain this information, you must configure Fyber’s Parameters in your ironSource Account. By adding the above information correctly, you will be able to take full advantage of Fyber’s ad inventory and reporting data on the ironSource Mediation platform.

  1. Publisher ID,  Consumer Key,  Consumer Secret
    Navigate to the ‘User Profile‘ page and you will locate them on the bottom part of the page under ‘Reporting API Keys’
  2. App ID, Spot ID, Ad Unit ID
    Navigate to ‘Inventory’  ‘Manage Apps & Sites’ ➣ Select the relevant application from the list ➣ Select ‘Integration Options’ from menu on the right.

Configure Fyber’s Parameters into ironSource Account

  • Once you have all of these parameters, log in to your ironSource account and go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘SDK Networks‘.
  • Select Fyber from the list of Available Ad Networks and enter the Fyber ‘Publisher ID‘, ‘Consumer Key‘, ‘Consumer Secret‘. Click ‘Save‘.
  • Fyber will then be enabled in the Available Ad Networks table.
  • Make sure to define the app on which you’d like to run ironSource’s Mediation with Fyber. Go to the Fyber row on the Setup list of Ad Networks and click on the ‘Setup‘ button.
  • Insert the App ID‘ on the application level, and ‘Spot ID‘ + ‘Ad Unit ID‘ for the relevant Ad Units.
  • Click ‘Save’.
  • Activate requested Ad Units.
  • Verify your integration with the Reporting API; this column will check your integration through the Reporting API and return three possible responses: Verified, Failed and No Response. Double check your integration and the information you entered above; then click ‘Retry‘ until you see ‘Verified’.

Step 4. Add the Fyber Adapter to Your Build

Unity Plugin (Android Integration)

  1. Download the Fyber Unity Package:
    Import the IronSourceFyberAdapter_[version].unitypackage to your Unity project. You can find the latest Fyber Unity Package here.
  2. Add the Fyber files to your Unity project:
    To add the adapter, simply double click on the IronSourceFyberAdapter_[version].unitypackage and add all files to your Unity project.


Unity Plugin (iOS Integration)

  1. Download the Fyber Unity Package:
    Import the IronSourceFyberAdapter_[version].unitypackage to your Unity project. You can find the latest Fyber Unity Package here.
  2. Add the Fyber files to your Unity project:
    To add the adapter, simply double click on the IronSourceFyberAdapter_[version].unitypackage and add all files to your Unity project.

Our Unity Plugin adds the necessary frameworks automatically to your Xcode project.

Verify Your Ad-Network Integration

  • Verify your ad network integration with our Integration Helper. The ironSource SDK provides a tool to ensure you’ve successfully integrated our SDK as well as any additional network adapters.
  • Manage the debug logs for your integrated mediation ad networks with this boolean
    IronSource.Agent.setAdaptersDebug(true);

    When set to TRUE, this line of code will enable debug logs to help you troubleshoot issues with all of the mediation ad networks that permit to do so. Remove this code before your app goes live with our ad units! 

Done!
You are now all set to deliver Fyber Ads within your application!


What’s Next?

To add additional mediation Ad networks, integrate the ironSource adapters and follow our integration guides.