> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Meta Audience Network
> 使用本指南在 CloudX 中配置 Meta Audience Network 竞价。
SDK 安装和广告加载方式请继续参考平台集成文档：
* [Android 集成指南](/zh/android/integration)
* [iOS 集成指南](/zh/ios/integration)
如需查看 iOS 平台特有的 Meta 适配器要求，请参阅 [Meta 适配器页面](/zh/ios/adapters/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 官方参考文档：
* [Meta Audience Network getting started](https://business.facebook.com/audiencenetwork/getting-started/)
* [Meta app bidding setup](https://developers.facebook.com/docs/audience-network/bidding/partner-mediation)
## 第 2 步：在 CloudX 中启用 Meta
前往 `Operations -> Bidder Configuration`，确认您的账号已启用 `Meta Audience Network`。
如果 `Meta Audience Network` 未启用，即使映射配置正确，CloudX 也不会向 Meta 发起竞价请求。
## 第 3 步：配置 CloudX 应用
前往 `Inventory -> Apps`，创建或打开与您的移动应用对应的应用。
| CloudX 字段 | 填写内容 | 必填 |
| ------------- | ------------------------------- | -- |
| `Meta App ID` | 您的 Meta Audience Network 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`，为每个可接入的广告单元添加如下映射。
| CloudX 字段 | 填写内容 | 必填 |
| ------------------- | ------------------------------- | -- |
| `Meta Placement ID` | 该广告单元和广告格式对应的 Meta placement ID | 是 |
* 在两个平台上都应将 `Meta Placement ID` 视为必填项。
* 让 Meta placement 与 CloudX 广告单元的广告格式和尺寸保持一致。
* 对于 Banner 和 MREC，请使用为正确尺寸创建的 placement。
## 第 5 步：添加 Meta line item
在每个需要让 Meta 参与竞争的 CloudX 广告单元上，为 bidder `Meta Audience Network` 创建 line item。
* 使用 bidder `Meta Audience Network`
* 让 line item 与正确的广告格式匹配
* 对每个需要 Meta 参与竞价的广告单元重复上述配置
## 第 6 步：完成应用集成
请结合 CloudX 平台文档和 iOS Meta 适配器页面完成集成：
* [Android 集成指南](/zh/android/integration)
* [iOS 集成指南](/zh/ios/integration)
* [Meta 适配器页面](/zh/ios/adapters/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 适配器页面](/zh/ios/adapters/meta) 中的要求
### Placement 映射看起来正确，但 Android 仍然加载失败
在 Android 上，如果 Meta placement 数据缺失或为空，适配器会加载失败。请重新检查 CloudX 中广告单元级别的 `Meta Placement ID` 映射。
### Placement 映射看起来正确，但 iOS 表现不稳定
当前 iOS 适配器在某些情况下可能会在内部进行兜底，但不应依赖这种行为。请始终为每个广告单元显式配置 `Meta Placement ID`。
## 映射参考
| CloudX 字段 | 内部 key | 作用范围 |
| ------------------- | -------------- | ---- |
| `Meta App ID` | `app_id` | App |
| `Meta Placement ID` | `placement_id` | 广告单元 |
如果您在内部日志或后端配置中看到 `audienceNetwork`，它指的就是同一个 Meta bidder。