makemd/docs/SERVICES/marketing.md

营销域服务

入口: _index.md

---

服务列表

服务	文件	职责
CampaignService	services/CampaignService.ts	广告计划管理
AdService	services/AdService.ts	广告管理
AnalyticsService	services/AnalyticsService.ts	数据分析

---

核心流程

创建计划 → 创建广告 → 投放 → 监控 → 优化

---

CampaignService

方法列表

方法	说明	参数	返回
list	计划列表	params	Campaign[]
get	计划详情	id	Campaign
create	创建计划	CreateRequest	Campaign
update	更新计划	id, UpdateRequest	Campaign
start	启动计划	id	Campaign
pause	暂停计划	id	Campaign

---

AdService

方法列表

方法	说明	参数	返回
list	广告列表	campaignId	Ad[]
get	广告详情	id	Ad
create	创建广告	CreateRequest	Ad
update	更新广告	id, UpdateRequest	Ad
getPerformance	获取表现	id	Performance

---

AnalyticsService

方法列表

方法	说明	参数	返回
getDashboard	获取仪表盘	params	Dashboard
getMetrics	获取指标	params	Metrics
getReport	获取报告	params	Report

---

状态机

DRAFT → PENDING_REVIEW → ACTIVE → PAUSED → COMPLETED
                              ↓
                         ARCHIVED

状态	说明
DRAFT	草稿
PENDING_REVIEW	待审核
ACTIVE	投放中
PAUSED	已暂停
COMPLETED	已完成
ARCHIVED	已归档

---

API端点

端点	方法	服务方法
/api/v1/campaigns	GET	CampaignService.list
/api/v1/campaigns	POST	CampaignService.create
/api/v1/campaigns/:id	GET	CampaignService.get
/api/v1/campaigns/:id/start	POST	CampaignService.start
/api/v1/campaigns/:id/pause	POST	CampaignService.pause
/api/v1/campaigns/:id/ads	GET	AdService.list
/api/v1/ads	POST	AdService.create
/api/v1/analytics/dashboard	GET	AnalyticsService.getDashboard

---

最后更新: 2026-03-22