BidMachine
在 CloudX 中配置 BidMachine Android 竞价及 Source ID 映射。
概览
BidMachine Source ID 用于向 BidMachine SDK 标识您的应用。请在 CloudX 应用级别的 BidMachine Source ID 字段中填写,不要将其写入应用代码或用作 CloudX 广告单元 ID。
Android 适配器支持:
- Banner(320x50)
- MREC(300x250)
- Interstitial(展示广告和视频)
- Rewarded
不支持 Native 和 App Open。需要 CloudX Android SDK 4.9.0 或更高版本。使用 BidMachine 时,建议使用 CloudX Android SDK 4.12.0 或更高版本。
第 1 步:获取 Source ID
向 BidMachine 获取您的应用对应的 BidMachine Source ID。请使用该应用的正式 Source ID。
第 2 步:在 CloudX 中启用 BidMachine
前往 Bidders,选择 BidMachine,然后点击 Enable。
选择要配置的应用并填写其 Source ID:
| CloudX 字段 | 填写内容 | 作用范围 | 必填 |
|---|---|---|---|
BidMachine Source ID | 该应用对应的 BidMachine Source ID | 应用 | 是 |
广告单元无需配置 BidMachine Placement ID。请在应用代码中使用 CloudX 广告单元标识符。
第 3 步:添加 line item
前往 Line Items,在每个需要让 BidMachine 参与竞争的 CloudX 广告单元上,为竞价方 BidMachine 创建 line item。请选择支持的广告格式。
第 4 步:安装适配器
请按照 Android 适配器指南或 Unity Android 适配器指南进行配置。两者均包含必需的 BidMachine Maven 仓库;仅使用 Maven Central 无法解析 BidMachine SDK。
React Native 或 Flutter 的 Android 构建请参阅 React Native或 Flutter集成指南。
使用 CloudX 应用密钥初始化 CloudX,并使用 CloudX 广告单元标识符加载广告。CloudX 会使用控制台中配置的 Source ID 初始化 BidMachine,应用代码无需单独初始化 BidMachine。
第 5 步:测试和验证
- 将设备注册为 CloudX 测试设备,并为该应用打开
测试流量。 - 安装适配器后,构建并运行 Android 应用。
- 从每个已配置的广告单元请求广告,然后打开 Dev Tools → Auction Archive。打开每次竞价,检查 Bidder calls 中是否包含 BidMachine。
BidMachine 可能不会对测试流量出价;仅凭这一点并不能说明配置有误。
问题排查
- Bidders 中没有 BidMachine: 请联系 CloudX 客户经理申请测试权限。
- BidMachine 没有参与竞价: 检查竞价方是否启用、应用的 Source ID 是否正确,以及广告单元是否已有 BidMachine line item。未配置 Source ID 时,CloudX 不会初始化 BidMachine。
- 无法解析 BidMachine 依赖: 添加 Android 适配器指南中列出的 Maven 仓库及全部四个依赖组。