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

Overview

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

Step 1. Complete Meta-side setup in Monetization Manager

  1. Sign in to Meta and open Monetization Manager.
  2. Add the app or property you want to monetize.
  3. Create placements for each format you want to use.
  4. Copy the Meta App ID and each Placement ID.
  5. Complete Meta review and payout setup before expecting live demand.
Official Meta references:

Step 2. Enable Meta in CloudX

Go to Operations -> Bidder Configuration and make sure Meta Audience Network is enabled for your account. Bidders If Meta Audience Network is disabled, CloudX will not request bids from Meta 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
Meta App IDYour Meta Audience Network App IDYes
Meta App ID 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 Meta App 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 fieldValue to enterRequired
Meta Placement IDThe Meta placement ID for that ad unit and formatYes
Meta Ad unit ID
  • Treat Meta Placement ID as required on both platforms.
  • Match the Meta placement to the CloudX ad-unit format and size.
  • For Banner and MREC, use a placement created for the correct size.

Step 5. Add Meta line items

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

Step 6. Finish app integration

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

Troubleshooting

Meta is not bidding

Check the following first:
  • Meta Audience Network is enabled in Operations -> Bidder Configuration
  • The app has a valid Meta App ID
  • The ad unit has a valid Meta Placement ID
  • A Meta Audience Network line item exists for the ad unit
  • The Meta placement matches the ad format and size

Meta bids but the ad does not render

Check the following:
  • Your app is using the CloudX app_key, not a Meta ID
  • Your app is loading the intended CloudX ad unit
  • Interstitial and Rewarded ads are only shown after they finish loading
  • On iOS, the requirements from the Meta Adapter page are complete

Placement mapping looks correct but Android still fails to load

On Android, missing or empty Meta placement data causes the adapter load to fail. Re-check the ad-unit-level Meta Placement ID mapping in CloudX.

Placement mapping looks correct but iOS behavior is inconsistent

The current iOS adapter can fall back internally in some cases, but you should not rely on that behavior. Always configure Meta Placement ID explicitly for every ad unit.

Mapping Reference

CloudX fieldInternal keyScope
Meta App IDapp_idApp
Meta Placement IDplacement_idAd unit
If you see audienceNetwork in internal logs or backend configuration, that refers to the same Meta bidder.