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:
- From the left navigation menu, select Monetization > Ad Units.
- Click Add Ad Unit to bring up the creation modal.
- 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.|
- 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.
|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.
|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.
Implementing Ad Units in-game
Implementing Ad Units in your game is a three-step process:
- Initialize the Unity Ads SDK early in the game’s run-time lifecycle, preferably at launch. Unity recommends using the latest SDK.
- In your game code, check if content is ready to display through your specified Ad Unit.
- Programmatically retrieve the available content and display it.
For comprehensive code integration instructions, read the documentation for your development platform:
Unity Standard Placements
If you call the
Show API without specifying an Ad Unit (games using Unity Ads exclusively) or Placement (games using Unity Ads in a third-party mediation stack) in the function, the API defaults to showing the Unity Standard Placement. Unity Standard Placements do not appear in the dashboard, but will appear in reporting as Unity_Standard_Placement if there is applicable data to show.
Note: As of July 12, 2021, you will no longer be able to choose or edit a default Ad Unit or Placement for this functionality. If you have already done so, Unity will create a Unity_Standard_Placement with identical settings on this date.