Knowledge base

Ad Units

An Ad Unit represents the ad format settings of a collection of Placements. Ad Units consolidate ad format information into a single object, which allows for easier Placement management.

New mediated customers

New mediated customers begin with six default Ad Units (one per format for each platform), to immediately draw on best-practice settings for each format without extensive setup. All you have to do to get started is create Placements with eCPM targets for the relevant Ad Units.

Existing mediated customers

In the future, Unity will automatically convert existing customers' legacy Placements into Ad Units, and their eCPM targets into Placements.

Important: Unity’s goal is to not disrupt waterfalls you’ve already created. In the future, your existing Placement IDs will not change, so you can continue to use them in waterfalls indefinitely. Unity will only create new Placement IDs for additional Placements created after migration.

Managing Ad Units

Create, edit, and archive your Ad Units in the Monetize Dashboard.

Creating an Ad Unit

To create a new Ad Unit:

  1. From the left navigation menu, select Monetization > Ad Units.
  2. Click 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).
Ad format template Description
Rewarded Allow players to opt in to viewing ads or promotions in exchange for incentives. Rewarded Ad Units do not allow the player to skip the ad.
Interstitial Show basic interstitial ads or promotional content. Interstitial Ad Units allow players to skip the ad after a specified period of time.
Banner Create a dedicated banner Ad Unit.
  1. Click Create to save your Ad Unit.

After creating your Ad Unit, you can click + Advanced Settings to configure the ad format settings (see section on editing an Ad Unit, below), or Placements Management to create Placements and set up eCPM targets.

Editing an Ad Unit

From the Ad Units dashboard page, click on the Ad Unit you want to edit to view its ad format settings.

Setting Description
Ad Unit ID The Ad Unit’s unique identifier to reference in your code. The Ad Unit Name you specify automatically generates this ID when you create the Ad Unit, at which point you cannot change it.
Ad Unit Name A descriptive identifier by which to recognize the Ad Unit in the dashboard.
Status Enabled Ad Units can request and show ads, whereas archived Ad Units cannot. By default, Ad Units are enabled.
Ad types The various creative formats the Ad Unit can display. You may check all that apply.

  • Video ads are full-screen video advertisements.
  • Display ads are full-screen static images.
  • Playable ads are full-screen interactive advertisements.
  • Cross-Promo ads allow publishers to backfill their Ad Units with promotions for their own games.
  • AR ads offer players a fully immersive and interactive experience, by incorporating digital content directly into their physical world.
  • Banner ads are only available for Banner Ad Units.
Muting Check the Mute audio box to mute audio by default when video creatives play. By default, Ad Units are not muted.

Archiving an Ad Unit

You can archive Ad Units you aren’t using into a collapsable workspace. To do so, click the overflow options icon and select Archive. Archived Ad Units are automatically deactivated, meaning they cannot request or show ads.

You can expand the Archived Ad Units section at the bottom of the Ad Units page to reactivate archived Ad Units at any time.

Archiving Ad Units.

Implementing Ad Units in-game

Implementing Ad Units in your game is a three-step process:

  1. Initialize the Unity Ads SDK early in the game’s run-time lifecycle, preferably at launch. Unity recommends using the latest SDK.
  2. In your game code, check if content is ready to display through your specified Ad Unit.
  3. Programmatically retrieve the available content and display it.

For comprehensive code integration instructions, read the documentation for your development platform:

Unity Standard Ad Units

If you try to load or show an ad without specifying an ad unit or placement ID, then the default Unity_Standard_Ad-Unit appears. This replaces Unity_Standard_Placements.

What has changed about default placements?

  • Unity standard ad-units are interstitial format.
  • The name Unity_Standard_Ad-Unit appears in reporting.
  • You cannot edit, rename, or adjust this new standard ad-unit.

How do I stop using Unity Standard Ad-Units?

  1. Change your game code to call a specific placement, using the Load API.
  2. Release a new version of your game.

Is revenue affected?

Because most default placements see very small impression volumes, Unity expects there to be minimal to no revenue impact.

Still need help? Get in touch!
Last updated on 22nd Oct 2021