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")
}

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 formatRequired assetRequired view
NativeMedia viewMediaView
Native BannerApp iconImageView

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 formatCloudX ad unitCloudX APIWho renders the required asset
NativeNativeCloudXNativeAdLoaderYour layout, via the binder’s media container
NativeMREC (300×250)CloudX.createMREC(...)CloudX-provided layout
Native BannerNativeCloudXNativeAdLoaderYour layout, via the binder’s icon image view
Native BannerBanner (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 versionNetwork SDKMinimum CloudX SDK
6.22.0.2Meta Audience Network 6.22.04.2.0
6.22.0.1Meta Audience Network 6.22.04.2.0
6.22.0.0Meta Audience Network 6.22.04.2.0
6.21.0.3Meta Audience Network 6.21.04.2.0
6.21.0.2Meta Audience Network 6.21.04.0.0
6.21.0.1Meta Audience Network 6.21.04.0.0
6.21.0.0Meta Audience Network 6.21.04.0.0
6.20.0.0Meta Audience Network 6.20.04.0.0

The adapter is discovered automatically when your server-provisioned CloudX configuration includes Meta demand. No manual adapter registration is required.