集成
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")
}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 Ads 和 Native Banner Ads 指南。
Meta placement 与 CloudX 广告单元的映射
| Meta placement 格式 | CloudX 广告单元 | CloudX API | 必需素材由谁渲染 |
|---|---|---|---|
| Native | Native | CloudXNativeAdLoader | 您的布局,通过绑定器的媒体容器 |
| Native | MREC(300×250) | CloudX.createMREC(...) | CloudX 提供的布局 |
| Native Banner | Banner(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.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 |
当服务端下发的 CloudX 配置包含 Meta 需求时,SDK 会自动发现该适配器。无需手动注册适配器。