Project Progress Report · 2026-07-02

天策系统 · TikTok 智能投放

两周攻坚冲刺第 5 天：14 个 TikTok API 端点沙箱实测完成，落地页从表单式重构为 Agent 对话式，9 个 K8s Manifests 就绪，等待 ACK 部署上线。

今日是单日推进量最大的一天。基础投放链路（Campaign → Adgroup → Report）验证可行 ✅。主要阻塞是买家联系人数据和 LEAD_GENERATION 参数，不影响 V1 首发。

今日 6 项核心交付

落地页架构升级：表单式 → Agent 对话式

方达指出表单式不符 TikTok 广告落地页最佳实践，当天 3 小时内重构并推送：聊天 UI 组件（消息气泡 + 多轮对话）+ 后端规则引擎对话流程（条件分支 + 字段收集 + 异常回退），对话完成后调用 complete_session 创建 Lead。

Agent ChatReactRule EngineFastAPI

TikTok App 审核通过 + 沙箱全环境就绪

app_id=7657757689758957569，沙箱账户已创建，永久 token 已获取。方达协作完成 CDN redirect_uri 对齐和 advertiser_id 接入。完整的沙箱调用栈可用。

TikTok AppOAuthSandboxProduction Ready

14 个 API 端点沙箱实测 · 基础投放链路可行

OAuth 2 + Campaign 2 + Adgroup 2 + Report 3 + Account 1 = 10 个已验证通过。LEAD_GENERATION Adgroup 沙箱提示缺 lead_config 参数（需额外补齐）。Ad/Creative/Events API 共 4 个待下一轮实测。结论：Campaign → Adgroup → Report 基础链路可行。

TikTok API v1.3MarketingReportSandbox Testing

ACK 部署全量资产产出 · 待王建上线

9 个 K8s manifests（api / celery-worker / celery-beat / landing / admin / postgres / redis / ingress / configmap）+ docker-compose + deploy.sh 一键脚本。5 个服务均为 multi-stage Docker build（node build + nginx serve）。域名 tiance-test.ultronx.tech 已配置。

K8sACKDockerCeleryNginx

Python 后端：9 模块 30+ 接口 + Celery 异步

FastAPI 应用涵盖 api/clients、api/campaigns、api/adgroups、api/leads、api/reports、api/decisions、api/experiments、api/buyer_seeds、api/landing_sessions。Celery Worker 处理 TikTok API 异步调用 + Lead 事件推送。Celery Beat 负责报表定时拉取和种子受众刷新。11 张 PostgreSQL 数据表模型。

FastAPICeleryPostgreSQLAlembic

方达全链路协同：沙箱 / CDN / 方案评审闭环

沙箱账户创建与接入、CDN redirect_uri 对齐、advertiser_id 接入验证、落地页方案评审——方达端所有协作项当天闭环完成。唯一待推进的是 production access 申请流程的启动时机。

CollaborationCDNProduction Access

TikTok API 沙箱实测矩阵

模块	端点	方法	功能	状态
OAuth / Account	/oauth2/access_token/	POST	获取广告主 Access Token	✅ 通过
OAuth / Account	/oauth2/advertiser/get/	GET	广告主账户列表	✅ 通过
Campaign	/campaign/create/	POST	创建广告系列	✅ 通过
Campaign	/campaign/get/	GET	查询广告系列列表	✅ 通过
Adgroup	/adgroup/create/ (TRAFFIC)	POST	创建流量型广告组	✅ 通过
Adgroup	/adgroup/create/ (LEAD)	POST	创建线索型广告组	⚠️ 缺参数
Report	/report/integrated/get/	GET	综合报表（按 adgroup）	✅ 通过
Report	/report/campaign/get/	GET	按 Campaign 报表	✅ 通过
Report	/report/advertiser/get/	GET	广告主层级报表	✅ 通过
Ad	/ad/create/	POST	创建广告	⏳ 待测
Creative	/video/upload/	POST	上传创意素材	⏳ 待测
Creative	/file/video/ad/upload/	POST	上传广告视频	⏳ 待测
Audience	/dmp/custom_audience/upload/	POST	种子受众 SHA256 上传	⏳ 待测
Events	/pixel/events/post/	POST	转化事件回传	⏳ 待测

通过 9 · 受限 1 · 待测 4 · 沙箱约束：QPS 1/s · 仅 US 地区 · targeting 受限

