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 步:测试和验证

  1. 将设备注册为 CloudX 测试设备,并为该应用打开 测试流量。
  2. 安装适配器后,构建并运行 Android 应用。
  3. 从每个已配置的广告单元请求广告,然后打开 Dev Tools → Auction Archive。打开每次竞价,检查 Bidder calls 中是否包含 BidMachine。

BidMachine 可能不会对测试流量出价;仅凭这一点并不能说明配置有误。

问题排查

  • Bidders 中没有 BidMachine: 请联系 CloudX 客户经理申请测试权限。
  • BidMachine 没有参与竞价: 检查竞价方是否启用、应用的 Source ID 是否正确,以及广告单元是否已有 BidMachine line item。未配置 Source ID 时,CloudX 不会初始化 BidMachine。
  • 无法解析 BidMachine 依赖: 添加 Android 适配器指南中列出的 Maven 仓库及全部四个依赖组。