Unity Ads Integration Guide

This guide will instruct you step-by-step on how to set Unity Ads live as an Ad Network on Unity LevelPlay.

Before you start Make sure you have correctly integrated ironSource’s Rewarded Video, Interstitial or Banner into your application.

Step 1.  Set up Unity Ads

Complete the following steps before setting up Unity Ads:

  1. Create a Unity ID
  2. Sign up for Unity Gaming Services: select Get started for free.

Step 2. Create a project in Unity Ads

Follow these steps to create your Unity Ads application:

Create an application

    1. On the Unity Monetization Dashboard, select Projects. For more information about navigating the dashboard, see Introduction to the Unity Dashboard
    2. Select Organization > Projects
    3. Select Create project

4. Enter a project name and COPPA designation.

5. Select Create project.

To monetize your project, you’ll need to enable Unity Ads in the dashboard. Select Get started from the Monetization dashboard > secondary navigation menu.

When you initialize Unity Ads for your project, you must select a mediation provider. Select I plan to use Mediation > Unity LevelPlay.

Create an ad unit 

Use an Ad Unit to surface an event in your game that triggers ad content:

  1. From the left navigation menu, select Monetization > Ad Units
  2. Select Add Ad Unit to bring up the creation modal
  3. Enter an Ad Unit name, then select a Platform (iOS or Android) and ad format (Rewarded, Interstitial, or Banner).
  4. Select Create to save your Ad Unit

Add a placement

Once your project is created, navigate to Monetization > Placements and take note of the Game ID for both platforms.

To create a new placement, click the Add Placement button.

Note: While Unity Ads automatically creates “default” placements when first creating your project, we recommend creating new unique placements for each AdMob mediation configuration.

Step 3. Retrieve your credentials

In addition to the Game ID and Placement ID, you also need your Unity Ads API Key and Organization core ID for setting up your AdMob ad unit ID:

Navigate to Set up > API Management and take note of the Monetization Stats API Access Key.

Then, navigate to Organization settings and take note of the Organization core ID.

Configure Unity Ads’ Parameters into ironSource Account

Once you have all of these parameters, log in to your ironSource account.

  • Go to ‘Monetize‘ ➣ ‘SDK Networks‘ ➣ ‘Available Networks‘.

    unity-13

  • Select UnityAds from the list of available Ad Networks and input the UnityAds ‘API Key‘ and Organizational ID in the relevant fields.
  • Make sure you choose the app you want to integrate from the apps list on the left side of the SDK networks page.
  • Click on the unity ads’ Setup button and enter the ‘Game ID‘ and ‘Placement ID‘ under the relevant Ad Unit Settings:
    unity-last
  • You will then see Unity Ads as Active for Mediation on your Setup Dashboard.

Step 4. Add the Unity Ads Adapter to Your Build

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


What’s Next?

To leverage additional ad networks through ironSource Mediation, integrate the adapters and follow our integration guides