# 前端集成蓝图：多触点归因与利润分析 (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 格式的归因分析报告。