Skip to main content
Keep using the platform integration guides for SDK installation and ad loading: For iOS-specific Mintegral adapter requirements, see the Mintegral Adapter page.

Overview

Use the following values:
  • Mintegral App ID and Mintegral App Key in CloudX app mapping
  • Mintegral Placement ID and Ad Unit ID in CloudX ad-unit mapping
  • CloudX app_key and CloudX ad unit identifiers in app code
CloudX collects Mintegral bidder tokens internally, so you do not need to fetch Mintegral bidder tokens in your app code.

Step 1. Complete Mintegral-side setup

  1. Sign in to your Mintegral publisher account.
  2. Add the app you want to monetize.
  3. Copy the Mintegral App ID and App Key for that app.
  4. Create placements and ad units for each format you want to use.
  5. Copy each Placement ID and Ad Unit ID.
  6. Complete Mintegral review and payout setup before expecting live demand.

Step 2. Enable Mintegral in CloudX

Go to Operations -> Bidder Configuration and make sure Mintegral is enabled for your account. Bidders If Mintegral 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 fieldValue to enterRequired
Mintegral App IDYour Mintegral App IDYes
Mintegral App KeyYour Mintegral App KeyYes
Mintegral App ID Also copy the CloudX app_key from the app details page. Use the CloudX app_key in Android or iOS code.

Step 4. Configure CloudX ad units

Go to Inventory -> Ad units and add the mappings below for each eligible ad unit.
CloudX fieldValue to enterRequired
Mintegral Placement IDThe Mintegral placement ID for that ad unit and formatYes
Ad Unit IDThe Mintegral ad unit ID paired with that placementYes
Mintegral Ad unit ID
  • Treat both Mintegral Placement ID and Ad Unit ID as required for mobile integrations.
  • Match the Mintegral placement and ad unit pair to the exact CloudX ad-unit format.
  • Use a separate Mintegral placement and ad unit pair for each CloudX ad unit or format as needed.

Step 5. Add Mintegral line items

Create line items for bidder Mintegral on each CloudX ad unit where Mintegral should compete. Line item
  • Use bidder Mintegral
  • Match the line item to the correct ad format
  • Repeat the setup for each ad unit where Mintegral should bid

Step 6. Finish app integration

Use the CloudX platform guides and the iOS Mintegral adapter page: In app code:
  • Initialize CloudX with the CloudX app_key
  • Load ads using CloudX ad unit identifiers
  • Do not pass Mintegral App IDs, App Keys, Placement IDs, or Ad Unit 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 Mintegral participates or wins where expected.

Troubleshooting

Mintegral is not bidding

Check the following first:
  • Mintegral is enabled in Operations -> Bidder Configuration
  • The app has a valid Mintegral App ID
  • The app has a valid Mintegral App Key
  • The ad unit has a valid Mintegral Placement ID
  • The ad unit has a valid Ad Unit ID
  • A Mintegral line item exists for the ad unit

Mintegral bids but the ad does not render

Check the following:
  • Your app is using the CloudX app_key, not a Mintegral ID
  • Your app is loading the intended CloudX ad unit
  • The Placement ID and Ad Unit ID belong to the same Mintegral app and format
  • On iOS, the requirements from the Mintegral Adapter page are complete

The placement looks correct but loads still fail

Current mobile adapters require Ad Unit ID at load time. Re-check the ad-unit-level Ad Unit ID mapping in CloudX even though the backend schema marks it as optional.

Mapping Reference

CloudX fieldInternal keyScope
Mintegral App IDapp_idApp
Mintegral App Keyapp_keyApp
Mintegral Placement IDplacement_idAd unit
Ad Unit IDad_unit_idAd unit