聚猫线下核销对接聚合广告APP开发

聚猫线下核销对接聚合广告APP开发，聚猫线下核销对接聚合广告APP开发，聚猫线下核销对接聚合广告APP开发

聚猫类 — 线下核销 + 聚合广告对接」完整方案（偏技术对接 + 流程 + 关键代码逻辑），重点解决：广告怎么接、水券怎么发、核销怎么闭环、防刷与对账怎么做。

---

一、整体流程（必须闭环）

用户端：注册 / 登录 → 看激励视频广告 → 发水滴 / 水券 → LBS 找附近水机 / 水站 → 生成核销码 → 商家 / 水机扫码核销 → 出水 / 领水 → 广告收益覆盖水成本 + 盈利

平台端：聚合 SDK（TopOn）→ 穿山甲 / 优量汇 / 快手 → 广告曝光 / 完播 → 回调发水券 → 核销扣券 → 每日对账结算

---

二、广告对接（核心：聚合 SDK + 三大联盟）

1. 推荐组合（2026 填充率 & eCPM 高）

聚合层：TopOn（必选），做竞价 + 调度 + 防刷 + 数据统计

主广告源：穿山甲（巨量）、优量汇（腾讯）、快手联盟

备用：百青藤（百度）、美团联盟（本地生活）

2. 账号与资质准备

1. 公司主体、ICP 备案、软著

2. 各联盟开发者账号 + 实名认证 + 创建应用

3. 在 TopOn 创建应用→创建广告位→绑定各联盟广告位 ID，拿到：

4. TopOn：AppID、广告位 ID（激励视频 / 插屏 / 信息流）

5. 穿山甲 / 优量汇：AppID、代码位 ID、密钥

3. SDK 集成（Flutter / 原生都适用）

（1）初始化（APP 启动时）

先弹隐私授权（必须，否则联盟拒审）

再异步初始化 TopOn，配置各联盟 Adapter

伪代码（示意）：

dart（2）广告位设计（聚猫核心 3 个位置）

1. 领水主入口：激励视频（必看）

2. 15–30 秒，完整播放才发水券

3. 1 条广告 = 1 瓶 550ml 水券（后台可配）

4. 核销后：插屏广告（被动）

5. 核销成功弹出，提升收益

6. 首页 / 任务页：信息流 + 横幅

7. 补量、提高 eCPM

（3）广告加载 & 播放逻辑（防漏回调）

预加载：进入 “领水” 页提前加载激励视频，减少等待

播放成功回调：

intext

onAdComplete → 后端发水券/水滴 → 前端更新余额

失败 / 跳过：不发券，提示 “看完视频才能领水”

（4）频次 & 风控（联盟规则 + 防刷）

单用户日限 15–20 条激励视频（防疲劳 + 防刷）

两次广告间隔≥2 分钟

快进 / 播放 < 90% 时长→无效，不发券

设备：禁模拟器 / ROOT / 多开；OAID/IDFA 绑定

---

三、广告→水券→核销 闭环开发（重中之重）

1. 水券 / 水滴规则（后台可配置）

激励视频（30 秒完整）：800–1000 水滴 = 1 瓶 550ml

1 桶 18.9L ≈ 8000–10000 水滴

新人：首次看广告直接送1 瓶券（拉新）

2. 核销码生成（安全 + 唯一）

加密规则：用户 ID + 券 ID + 时间戳 + 随机数 + 签名

有效期：24 小时（可配置）

一码一用，核销后立即失效

3. 线下核销对接（两种方式）

方案 A：水机硬件对接（主流）

APP 生成二维码→水机摄像头扫码→后端校验→指令出水→扣券

支持离线核销：断网时本地记录，联网自动同步

方案 B：商户 / 水站人工核销

商家端 APP / 小程序：扫码枪 / 手机扫码

校验：券有效 + 未过期 + 未使用→核销成功

4. 核销后回调

核销成功 → 记录核销日志 → 统计单用户 / 单水站广告收益 & 成本

---

四、后台核心配置（运营直接用）

1. 广告配置

2. 各广告位开关、频次、每日上限

3. 激励视频→水滴 / 水券映射（动态调价：eCPM 高时可多给水）

4. 联盟优先级、底价、时段策略

5. 核销配置

6. 水品类：瓶装 / 桶装、规格、库存

7. 水站管理：LBS 点位、分成比例、营业时间

8. 核销记录、对账、结算

9. 数据看板（关键指标）

10. 广告：曝光、完播率、eCPM、收益

11. 核销：核销量、出水成本、毛利

12. 用户：新增、日活、人均广告条数、人均领水次数

---

五、风控 & 合规

1. 广告合规

所有广告标注“广告”

禁止 “免费无限领水”“日赚 XX” 等虚假宣传

未成年人模式：日广告≤5 条、禁领水

2. 防刷（保住联盟收益）

设备指纹、IP / 代理 / VPN 检测

行为：快进、挂机、循环刷、同设备多账号→封禁

核销：异常大额兑换、新账号高频核销→冻结审核