Integration
Meta Audience Network adapter for CloudX Android SDK. Supports Banner, MREC, Interstitial, Rewarded, Native, Native Banner, and Native MREC.
For CloudX dashboard mapping and Meta-side ID setup, see the Meta Audience Network bidder guide. This page covers Android-specific integration details only.
Install
dependencies {
implementation("io.cloudx:adapter-meta:6.22.0.2")
}dependencies {
implementation 'io.cloudx:adapter-meta:6.22.0.2'
}Native Ads
The Meta adapter supports CloudX native ads, including native video creatives. The adapter brings in Meta Audience Network transitively; you do not need to declare com.facebook.android:audience-network-sdk separately unless your app uses Meta APIs directly.
Impression tracking requirements
Meta requires a specific asset to be rendered and visible on screen before it counts an impression, depending on the Meta placement format:
| Meta placement format | Required asset | Required view |
|---|---|---|
| Native | Media view | MediaView |
| Native Banner | App icon | ImageView |
See Meta’s Native Ads and Native Banner Ads guides for the full asset rendering requirements.
Mapping Meta placements to CloudX ad units
| Meta placement format | CloudX ad unit | CloudX API | Who renders the required asset |
|---|---|---|---|
| Native | Native | CloudXNativeAdLoader | Your layout, via the binder’s media container |
| Native | MREC (300×250) | CloudX.createMREC(...) | CloudX-provided layout |
| Native Banner | Native | CloudXNativeAdLoader | Your layout, via the binder’s icon image view |
| Native Banner | Banner (320×50) | CloudX.createBanner(...) | CloudX-provided layout |
For standalone Meta Native ads, bind a visible media container with CloudXNativeAdViewBinder.setMediaContentViewGroupId(...). CloudX attaches Meta’s MediaView to that container. See Native ads for the complete layout and loading flow.
For standalone Meta Native Banner ads (adapter 6.22.0.2 or later), bind an icon image view with CloudXNativeAdViewBinder.setIconImageViewId(...). No media view container is required.
Native Banner and MREC creatives served through CloudXAdView use CloudX-provided layouts, so no native binder is required in publisher code.
Compatibility
| Adapter version | Network SDK | Minimum CloudX SDK |
|---|---|---|
6.22.0.2 | Meta Audience Network 6.22.0 | 4.2.0 |
6.22.0.1 | Meta Audience Network 6.22.0 | 4.2.0 |
6.22.0.0 | Meta Audience Network 6.22.0 | 4.2.0 |
6.21.0.3 | Meta Audience Network 6.21.0 | 4.2.0 |
6.21.0.2 | Meta Audience Network 6.21.0 | 4.0.0 |
6.21.0.1 | Meta Audience Network 6.21.0 | 4.0.0 |
6.21.0.0 | Meta Audience Network 6.21.0 | 4.0.0 |
6.20.0.0 | Meta Audience Network 6.20.0 | 4.0.0 |
The adapter is discovered automatically when your server-provisioned CloudX configuration includes Meta demand. No manual adapter registration is required.