> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Unity Ads
> Use this guide to configure Unity Ads bidding in CloudX.
Keep using the platform integration guides for SDK installation and ad loading:
* [Android integration guide](/en/android/integration)
* [iOS integration guide](/en/ios/integration)
For iOS-specific Unity Ads adapter requirements, see the [Unity Ads Adapter page](/en/ios/adapters/unityads/overview).
## Overview
Use the following values:
* `Unity Game ID` in CloudX app mapping
* `Unity Placement ID` in CloudX ad-unit mapping
* CloudX `app_key` and CloudX ad unit identifiers in app code
Unity uses both ad units and placements in the Monetization dashboard. For CloudX bidding setup, use the platform-specific `Game ID` for the app and the bidding `Placement ID` for each mapped ad unit.
CloudX collects Unity bidder tokens internally, so you do not need to fetch Unity bidder tokens in your app code.
## Step 1. Complete Unity-side setup
1. Sign in to the Unity Monetization dashboard.
2. Create or open the project you want to monetize and enable Unity Ads for it.
3. Go to `Monetization -> Placements` and note the platform-specific `Game ID`.
4. Create the ad units you want to monetize and create or use a bidding placement for each eligible format.
5. Copy each `Placement ID`.
6. Complete Unity account verification and payout setup before expecting live demand.
Official Unity references:
* [Create ad units and placements](https://docs.unity.com/grow/dashboard/ad-units/create)
* [Unity Ads integration](https://docs.unity.com/grow/levelplay/sdk/unity/networks/guides/unity-ads)
## Step 2. Enable Unity Ads in CloudX
Go to `Operations -> Bidder Configuration` and make sure `Unity Ads` is enabled for your account.
If `Unity Ads` is disabled, CloudX will not request bids even if your mappings are correct.
## Step 3. Configure your CloudX app
Go to `Inventory -> Apps` and create or open the app that matches your mobile application.
| CloudX field | Value to enter | Required |
| --------------- | ---------------------------------------------------------- | -------- |
| `Unity Game ID` | The Unity Game ID for the same platform as this CloudX app | Yes |
Also copy the CloudX `app_key` from the app details page. Use the CloudX `app_key` in Android or iOS code. Do not use the Unity Game ID as the CloudX SDK app key.
## Step 4. Configure CloudX ad units
Go to `Inventory -> Apps -> [Your App] -> Ad units` and add the mapping below for each eligible ad unit.
| CloudX field | Value to enter | Required |
| -------------------- | ---------------------------------------------------------- | -------- |
| `Unity Placement ID` | The Unity bidding Placement ID for that ad unit and format | Yes |
* Copy the `Placement ID`, not the display name of the placement.
* Match the placement to the correct CloudX ad-unit format.
* Make sure the placement belongs to the same Unity project and platform as the `Unity Game ID`.
* Unity allows only one bidding placement per ad unit, so create separate ad units or placements as needed for different formats.
## Step 5. Add Unity Ads line items
Create line items for bidder `Unity Ads` on each CloudX ad unit where Unity should compete.
* Use bidder `Unity Ads`
* Match the line item to the correct ad format
* Repeat the setup for each ad unit where Unity Ads should bid
## Step 6. Finish app integration
Use the CloudX platform guides and the iOS Unity Ads adapter page:
* [Android integration guide](/en/android/integration)
* [iOS integration guide](/en/ios/integration)
* [Unity Ads Adapter page](/en/ios/adapters/unityads/overview)
In app code:
* Initialize CloudX with the CloudX `app_key`
* Load ads using CloudX ad unit identifiers
* Do not pass Unity Game IDs or Placement IDs into app code
* For Interstitial and Rewarded ads, call `show()` only after the ad is ready
## Step 7. Test and validate
1. Enable test mode for your device in CloudX.
2. Build and run the app with the CloudX `app_key` and the correct CloudX ad unit identifiers.
3. Request an ad from each mapped ad unit.
4. Confirm that the ad loads and that Unity Ads participates or wins where expected.
## Troubleshooting
### Unity Ads is not bidding
Check the following first:
* `Unity Ads` is enabled in `Operations -> Bidder Configuration`
* The app has a valid `Unity Game ID`
* The ad unit has a valid `Unity Placement ID`
* A `Unity Ads` line item exists for the ad unit
* The Unity placement is a bidding placement for the correct format
### Unity Ads bids but the ad does not render
Check the following:
* Your app is using the CloudX `app_key`, not a Unity Game ID
* Your app is loading the intended CloudX ad unit
* The Unity Game ID and Placement ID belong to the same Unity project and platform
* On iOS, the requirements from the [Unity Ads Adapter page](/en/ios/adapters/unityads/overview) are complete
### The mapping looks correct but loads still fail
Unity issues are often caused by using credentials from the wrong platform or copying the ad unit name instead of the actual `Placement ID`. Re-check the app-level `Unity Game ID` and ad-unit-level `Unity Placement ID` in CloudX.