wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
47 lines
2.3 KiB
Markdown
47 lines
2.3 KiB
Markdown
# 前端集成蓝图：多触点归因与利润分析 (Multi-Touch Attribution)
|
||
|
||
> **[AI-3 @ 2026-03-14]**：由后端 Agent 在完成 BIZ_MKT_40 逻辑后产出。
|
||
|
||
## 1. 业务意图 (Business Intent)
|
||
- **核心价值**：识破平台广告的虚假繁荣，还原真实的流量贡献度，优化营销预算分配。
|
||
- **关联后端 Service**：`MultiTouchAttributionService.ts`
|
||
|
||
## 2. UI/UX 布局方案 (Layout Design)
|
||
- **页面入口**：Console -> 营销中心 -> 流量归因分析
|
||
- **展示组件**：
|
||
- [ ] **归因模型切换器**：支持 FIRST_CLICK, LAST_CLICK, LINEAR, TIME_DECAY。
|
||
- [ ] **渠道贡献饼图**：展示各 Source/Campaign 的成交金额占比。
|
||
- [ ] **LTV/CAC 趋势图**：对比各渠道的获客成本与长期价值。
|
||
- **交互草图**：
|
||
```text
|
||
+-----------------------------------------------------------+
|
||
| [Icon] 流量归因分析 (Multi-Touch Attribution) |
|
||
+-----------------------------------------------------------+
|
||
| 当前模型：[ 线性归因 (LINEAR) ▼ ] | 时间范围：[ 过去 30 天 ▼ ] |
|
||
+-----------------------------------------------------------+
|
||
| [ 渠道贡献度 (Revenue Contribution) ] |
|
||
| - Google Ads: 45% ($12,000) [==========----------] |
|
||
| - Facebook: 30% ($8,000) [=======------------] |
|
||
| - TikTok: 15% ($4,000) [===----------------] |
|
||
| - Organic: 10% ($2,600) [==-----------------] |
|
||
+-----------------------------------------------------------+
|
||
| [?] AGI 深度洞察： |
|
||
| "TikTok 渠道虽然 LAST_CLICK 转化低，但在 FIRST_CLICK 模型 |
|
||
| 下贡献了 40% 的初始流量，建议保持品牌曝光预算。" |
|
||
+-----------------------------------------------------------+
|
||
```
|
||
|
||
## 3. API 交互契约 (API Integration)
|
||
- **数据获取**：`GET /api/v1/marketing/attribution?model=LINEAR`
|
||
- **关键字段映射**：
|
||
- `source` -> 流量来源
|
||
- `weight` -> 贡献权重
|
||
- `attributed_value` -> 归因成交额
|
||
- **状态流转**：
|
||
- 切换模型 -> 发起 API 请求 -> 重新渲染图表。
|
||
|
||
## 4. 生产校验项 (FE Readiness)
|
||
- [ ] 支持大数量级日志的异步聚合加载。
|
||
- [ ] 归因模型参数配置的持久化存储。
|
||
- [ ] 导出 PDF 格式的归因分析报告。
|