EasyFly-Ads

Appearance

广告位配置 ​

本章详细介绍在 EasyFly-Ads 管理后台和各大联盟平台创建、配置广告位的完整流程。

配置流程总览 ​

mermaid
flowchart LR
    A[联盟平台创建广告位] --> B[获取广告位ID]
    B --> C[EasyFly后台添加广告位]
    C --> D[绑定广告场景]
    D --> E[设置竞价参数]
    E --> F[客户端联调测试]
    F --> G[上线运行]

一、联盟平台创建广告位 ​

穿山甲 ​

  1. 进入穿山甲后台 → 广告位管理 → 新建广告位
  2. 选择广告类型（开屏/信息流/激励视频/插屏/Banner）
  3. 填写广告位名称和描述
  4. 设置广告样式（模板渲染 / 自渲染）
  5. 创建完成后获取 广告位 ID（code_id）

优量汇 ​

  1. 进入优量汇后台 → 广告位管理 → 新增广告位
  2. 选择所属媒体
  3. 选择广告类型
  4. 填写广告位名称
  5. 创建完成后获取 广告位 ID

快手联盟 ​

  1. 进入快手后台 → 流量管理 → 广告管理
  2. 创建广告位，选择所属应用
  3. 选择广告形态
  4. 创建完成后获取 广告位 ID（pos_id）

百度联盟 ​

  1. 进入百度后台 → 合作管理 → 代码位管理
  2. 新建代码位
  3. 选择广告类型和尺寸
  4. 创建完成后获取 代码位 ID

二、EasyFly-Ads 后台配置 ​

添加广告位 ​

进入后台 → 广告管理 → 广告位配置 → 添加广告位

配置项说明
广告位名称后台识别名称，建议按规范命名
联盟平台选择穿山甲 / 优量汇 / 快手 / 百度
广告类型开屏 / 信息流 / 激励视频 / 插屏 / Banner / 原生
联盟广告位 ID填入联盟平台获取的 ID
关联应用选择所属 App

绑定场景 ​

在 广告场景管理 中，将广告位绑定到对应场景：

  1. 选择目标场景（如"首页开屏"）
  2. 点击 添加广告位
  3. 从已有广告位列表中选择
  4. 设置优先级（数字越小越优先）

竞价与频次设置 ​

配置项说明建议值
竞价位在瀑布流中的排序按 eCPM 从高到低
底价设置最低出价保护¥3 - ¥5
展示频次单用户每日最多展示次数3-5 次
展示间隔两次展示之间的最小间隔30 - 60 秒
负载均衡是否在同等 eCPM 间均匀分配流量开启

高级选项 ​

配置项说明
时段定向特定时段启用/禁用该广告位
用户定向按用户标签（新老用户、活跃度等）定向
地域定向按省市定向展示
设备定向按设备型号、系统版本定向
并行请求是否同时向多个联盟发起请求（Bidding模式）

三、客户端验证 ​

配置完成后，使用测试设备验证：

Android 测试 ​

kotlin
// 使用测试模式
AdConfig.setTestMode(true)  // 仅开发阶段
AdConfig.setTestDeviceId("your_test_device_id")

// 验证广告加载
sceneManager.loadAd("splash_home") { result ->
    when (result) {
        is AdResult.Success -> Log.d("AdTest", "加载成功: ${result.ad}")
        is AdResult.Failure -> Log.e("AdTest", "加载失败: ${result.error}")
    }
}

检查清单 ​

  • [ ] 联盟平台广告位状态为"运行中"
  • [ ] 广告位 ID 填写正确，无多余空格
  • [ ] 广告场景与广告位关联关系正确
  • [ ] 测试设备能正常加载和展示广告
  • [ ] 广告展示数据在后台统计中正常上报
  • [ ] 多联盟切换正常（遮断/降级）

常见问题 ​

问题可能原因解决方法
广告不展示广告位未审核通过在联盟后台确认状态
广告展示黑屏广告包名不匹配确认包名与联盟后台一致
收益为零数据上报异常检查 SDK 上报接口
广告类型不匹配场景类型与广告位类型不一致确保类型一致
填充率低广告素材少或定向条件太严放宽定向条件

相关功能 ​