Skip to main content
SDK 安装和广告加载方式请继续参考平台集成文档： 如需查看各平台特有的 Meta 适配器要求，请参阅 Android 和 iOS Meta 适配器页面。

​
概览

请使用以下值：
  • 在 CloudX 应用映射中填写 Meta App ID
  • 在 CloudX 广告单元映射中填写 Meta Placement ID
  • 在应用代码中使用 CloudX app_key 和 CloudX 广告单元标识符
CloudX 会在内部收集 Meta 的 bidder token，因此您无需在应用代码中自行获取 Meta bidder token。

​
第 1 步：在 Monetization Manager 中完成 Meta 侧配置

  1. 登录 Meta 并打开 Monetization Manager。
  2. 添加您要变现的应用或资产。
  3. 为您要使用的每种广告格式创建 placement。
  4. 复制 Meta App ID 以及每个 Placement ID。
  5. 在预期接入正式流量前，先完成 Meta 审核和收款设置。
Meta 官方参考文档：

​
第 2 步：在 CloudX 中启用 Meta

前往 Operations -> Bidder Configuration，确认您的账号已启用 Meta Audience Network。 Bidders 如果 Meta Audience Network 未启用，即使映射配置正确，CloudX 也不会向 Meta 发起竞价请求。

​
第 3 步：配置 CloudX 应用

前往 Inventory -> Apps，创建或打开与您的移动应用对应的应用。 Meta App ID 同时从应用详情页复制 CloudX app_key。在 Android 或 iOS 代码中使用 CloudX app_key，不要将 Meta App ID 当作 CloudX SDK 的 app key。

​
第 4 步：配置 CloudX 广告单元

前往 Inventory -> Apps -> [Your App] -> Ad units，为每个可接入的广告单元添加如下映射。 Meta Ad unit ID
  • 在两个平台上都应将 Meta Placement ID 视为必填项。
  • 让 Meta placement 与 CloudX 广告单元的广告格式和尺寸保持一致。
  • 对于 Banner 和 MREC，请使用为正确尺寸创建的 placement。

​
Placement 格式映射

创建每个 Meta placement 时，请使用与其映射的 CloudX 广告单元相匹配的格式： Native banner 是一种紧凑的原生素材——包含应用图标、文本和行动号召，没有大尺寸媒体视图——在 banner 广告位中渲染。Meta 通过 Native Banner placement 投放这类素材，对应映射到 CloudX Banner 广告单元。
不要将 Meta Native Banner placement 映射到 CloudX Native 广告单元；该组合不受支持，展示将无法跟踪。Native 格式还有各平台的素材渲染要求——请参阅 Android 和 iOS Meta 适配器页面。

​
第 5 步：添加 Meta line item

在每个需要让 Meta 参与竞争的 CloudX 广告单元上，为 bidder Meta Audience Network 创建 line item。 Line item
  • 使用 bidder Meta Audience Network
  • 让 line item 与正确的广告格式匹配
  • 对每个需要 Meta 参与竞价的广告单元重复上述配置

​
第 6 步：完成应用集成

请结合 CloudX 平台文档和 iOS Meta 适配器页面完成集成： 在应用代码中：
  • 使用 CloudX app_key 初始化 CloudX
  • 使用 CloudX 广告单元标识符加载广告
  • 不要在应用代码中传入 Meta App ID 或 Meta Placement ID
  • 对于插屏和激励广告，仅在广告准备完成后再调用 show()

​
第 7 步：测试和验证

  1. 在 CloudX 中为您的设备启用测试模式。
  2. 使用 CloudX app_key 和正确的 CloudX 广告单元标识符构建并运行应用。
  3. 从每个已映射的广告单元发起广告请求。
  4. 确认广告能够正常加载，并且 Meta 会按预期参与竞价或胜出。

​
问题排查

​
Meta 没有参与竞价

请先检查以下项目：
  • Meta Audience Network 已在 Operations -> Bidder Configuration 中启用
  • 应用已配置有效的 Meta App ID
  • 广告单元已配置有效的 Meta Placement ID
  • 广告单元上已存在 Meta Audience Network line item
  • Meta placement 与广告格式和尺寸匹配

​
Meta 已出价但广告未正常展示

请检查以下项目：
  • 您的应用使用的是 CloudX app_key，而不是 Meta ID
  • 您的应用加载的是目标 CloudX 广告单元
  • 插屏和激励广告只会在完成加载后展示
  • iOS 端已完成 Meta 适配器页面 中的要求

​
广告正常渲染但 Meta 没有记录展示

只有当 placement 格式的必需素材完成渲染并在屏幕上可见时，Meta 才会计入原生广告展示——Native 需要媒体视图，Native Banner 需要应用图标。广告可能正常显示，而所有展示都被静默丢弃。请对照 Android 或 iOS Meta 适配器页面核实必需素材的绑定，并确认上文的 placement 格式映射。

​
Placement 映射看起来正确，但 Android 仍然加载失败

在 Android 上，如果 Meta placement 数据缺失或为空，适配器会加载失败。请重新检查 CloudX 中广告单元级别的 Meta Placement ID 映射。

​
Placement 映射看起来正确，但 iOS 表现不稳定

当前 iOS 适配器在某些情况下可能会在内部进行兜底，但不应依赖这种行为。请始终为每个广告单元显式配置 Meta Placement ID。

​
映射参考

如果您在内部日志或后端配置中看到 audienceNetwork，它指的就是同一个 Meta bidder。