集成

CloudX Android SDK 的 Meta Audience Network 适配器。支持 Banner、MREC、Interstitial、Rewarded、Native、Native Banner 和 Native MREC。

如需 CloudX 控制台映射和 Meta 侧 ID 配置,请参阅 Meta Audience Network 竞价方指南。本页仅说明 Android 特定的集成细节。

安装

dependencies {
    implementation("io.cloudx:adapter-meta:6.22.0.0")
}

原生广告

Meta 适配器支持 CloudX 原生广告,包括原生视频素材。io.cloudx:adapter-meta:6.22.0.0 会传递引入 Meta Audience Network 6.22.0;除非您的应用直接使用 Meta API,否则不需要单独声明 com.facebook.android:audience-network-sdk

展示跟踪要求

Meta 要求特定素材完成渲染并在屏幕上可见后才会计入展示,具体取决于 Meta placement 格式:

Meta placement 格式必需素材必需视图
Native媒体视图MediaView
Native Banner应用图标ImageView

完整的素材渲染要求请参阅 Meta 的 Native AdsNative Banner Ads 指南。

Meta placement 与 CloudX 广告单元的映射

Meta placement 格式CloudX 广告单元CloudX API必需素材由谁渲染
NativeNativeCloudXNativeAdLoader您的布局,通过绑定器的媒体容器
NativeMREC(300×250)CloudX.createMREC(...)CloudX 提供的布局
Native BannerBanner(320×50)CloudX.createBanner(...)CloudX 提供的布局

对于独立 Meta Native 广告,请使用 CloudXNativeAdViewBinder.setMediaContentViewGroupId(...) 绑定可见的媒体容器。CloudX 会将 Meta 的 MediaView 附加到该容器。完整布局和加载流程请参阅原生广告

如果您的布局无法容纳 Meta 的 MediaView,请改用映射到 CloudX Banner 广告单元的 Meta Native Banner placement。CloudX Native 广告单元不支持 Meta Native Banner placement:没有仅图标的绑定路径,展示将无法跟踪。

通过 CloudXAdView 投放的 Native Banner 和 MREC 素材使用 CloudX 提供的布局,因此发布商代码不需要原生绑定器。

兼容性

适配器版本广告网络 SDK最低 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

当服务端下发的 CloudX 配置包含 Meta 需求时,SDK 会自动发现该适配器。无需手动注册适配器。