Enabling Programmatic Mediation

Note

This article is intended for publishers that want to enable programmatic mediation networks to bid on their app inventory.

Introduction

Programmatic mediation is Fyber’s proprietary technology where mediated SDK networks participate in a fair, real-time-bidding marketplace to determine the winner of an impression. This is achieved while preserving the mediated ad network’s SDK on the client side as a display manager, rendering the ads.

In addition, ad networks are able to maintain a direct contractual relationship with their publisher partners.

For more information on Programmatic Mediation in Fyber FairBid, click here.

Participating in Programmatic Mediation

Programmatic mediation welcomes Fyber’s mediated partners into the programmatic ecosystem. By participating in this program our partners can achieve the following:

  • Fair and equal competition amongst all contenders bidding on an impression
  • Ultimate access to bidding on every potential impression
  • Avoiding a static waterfall - every opportunity is equally accessible to all
  • Better access to inventory and ability to choose the best opportunities on which to bid
  • Higher bidding resolution allows partners to bid based on per-impression value versus being evaluated by historical average performance data
  • Real time pricing and market economics dictate the value of the impression
  • Implicit guarantee that the highest bid wins
  • Access private marketplaces and other advanced programmatic selling/buying methods

Whitelisting and Bidding Configuration

To enable programmatic mediation bidding on an app’s traffic, publishers must first contact Fyber and have their apps opted into this capability. In addition, apps must be whitelisted by the supported networks.

Each network has its own process for whitelisting an app and configuring programmatic mediation bidding.

Once you have added an app, then created and configured placements, you must configure each mediated network to enable them to participate in the Fyber FairBid unified auction.

Note

You cannot have both the mediation and bidder from the same network in a single placement. For example, Facebook programmatic mediation and Facebook traditional mediation must be configured separately.

Set out below are the instructions for each supported programmatic mediation network, and the steps required to enable programmatic bidding by them.

Facebook Audience Network (FAN)

Facebook Audience Network’s bidding product is currently operated as a closed beta program. Contact your Fyber account manager for more information on how to gain access.
Whitelists are applied at the publisher-level (not app-level) and must be carried out by the Facebook team.

To enable Facebook Bidding, once you've been whitelisted and have set up a Placement ID:

  • The option Waterfall and Bidding must be selected.
  • Rewarded Video and Interstitial placements cannot be mixed. They should be configured as separate placements.
  • If Rewarded Video is not available in the publisher’s Facebook dashboard, you must obtain Rewarded Video approval for this directly from FAN.

For more details about Facebook’s programmatic mediation, click here.

AdColony

Whitelists are applied at the zoneID level, meaning whitelisting is carried out for each individual placement that a publisher wants to use for programmatic mediation and AdColony must then turn the ZoneID into a Programmatic ID for bidding to start on that placement.

For more details about AdColony’s programmatic mediation, click here.

Tapjoy

Tapjoy’s whitelists are applied automatically. However, the Tapjoy team likes to ensure that publishers have set everything up properly.

For more details about Tapyjoy’s programmatic mediation, click here

Prerequisites

Integration with FairBid SDK and mediation set up.

  • Facebook - All SDKs
  • TapJoy and AdColony - All SDKs

Setting-up on the Console

  1. Select the mediated network with which you want to work.

The configuration settings for your selected network are displayed.

Warning

Except for Facebook and AdColony, do not use existing credentials. You must create new IDs.

  1. Once you have selected the required networks and entered the credentials, click Add.

The Placement and credentials are displayed:

  1. Click + Ad Network Instance for additional Ad Network Instances, if required and and then click Save

For details of how to obtain the credentials from the required credentials from the Ad Network, click the appropriate link:

Facebook
AdColony
Tapjoy

Testing Programmatic Mediation

For Facebook and Tapjoy, you can test your integration by using out test suite.

For more details on Fyber's Testing Suite click the appropriate operating system: AndroidiOS and Unity.

Note

When requesting a Programmatic placement from the Test Suite, the SDK runs an auction in “Test Mode” allowing the respective Programmatic bidder know that it should bid with a test ad and no publisher payout should take place.

Successfully requesting and showing a programmatic mediated network placement ensures you have your programmatic placement configured correctly and that the respective network is ready to bid on live traffic. However, it does not guarantee you have consistent bids and fills for that programmatic mediated network placement in production.

  • If you have issues obtaining a fill for Facebook or Tapjoy, (meaning they either have or do not have an ad to show), check with your Fyber account manager and make sure all programmatic placements have been correctly configured on the Tapjoy and Facebook side.
  • AdColony bidder does not have this test mode capability yet but it should work without issues in production.
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request