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

概览

请使用以下值:
  • 在 CloudX 应用映射中填写 Vungle App ID
  • 在 CloudX 广告单元映射中填写 Vungle Placement ID
  • 在应用代码中使用 CloudX app_key 和 CloudX 广告单元标识符
CloudX 在控制台中使用的 bidder 名称是 Vungle。如果您在外部网络资料中看到 Liftoff 品牌,它指的是同一个网络。 CloudX 会在内部收集 Vungle 的 bidder token,因此您无需在应用代码中自行获取 Vungle bidder token。

第 1 步:完成 Vungle 侧配置

  1. 登录您的 Vungle 或 Liftoff Monetize publisher 账号。
  2. 添加您要变现的应用。
  3. 复制该应用对应的 Vungle App ID。
  4. 为您要使用的每种广告格式创建 placement。
  5. 复制每个 placement ID。
  6. 在预期接入正式流量前,先完成 Vungle 审核和收款设置。
Native placement 可能需要 Vungle 侧启用后才会有竞价流量。如果映射正确但 Native 填充始终为零,请联系您的 Liftoff Monetize 客户经理。

第 2 步:在 CloudX 中启用 Vungle

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

第 3 步:配置 CloudX 应用

前往 Inventory -> Apps,创建或打开与您的移动应用对应的应用。 Vungle App ID 同时从应用详情页复制 CloudX app_key。在 Android 或 iOS 代码中使用 CloudX app_key

第 4 步:配置 CloudX 广告单元

前往 Inventory -> Ad units,为每个可接入的广告单元添加如下映射。 Vungle Ad unit ID
  • 在两个平台上都应将 Vungle Placement ID 视为必填项。
  • 让 placement 与正确的 CloudX 广告单元格式匹配。
  • 根据需要,为每个 CloudX 广告单元或广告格式使用单独的 placement。

第 5 步:添加 Vungle line item

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

第 6 步:完成应用集成

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

第 7 步:测试和验证

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

问题排查

Vungle 没有参与竞价

请先检查以下项目:
  • Vungle 已在 Operations -> Bidder Configuration 中启用
  • 应用已配置有效的 Vungle App ID
  • 广告单元已配置有效的 Vungle Placement ID
  • 广告单元上已存在 Vungle line item

Vungle 已出价但广告未正常展示

请检查以下项目:
  • 您的应用使用的是 CloudX app_key,而不是 Vungle ID
  • 您的应用加载的是目标 CloudX 广告单元
  • 该 placement 属于正确的 Vungle 应用和广告格式
  • iOS 端已完成 Vungle 适配器页面 中的要求

Placement 看起来正确,但仍然加载失败

移动端适配器在加载时需要有效的 Vungle Placement ID。请重新检查 CloudX 中广告单元级别的 placement 映射。

映射参考