广告联盟变现对接穿山甲APP广告变现系统开发

一、前置准备（开发前必须完成）

注册【穿山甲媒体平台】，完成企业资质认证、软著上传

创建应用，录入 APP 包名，获取：AppID、广告位 ID（激励视频 / 开屏 / 插屏 / 信息流）、Security 密钥（SSV 服务端校验）

申请 API 数据权限，用于定时拉取广告收益账单

准备合规文件：隐私政策、用户协议（SDK 强制要求，未授权禁止初始化广告 SDK）

二、核心业务链路（变现主线）

用户打开 APP → 隐私授权通过 → 初始化穿山甲 SDK → 浏览短剧，免费集看完触发广告 → 观看激励视频广告（核心变现）→ 穿山甲 SSV 服务端回调我方后端校验观看有效性 → 校验通过，解锁剧集 → 广告产生收益，归属对应渠道 channelId → 系统自动计算平台、渠道、推广达人分销佣金

广告类型优先级：激励视频广告（最高 eCPM）＞开屏广告＞插屏广告＞信息流原生广告

三、整体系统架构

客户端（Android + iOS）

可选技术方案

UniApp / Flutter（推荐招商叠包模式）一套代码，后台配置参数一键生成多渠道独立 APP 包

原生 Kotlin/Swift（大流量项目，性能最优）客户端核心模块

穿山甲 SDK 初始化管理（合规隐私时序控制）

广告管理器：广告预加载、广告展示、广告监听回调

短剧播放模块（Pangrowth SDK / 自研播放器）

用户体系：注册登录、邀请码上下级绑定

分销推广页面、佣金中心

渠道标识 channelId 透传（叠包、渠道分佣核心）

关键：APP 启动携带 channelId，所有广告请求、广告回调带上渠道标识，实现收益精准归属渠道。

后端服务（SpringBoot + MySQL8.0 + Redis + MQ）

核心能力：

穿山甲 SSV 激励广告回调接收与签名校验（重中之重）

用户上下级分销关系管理

广告数据统计、渠道收益归集

佣金自动结算、提现管理

渠道叠包配置管理

风控防刷系统

定时任务：调用穿山甲开放 API 同步每日收益账单

剧集解锁权限发放

存储

Pangrowth SDK 方案：不需要视频存储服务器

自有短剧方案：OSS 对象存储 + CDN 防盗链

四、穿山甲对接核心技术要点1、SDK 初始化合规时序（红线！违规直接限制广告填充）

APP 启动展示隐私弹窗

用户同意隐私协议之后，再初始化穿山甲广告 SDK

SDK 初始化成功后，再启动 Pangrowth 短剧组件 禁止未授权提前初始化 SDK

2、激励广告解锁剧集 + SSV 后端校验（防篡改）

不允许依靠前端回调直接解锁剧集！ 标准安全流程：

用户点击【看广告解锁剧集】，客户端加载穿山甲激励视频

发起广告请求时，透传参数：userId、channelId、transId

用户完整观看广告后，穿山甲服务端主动发起 HTTPS POST 请求到我方后端接口（SSV 服务端验证）

后端使用 Security 密钥进行签名校验，防止伪造回调

Redis 判断 transId 防止重复回调、重复发放解锁权限

校验通过 → 数据库更新用户剧集解锁权限，返回成功标识

客户端收到结果，自动播放下一剧集

⚠️ 规则限制：穿山甲要求1 次激励广告最多解锁 10 集，禁止一次广告解锁全集

3、渠道归因（叠包模式核心逻辑）

每个渠道子包内置独立 channelId方案实现：

后台配置渠道信息：渠道名称、分成比例、独立穿山甲广告位 ID、LOGO、包名

打包时注入对应渠道参数

APP 所有广告行为上报携带 channelId

后端统计广告收益按 channelId 隔离，自动核算渠道佣金

可选增强：一渠道一穿山甲广告账号，收益完全隔离，适合gaoji招商代理模式

4、广告收益数据同步

穿山甲开放 API 为T+1 数据（次日上午更新前一日收益） 后端定时任务每日拉取各广告位收益，按渠道归集，用于后台对账、佣金结算。

重要区分：客户端统计曝光 ≠ 穿山甲结算收益（平台剔除无效流量）后台必须展示对账差额，代理协议提前注明。

五、后台完整功能模块【1】超级运营后台（平台方）穿山甲广告联盟管理

多穿山甲媒体账号、多广告位录入管理

广告策略配置：广告冷却时长、单日广告上限、解锁集数配置

SSV 回调密钥配置、广告开关控制

定时拉取穿山甲收益报表、自动对账、差额预警

短剧内容管理

Pangrowth SDK：题材过滤、剧集黑名单

自有短剧：批量上传、分集、免费集配置、上下架

渠道叠包管理（招商核心）

渠道新增、启用 / 禁用、合作期限 渠道分成比例（固定比例 / 阶梯分成） 渠道参数配置：包名、图标、广告 ID、channelId 叠包自动构建配置、APP 版本热更新

分销裂变分佣系统

邀请码 / 短链绑定上下级（推荐二级分销，合规）

直推佣金、间推佣金比例后台自定义

用户广告流水实时统计，佣金自动计算

推广海报、短链接批量生成