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

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 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.

If your layout cannot host Meta’s MediaView, use a Meta Native Banner placement mapped to a CloudX Banner ad unit instead. Meta Native Banner placements are not supported in CloudX Native ad units: there is no icon-only binder path, so impressions will not track.

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.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.