基于机器学习与统计建模的广告投放智能决策系统，以ROI最大化为核心目标，全渠道自动优化广告预算分配、渠道配比、时段权重与人群定向策略。
| 场景 | 描述 | 核心价值 |
|---|---|---|
| 互联网广告全渠道智能投放 | 整合多投放平台，实现跨渠道统一优化 | 降本增效 |
| 线上营销预算自动分配 | 根据实时效果自动调整各渠道预算 | 自动化 |
| 广告投放渠道智能筛选 | 基于历史数据评估渠道质量，优选高效渠道 | 精准筛选 |
| 投放时段与人群定向自动优化 | 动态优化时段权重和人群包配置 | 精细化运营 |
| 广告投放效果实时调控与ROI提升 | 实时回传数据，动态修正决策输出 | 实时优化 |
基于机器学习与统计建模，以投入产出比（ROI）最大化为核心目标，整合广告曝光、点击、转化、成本等多维数据，构建预测模型与目标优化模型，自动计算最优投放预算分配、渠道配比、时段权重与人群定向策略，持续迭代提升营销投放效率与收益。
| 阶段 | 输入数据 | 处理逻辑 | 输出结果 |
|---|---|---|---|
| 1. 数据接入 | 广告曝光量、点击量、转化数据、成本数据、用户行为数据 | 实时数据采集与清洗，去异常值，补全缺失 | 标准化数据流 |
| 2. 特征工程 | 原始投放数据、用户画像 | 提取投放效果、用户画像、渠道质量、时段价值等特征 | 高价值特征向量 |
| 3. 模型预测 | 特征向量、历史投放效果 | 训练转化预测、成本预测、ROI预测模型（GBDT/LSTM/Transformer） | 各渠道/时段/人群ROI预测值 |
| 4. 优化决策 | ROI预测值、预算约束、渠道约束 | 以ROI最大化为目标，使用强化学习/线性规划求解最优分配 | 预算分配、渠道优先级、时段策略、定向策略 |
| 5. 效果监控 | 实际投放效果数据 | 实时回传投放效果，动态修正模型参数与决策策略 | 模型参数更新、策略微调 |
| 6. 循环迭代 | 全量历史数据 | 按季度更新数据，重新训练模型，持续优化决策输出 | 新版本模型、策略优化报告 |
| 层级 | 技术选型 | 说明 |
|---|---|---|
| 数据存储 | MySQL + Redis + Kafka | 结构化数据存储、缓存、实时数据流 |
| 特征工程 | Python / Spark MLlib | 特征提取、特征选择、特征变换 |
| 机器学习模型 | XGBoost / LightGBM / LSTM | 转化预测、ROI预测、成本预测 |
| 优化求解 | 强化学习（PPO）/ 线性规划（LP） | 多约束条件下的ROI最大化求解 |
| 模型服务 | TensorFlow Serving / Triton | 模型推理与服务化 |
| 实时计算 | Flink / Spark Streaming | 实时数据处理与特征更新 |
| API网关 | RESTful API / gRPC | 外部系统接入 |
https://adapi.yuanshusheng.com/v1 ｜ 认证方式：Bearer Token (JWT)所有API请求需要在Header中携带有效的JWT Token：
Authorization: Bearer <your_jwt_token>
根据给定预算和约束条件，返回ROI最大化的投放决策方案。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| total_budget | number | 是 | 总预算（元），最小值 100 |
| start_date | string | 是 | 投放开始日期，格式 YYYY-MM-DD |
| end_date | string | 是 | 投放结束日期，格式 YYYY-MM-DD |
| channels | string[] | 否 | 指定渠道列表，默认全部渠道 |
| target_roi | number | 否 | 目标ROI值，不设则自动优化 |
| audience_tags | string[] | 否 | 人群定向标签列表 |
| campaign_type | string | 否 | 营销活动类型：performance/brand/awareness |
{
"code": 200,
"message": "success",
"data": {
"decision_id": "dec_20260414_abc123",
"expected_roi": 3.75,
"total_budget": 100000,
"allocation": [
{ "channel": "douyin", "budget": 45000, "ratio": 0.45, "expected_roi": 4.2 },
{ "channel": "weixin", "budget": 30000, "ratio": 0.30, "expected_roi": 3.8 },
{ "channel": "baidu", "budget": 25000, "ratio": 0.25, "expected_roi": 3.1 }
],
"time_weights": [
{ "period": "09:00-12:00", "weight": 0.35 },
{ "period": "14:00-18:00", "weight": 0.40 },
{ "period": "20:00-23:00", "weight": 0.25 }
],
"audience_strategy": {
"primary_tags": ["25-35岁", "一二线城市", "有购车意向"],
"exclude_tags": ["已转化用户"]
},
"created_at": "2026-04-14T08:30:00Z"
}
}
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channel | string | 是 | 投放渠道：douyin/weixin/baidu/toutiao等 |
| budget | number | 是 | 预算金额（元） |
| time_period | string | 是 | 投放时段，格式 YYYY-MM-DD |
| audience_tags | string[] | 否 | 人群标签 |
{
"code": 200,
"data": {
"predicted_roi": 3.85,
"confidence": 0.92,
"predicted_conversion": 1250,
"predicted_cost": 25974,
"predicted_revenue": 100000
}
}
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| start_date | string | 是 | 开始日期 YYYY-MM-DD |
| end_date | string | 是 | 结束日期 YYYY-MM-DD |
| channel | string | 否 | 筛选特定渠道 |
{
"code": 200,
"data": [{
"channel": "douyin",
"avg_roi": 4.2,
"total_investment": 500000,
"total_conversion": 6250,
"cpc": 2.5,
"cvr": 0.035
}]
}
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| decision_id | string | 是 | 决策方案ID |
| channel | string | 是 | 渠道名称 |
| actual_exposure | number | 是 | 实际曝光量 |
| actual_click | number | 是 | 实际点击量 |
| actual_conversion | number | 是 | 实际转化量 |
| actual_cost | number | 是 | 实际花费（元） |
| actual_revenue | number | 否 | 实际收入（元） |
{
"code": 200,
"message": "feedback recorded",
"data": {
"actual_roi": 3.68,
"roi_deviation": -0.07,
"model_updated": true
}
}
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| audience_tags | string | 是 | 人群标签，逗号分隔 |
| start_time | string | 是 | 开始时间 YYYY-MM-DD HH:mm |
| end_time | string | 是 | 结束时间 YYYY-MM-DD HH:mm |
{
"code": 200,
"data": {
"available_slots": [
{ "start": "2026-04-15 09:00", "end": "2026-04-15 12:00", "availability": "high" },
{ "start": "2026-04-15 14:00", "end": "2026-04-15 18:00", "availability": "medium" }
],
"recommended_window": "2026-04-15 09:00-12:00"
}
}
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| 10001 | 认证令牌无效或已过期 | 重新获取JWT Token |
| 10002 | 签名验证失败 | 检查请求签名算法 |
| 20001 | 预算超出允许范围 | 预算需在100-10,000,000元之间 |
| 20002 | 日期范围超出限制 | 单次查询不超过90天 |
| 20003 | 无效的渠道名称 | 请使用支持的渠道名称 |
| 30001 | 模型服务不可用 | 稍后重试，联系技术支持 |
| 30002 | 数据延迟过高 | 当前预测精度可能下降 |
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| exposure / 曝光量 | integer | 广告被展示的总次数 | 150000 |
| click / 点击量 | integer | 广告被点击的总次数 | 5250 |
| conversion / 转化量 | integer | 完成目标行为的次数（注册/购买等） | 184 |
| cost / 花费 | decimal | 实际消耗的广告费用（元） | 13125.00 |
| revenue / 收入 | decimal | 通过广告转化带来的收入（元） | 50000.00 |
| roi / 投资回报率 | decimal | 收入/花费，保留2位小数 | 3.81 |
| cpc / 点击单价 | decimal | cost/click，元/次 | 2.50 |
| cvr / 转化率 | decimal | conversion/click，保留4位小数 | 0.0350 |
| channel / 渠道 | string | 投放渠道标识 | douyin / weixin / baidu |
| audience_tag / 人群标签 | string | 人群定向标签 | 25-35岁, 一线城市 |
| 渠道代码 | 渠道名称 | 类型 |
|---|---|---|
| douyin | 抖音 | 信息流 |
| weixin | 微信朋友圈 | 信息流 |
| baidu | 百度搜索 | 搜索 |
| toutiao | 今日头条 | 信息流 |
| 微博 | 社交 | |
| kuaishou | 快手 | 信息流 |
| 合规项 | 依据 | 落实情况 |
|---|---|---|
| 算法备案 | 《互联网信息服务算法推荐管理规定》 | 已提交审核 |
| 算法安全评估 | 《互联网信息服务深度合成管理规定》 | 已完成 |
| 个人信息保护 | 《个人信息保护法》 | 合规 |
| 广告合规 | 《互联网广告管理办法》 | 合规 |
| 数据本地化 | 《数据安全法》 | 境内存储 |
| 服务组件 | 状态 | 最后检查 |
|---|---|---|
| API网关 | ● 正常 | 2026-04-14 08:45:00 |
| ROI预测模型 | ● 正常 | 2026-04-14 08:45:00 |
| 优化决策引擎 | ● 正常 | 2026-04-14 08:45:00 |
| 数据管道 | ● 正常 | 2026-04-14 08:45:00 |
| 特征工程服务 | ● 正常 | 2026-04-14 08:45:00 |