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
• iOS integration guide

For platform-specific Unity Ads adapter requirements, see:

• Android Unity Ads Adapter page
• iOS Unity Ads Adapter page
• Unity Ads Adapter page for Unity

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
• Unity Ads integration

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.

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.

• 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

Complete the integration and adapter setup for your platform:

• Android integration guide
• iOS integration guide
• Unity integration guide
• Android Unity Ads Adapter page
• iOS Unity Ads Adapter page
• Unity Ads Adapter page for Unity

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 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.