系统架构 & 微服务

🔌

tiance-apiFastAPI · REST + WebSocket · 9 模块 30+ 接口

✅ 就绪

⚙️

tiance-celery-workerCelery · TikTok API 异步调用 · Lead 事件推送

✅ 就绪

🕐

tiance-celery-beat定时任务调度 · 报表拉取 · 种子受众刷新

✅ 就绪

📄

tiance-landingAgent 对话式落地页 · Nginx serve · Tracking SDK

✅ 就绪

📊

tiance-adminReact 管理后台 · 数据看板 · 客户端管理

✅ 就绪

技术栈：Python 3.11 + FastAPI · Celery + Redis · PostgreSQL 11 表 · React + TS · Docker + K8s (ACK) · TikTok Marketing API v1.3

里程碑路线

6/27V4 Final 方案定稿

Thompson Sampling 自动优化框架确定 · Phase 0 合同测试策略 · Pixel/Events API 归因闭环方案修正

6/29V1 工程结构交付

Backend（9模块30+接口）+ Frontend（Admin + Landing SDK）+ 11 张表 + Celery 异步

7/2落地页重构 + API 全量验证

表单→对话式 3h 重构 · 14 端点沙箱实测 · 9 K8s Manifests · 部署文档

7/3→ ACK 部署 + LEAD + 视频

王建部署 tiance-test · LEAD_GENERATION 参数探索 · Video Upload · 种子文件构造

7/4–5○ Ad Create + Events 闭环

完整投放链路 · Adgroup Update 真调 · Agent Chat 增强

7/7○ V1 MVP 首发

Agent 落地页 → 自动投放 → Lead 回传 · 第一单真实 CPL 交付

阻塞项 & 风险

买家联系人维度数据缺失：圈选 API 只返回企业维度（公司名/税号/行业），缺少 email/phone 用于 TikTok 种子受众 SHA256 上传。两条绕行路径：A）Zoho CRM 用税号交叉补全联系人；B）兴趣定向暂时替代种子包。阻塞者：李梦蛟今日未上班，V 已在群内追问 2 次。
LEAD_GENERATION Adgroup 参数不完整：沙箱提示需要额外 lead_config 参数（疑似 lead_form_id）。TRAFFIC 已验证通过，V1 可先用 TRAFFIC 跑通链路，LEAD 并行探索。非首发硬阻断，今晚/明天可补。
ACK 集群未部署：9 个 K8s manifests 已交付王建，等待执行部署。部署后需冒烟测试：API health → 落地页 → 管理后台 → TikTok 连通性。
3 项截止任务未闭环：枚举码表 / 交叉校验规则 / 买家联系人数据，均由李梦蛟负责，今日未回复。截止日期：7 月 2 日。
沙箱环境约束：QPS ≤ 1/s、仅支持 US 地区定向、targeting 参数受限（无 behavior/interest 细分），无法验证真实投放和 Pixel 事件接收。production access 节奏需提前规划。

明日行动清单

01ACK 集群部署

王建执行 K8s 部署到 tiance-test.ultronx.tech → 5 服务依次上线 → TLS/Ingress 验证 → 冒烟测试。部署文档和 9 个 manifests 已就绪。

02LEAD 补测 + 视频上传

LEAD_GENERATION Adgroup 试出 lead_config 参数并补齐文档 → Video Upload 到沙箱素材库 → Ad Create 真实沙箱广告。

03跟进梦蛟数据闭环

买家联系人维度数据（email/phone）· 枚举码表 · 交叉校验规则。需确认是催回复还是先绕过推 V1。

04Adgroup Update 实调

预算/状态更新从 stub 改为真实 API 调用，这是 V1 决策模块的核心操作。

05Agent Chat 对话增强

补充更多对话分支 → 收集更多字段类型 → 异常回退处理 → 对话体验打磨。

需要赵大师 / Tianyi 决策

▪ 买家数据策略：催李梦蛟尽快回复 email/phone 数据，还是先绕过用兴趣定向替代种子包，基于现有企业维度数据继续推 V1？

▪ LEAD_GENERATION：今晚立即探索 lead_config 参数，还是等明天 ACK 部署后再并行推进？

▪ 方达下一步：需要对接 production access 申请流程吗？还是沙箱阶段继续由我方独立推进？