Unity Ads

Introduction

The purpose of this article is to guide publishers who want to use the Fyber FairBid SDK to load and display ads from Unity Ads via FairBid mediation.

This is a six-step process:

  1. Create or login to your Unity Ads Account
  2. Create an app in Unity Ads
  3. Create a placement for your app
  4. Retrieve the parameters from the Unity Ads dashboard
  5. Insert the Unity Ads parameters into the Fyber Console
  6. Add the Unity Ads SDK to your integration

Note

Unity Ads currently supports the following ad formats:

  • Interstitials
  • Rewarded Videos
  • Banners

Refer to Unity Ads for updates on supported ad formats. 

Step 1: Create or login to your Unity Ads Account

To create a Unity Ads account, follow these steps:

  1. Create an account with UnityAds, here.
  2. Once your account has been verified, log in at their partner login here.

Step 2: Creating an App in Unity Ads

To create an app in Unity Ads, follow these steps:

  1. Go to the Developer Dashboard and select the Operate tab:

  1. Click New Project
  2. Give your new project a name
  3. Enter the store IDs you want to publish on (Apple App Store or Google Play).
    If the game hasn’t been published yet you can always add the IDs later.

78fc5b8-Screen_Shot_2019-04-02_at_10.42.12.png

  1. Click Add Project

Step 3: Creating a Placement for your App

Unity Ads creates two default placements: one for Video (Interstitial on the Unity Ads Dashboard) and one for Rewarded Video.
FairBid SDK supports Interstitial videosRewarded videos and Banner ad types.

To view your placements or create new placements to run with Fyber Mediation:

  1. From the Operate tab of the Developer Dashboard, click on the name of your project

c9c31b4-Screen_Shot_2019-04-02_at_10.48.53.png

  1. In the left menu bar, go to Monetization >> Placements

acb3e80-Screen_Shot_2019-04-02_at_11.07.59.png

  1. Click Add Placement to open the Add New Placement window

497151f-Screen_Shot_2019-04-02_at_11.09.01.png

  1. Enter the details of the placement and select the placement type, it can one of following: Rewarded videoInterstitial video or Banner

1b4e97e-Screen_Shot_2019-04-02_at_11.13.59.png

  1. When finished, click Create Placement and the details of your placement are displayed

Step 4: Retrieve the Parameters from the Unity Ads Dashboard

To enable Unity Ads to work as an Ad Network with Fyber, you must obtain three parameters from your Unity Ads account and later insert them into the Fyber Console.

Set out below are the details of what parameters are required, how and where to obtain them.

The parameters required depend on whether you are configuring the network at the App Level or Placement Level in the Fyber Console.

Unity Ads Parameter Description Fyber Placement / App
Game ID The unique identifier of your Application in Unity Ad’s system. Placement Level
Organization ID The unique identifier of your organization in the Unity Ad's system. Both
Placement ID The unique identifier of your Ad Placement in Unity Ad’s system. Two Ad Placements are created by default in Unity Ads for your application; a Rewarded and Non-Rewarded placement. Placement Level
API Key A unique identifier for your Unity Ads account, which allows Fyber to import performance data from your UnityAds account . Both

Alternatively, watch and listen to the video below to find out how to obtain the required parameters:

 

Obtaining the Game ID

To retrieve the Game ID:

  1. Click Projects from the left-side menu
  2. Click the Operate tab at the top of the window
  3. Select the app for which you want the Game ID

32a9579-Screen_Shot_2020-01-09_at_11.24.37.png

The window for the selected app opens:

  1. From the left-side menu click Monetization >> Placements

The Game ID is displayed:

Obtaining the Organization Core ID

To retrieve the Organization Core ID:

  1. Click the Operate tab at the top of the window
  2. On the left menu bar click Settings

The Organization Core ID is displayed:

 

Obtaining the Placement ID

To retrieve the Placement ID:

  1. Click the Operate tab at the top of the window
  2. On the left menu bar click Settings

The Placement ID is displayed:

Obtaining the Monetization API Access (API Key)

To retrieve the Monetization API Access:

  1. Click the Operate tab at the top of the window
  2. On the left menu bar click Ads Data Export
  3. Click API Access

The Monetization API Access is displayed:

318b1a4-Screen_Shot_2020-03-06_at_12.17.32.png

Important

Shortly, Unity Ads are deprecating the Monetization API Access and replacing it with the Reporting API Access. See below for details.

The Reporting API Key is found in the same location as the Monetization API Access.

Now that you have obtained the required parameters, you can complete the configuration of Unity Ads in your Fyber Account.

Step 5: Insert the Unity Ads Parameters into the Fyber Console

To enter the parameters obtained from Unity Ads and insert them into the Fyber Console, follow these steps.

  1. Sign-in to your Fyber account.
  2. Select your app from the App Management window.

  1. On the App Management page, click Mediated Networks.

  1. Select Unity Ads from the list

The Unity Ads Mediation window opens:

  1. Enter the Unity Ads app credentials and set the Instance name.

Instance name should be distinguishable in case you have multiple Unity Ads Instances.

Note

If you are configuring the mediated network at app level, fewer credentials may be required.

  1. Click Save.
  2. To complete the set up, you must associate the network instance that you just created to the relevant Placement set up on the Fyber dashboard. For a detailed guide click here.

Step 6: Adding the Unity Ads SDK to your integration

To add the Unity Ads SDK go to the Supported Networks page and follow the guide  while selecting the Configuration for Unity Ads.