Overview
Use the following values:Account IDin the CloudX app-level Magnite mappingSite IDin the CloudX app-level Magnite mappingZone IDin the CloudX ad-unit-level Magnite mapping- CloudX
app_keyand CloudX ad unit identifiers in app code
Step 1. Complete Magnite-side setup
- Sign in to your Magnite account.
- Identify the account you want to use for bidding.
- Copy the Magnite
Account ID. - Copy the Magnite
Site IDfor the app or property you want to monetize. - Create or identify a
Zone IDfor each ad format you want to use. - Complete any required Magnite review, app registration, and payout setup before expecting live demand.
Step 2. Enable Magnite in CloudX
Go toOperations -> Bidder Configuration and make sure Magnite is enabled for your account.
Magnite is disabled, CloudX will not request bids from Magnite even if your mappings are correct.
Step 3. Configure your CloudX app
Go toInventory -> Apps and create or open the app that matches your mobile application.
Add the following values to the Magnite mapping on the app:
| CloudX field | Value to enter | Required |
|---|---|---|
Account ID | Your Magnite account ID | Yes |
Site ID | Your Magnite site ID for this app | Yes |
app_key from the app details page. Use the CloudX app_key in Android or iOS code. Do not use Magnite account or site IDs as the CloudX SDK app key.
Step 4. Configure CloudX ad units
Go toInventory -> Apps -> [Your App] -> Ad units and add the Magnite mapping below for each eligible ad unit.
| CloudX field | Value to enter | Required |
|---|---|---|
Zone ID | The Magnite zone ID for that ad unit and format | Yes |
- Match the zone to the correct CloudX ad-unit format.
- Use a separate zone for each format you want Magnite to bid on.
- For Banner and MREC, make sure the zone matches the intended size.
Step 5. Add Magnite line items
Create line items for bidderMagnite on each CloudX ad unit where Magnite should compete.
- Use bidder
Magnite - Match the line item to the correct ad format
- Repeat the setup for each ad unit where Magnite should bid
Step 6. Finish app integration
Use the CloudX platform guides and the iOS Magnite adapter page: In app code:- Initialize CloudX with the CloudX
app_key - Load ads using CloudX ad unit identifiers
- Do not pass Magnite Account IDs, Site IDs, or Zone IDs into app code
- For Interstitial and Rewarded ads, call
show()only after the ad is ready
Step 7. Test and validate
- Enable test mode for your device in CloudX.
- Build and run the app with the CloudX
app_keyand the correct CloudX ad unit identifiers. - Request an ad from each mapped ad unit.
- Confirm that the ad loads and that Magnite participates or wins where expected.
Troubleshooting
Magnite is not bidding
Check the following first:Magniteis enabled inOperations -> Bidder Configuration- The app has a valid
Account ID - The app has a valid
Site ID - The ad unit has a valid
Zone ID - A
Magniteline item exists for the ad unit
Magnite bids but the ad does not render
Check the following:- Your app is using the CloudX
app_key, not a Magnite identifier - Your app is loading the intended CloudX ad unit
- The zone belongs to the correct Magnite format
- On iOS, the requirements from the Magnite Adapter page are complete
The mapping looks correct but loads still fail
The mobile adapters expectAccount ID, Site ID, and Zone ID to be present in the correct places. Re-check the app-level and ad-unit-level Magnite mappings in CloudX and make sure the values were copied exactly.
Mapping Reference
| CloudX field | Internal key | Scope |
|---|---|---|
Account ID | account_id | App |
Site ID | site_id | App |
Zone ID | zone_id | Ad unit |