wifi

太棒了 👍 那我来帮你把这份《扫码看广告自动连WiFi》产品方案优化成一份**结构更专业、排版更适合语雀/Notion展示的 Markdown 格式（MD文档）**版本。
下面是优化后的完整版👇 —— 保留了逻辑层级、目录导航、可复制即用。

⸻

📱 扫码看广告自动连接 WiFi 小程序 - 产品需求文档（PRD）

⸻

🧩 一、产品概述

1.1 产品名称

扫码看广告连WiFi小程序（暂定名：WiFi+）

1.2 产品目标

通过用户扫码进入小程序，播放广告主的视频广告，用户观看完毕后自动连接指定WiFi。
实现“广告变现 + WiFi连接”的完整闭环体验。

1.3 主要使用场景
	•	商场、餐厅、酒店、展会等公共场所
	•	用户扫码 → 自动播放广告 → 自动连网
	•	广告播放完毕后发放连接凭证，完成WiFi接入

1.4 目标用户
	•	提升线下转化的商户
	•	展示视频广告的广告主
	•	免费上网的终端用户

⸻

🧭 二、用户流程（Flow）

graph TD
A[用户扫码进入小程序] --> B[解析二维码参数]
B --> C[请求广告信息接口]
C --> D[展示广告视频播放页]
D --> E[用户观看广告（15s）]
E --> F[播放完毕，上报播放完成事件]
F --> G[调用 wx.connectWifi() 自动连接WiFi]
G --> H[连接成功 → 展示成功页]

⸻

🧱 三、功能模块设计

3.1 扫码入口

示例链接：

https://mp.weixin.qq.com/a?id=xxx&wifi_id=shop001

参数	说明
wifi_id	对应商户/路由设备唯一标识
ad_id	可选，指定广告ID
channel	渠道标识（统计来源）

⸻

3.2 广告视频播放页

功能	描述
视频播放	使用 <video> 组件自动播放广告视频
播放控制	禁止快进、禁止关闭、支持暂停
倒计时显示	剩余播放秒数（例：“剩余 10 秒”）
播放完毕事件	触发 onended → 调用后端上报
埋点	播放开始、播放中、播放完成、播放失败

前端逻辑示例：

adVideo.onended = () => {
  wx.request({
    url: 'https://api.yourdomain.com/ad/report',
    method: 'POST',
    data: { ad_id: ad.id, event: 'finish' },
    success() {
      wx.navigateTo({ url: '/pages/wifi/connect?wifi_id=xxx' });
    }
  });
};

⸻

3.3 自动连接WiFi页

功能	说明
WiFi连接API	调用 wx.connectWifi()
参数	SSID + 密码（后台下发）
状态展示	正在连接 / 成功 / 失败
成功页	展示“已成功连接 WiFi”
异常处理	提示手动连接方法

⸻

3.4 管理后台（广告主 & WiFi商户）

模块	功能
广告管理	上传广告视频、封面、标题、有效期
WiFi管理	录入SSID、密码、二维码生成
数据看板	播放次数、完成率、连接成功率
用户日志	记录用户行为（匿名）

⸻

⚙️ 四、接口设计

4.1 获取广告接口

GET /api/ad/get

参数	类型	说明
wifi_id	string	当前WiFi商户标识

返回示例：

{
  "code": 0,
  "data": {
    "id": 101,
    "title": "新品上市广告",
    "video_url": "https://cdn.yourdomain.com/ads/101.mp4",
    "duration": 15
  }
}

⸻

4.2 播放事件上报接口

POST /api/ad/report

参数	说明
ad_id	广告ID
event	start / progress / finish / error
openid	用户标识
duration	播放时长

⸻

4.3 WiFi连接信息接口

GET /api/wifi/info

返回示例：

{
  "ssid": "CafeFreeWiFi",
  "password": "12345678"
}

⸻

📊 五、数据埋点与统计

埋点事件	触发时机	说明
ad_view_start	视频播放开始	记录进入播放页
ad_view_progress	每5秒上报	防作弊验证
ad_view_finish	视频播放完毕	激励条件
wifi_connect_success	WiFi连接成功	转化率指标
wifi_connect_fail	WiFi连接失败	异常监控

⸻

🔒 六、风控与合规策略

风控项	说明
视频内容审核	视频需经人工/微信内容安全API审核
播放防刷	校验 openid + 播放时长 ≥ 80% 才算有效
WiFi安全	密码加密传输，不明文存储
跳转限制	禁止外链跳转小程序外页面
域名安全	所有资源托管于 yourdomain.com

⸻

💰 七、商业模式与收益

模式	说明
CPM / CPV 收益	广告主按播放量付费
WiFi商户分成	按流量分账或月度套餐
数据增值	向广告主提供广告分析报表

⸻

📅 八、版本规划

版本	功能重点	时间
v1.0	扫码 → 播放 → 连WiFi闭环	2025 Q4
v1.1	后台广告管理 + 数据看板	2026 Q1
v1.2	多广告位 + 区域投放	2026 Q2

⸻

👮 九、合规与备案要求
	•	小程序需开通 “广告展示类目” 或 “流量主广告组件”
	•	视频禁止外链二维码、公众号诱导
	•	广告素材须签署 《视频展示授权书》
	•	WiFi接入方需具备合法网络接入备案（如商场/连锁店）

⸻

✅ 十、关键指标（KPI）

指标	说明	目标
广告播放完成率	用户完整观看比例	≥ 85%
WiFi连接成功率	连接成功比例	≥ 95%
日活跃用户	扫码进入独立用户	≥ 1000
CPM 收益	每千次播放收入	≥ ¥20

⸻

🧠 十一、可扩展方向
	•	激励积分体系（看广告得积分，上网更久）
	•	区域 / 场景定向广告投放
	•	人脸识别广告互动（AI SDK）
	•	广告推荐算法（基于WiFi位置）

⸻

🪪 十二、系统架构图

⸻