概览AndroidiOSUnityReact NativeFlutterCLIAPIMCP需求广告格式Dashboard更新日志

iion（BETA）

使用本指南在 CloudX 中启用 iion 竞价。

CloudX SDK 安装和广告加载步骤请参阅平台集成指南：

iion 是服务器端竞价方。CloudX 在服务器上请求出价，并使用 CloudX SDK 的内置渲染器展示获胜的广告素材。应用无需添加 iion SDK 或适配器。iion 需要 CloudX Android SDK 4.5.1 或更高版本，以及 CloudX iOS SDK 3.8.0 或更高版本。

iion 直接购买您的流量：您需要拥有自己的 iion 发布商账号，iion 直接向您支付其购买的展示费用。

概述

iion 在 CloudX 中无需配置凭据或网络映射，包括 iion 账号 ID、应用 ID 或广告位 ID。启用竞价方并添加广告项即可完成 CloudX 配置。

通过 CloudX 支持的广告格式

  • 横幅广告（320x50）
  • MREC（300x250）
  • 插屏广告
  • 激励视频广告
  • 开屏广告（App Open）

暂不支持原生广告。

第 1 步：开通 iion 账号并更新 app-ads.txt

在启用正式流量前，请联系 iion 客户经理开通发布商账号。如果您没有 iion 联系人，请让 CloudX 客户经理协助对接。

向 iion 提供您计划启用的应用，然后发布与您的 iion 卖方 ID 对应的 app-ads.txt 条目：

iion.io, <SELLER_ID>, DIRECT, 013a29748465dc57

将 <SELLER_ID> 替换为 iion 为您的账号分配的卖方 ID。将该条目发布到 https://yourdomain.com/app-ads.txt。其中 yourdomain.com 是 App Store 或 Google Play 中列出的开发者网站域名。保留 CloudX 和其他广告网络的现有条目，包括为其他平台添加的 iion RESELLER 条目。

第 2 步：在 CloudX 中启用 iion

进入 Bidders，在竞价方列表中选择 iion，然后点击 Enable。

无需填写任何内容：iion 在 CloudX 中没有账号级凭据、应用映射或广告位映射。如果禁用 iion，CloudX 将不会为您的库存请求 iion 出价。

第 3 步：添加 iion 广告项

进入 Line Items，为需要 iion 参与竞价的每个 CloudX 广告单元创建竞价方为 iion 的广告项。

  • 选择竞价方 iion
  • 定向到横幅、MREC、插屏、激励视频或开屏广告单元
  • 为每个需要 iion 参与竞价的广告单元重复配置

第 4 步：测试和验证

iion 不为 CloudX 提供正式的 RTB 测试模式。在 iion 确认您的账号且 app-ads.txt 条目生效后，请使用受控的正式流量进行验证。

  1. 使用实体设备。在测试设备中注册该设备，关闭 Test traffic，并开启 Debug Mode 以收集诊断信息。
  2. 使用 CloudX app_key 和正确的 CloudX 广告单元标识符构建并运行应用。不要以测试模式启动 SDK 会话。
  3. 从已启用 iion 的每个广告单元请求广告。
  4. 确认 iion 按预期参与竞价或获胜，并且返回的广告正常展示。
  5. 流量开始后，与 iion 核对展示次数和收入。

开启 Test traffic 时，已注册的设备会收到测试广告，其数据不会计入收入报表。即使关闭 Test traffic，iOS 模拟器会话和 SDK 测试模式会话仍会发送测试请求。请使用正式流量完成上述广告和收入验证。

小规模测试中的无填充可能是正常情况，本身不能说明配置有问题。

故障排除

列表中没有 iion

iion 目前在 CloudX 中处于测试阶段。如果在 Bidders 中看不到它，请联系 CloudX 客户经理申请访问权限。

iion 未参与竞价

首先检查以下内容：

  • 已在 Bidders 中启用 iion
  • 广告单元已配置 iion 广告项
  • 广告单元为横幅、MREC、插屏、激励视频或开屏广告（暂不支持原生广告）
  • iion 已为您开通账号并配置了您启用的应用
  • 您的 app-ads.txt 文件包含带有您卖方 ID 的 iion.io, <SELLER_ID>, DIRECT, 013a29748465dc57，且商店页面指向该开发者域名
  • 对于 iOS 应用，应用已在 App Store 上架，以便 CloudX 向 iion 发送应用的数字 App Store ID

iion 出价，但广告未展示

请检查以下内容：

  • 应用使用 CloudX app_key，并加载预期的 CloudX 广告单元
  • 应用使用 CloudX Android SDK 4.5.1 或更高版本，或 CloudX iOS SDK 3.8.0 或更高版本

iion 素材通过 CloudX SDK 的内置渲染器展示。如果某个素材持续展示失败，请向 CloudX 支持提供应用、广告单元和大致故障时间。

需求低于预期

  • 向 iion 确认您的卖方 ID 和 app-ads.txt 条目对您的账号正确无误。
  • 等待 iion 及其买方重新抓取更新后的 app-ads.txt 文件。
  • 使用受控的正式流量验证，因为 iion 不通过 CloudX 提供 RTB 测试需求。