# P36 广告投放、展位竞价与流量分发

文档编号：pcbjia-P36-ADS-V1.0
状态：【评审通过】
定位：供应商付费流量入口。广告位采用增量植入，不改动现有页面结构；平台统一管理广告位、素材审核、出价与结算。

---

## 1. 广告资源位

| 位置 | 形态 | 说明 |
| --- | --- | --- |
| 供应商列表页顶部 | 置顶固定位 | 按天或按月包位 |
| 供应商列表侧栏 | 关键词竞价位 | CPC 竞价，按工艺词触发 |
| 首页工厂卡片区 | 轮播推荐位 | 需与首页既有板块共存，不新增区块 |
| 工具页侧栏 | 固定展位 | DFM、阻抗、拼板页共用组件 |
| 服务商详情页底部 | 同行推荐位 | 竞价排序 |
| 搜索结果页 | 关键词广告 | 按 PCB、HDI、铝基板、高频板等词触发 |

计费模式：包时段（预付）、CPC（点击扣费，主推）、CPM（千次曝光，备选）。

## 2. 供应商投放后台

1. 账户：余额、冻结金额、消耗明细、充值记录
2. 计划：投放位置、出价、每日预算、总预算、起止时间
3. 定向：客户类型（国内/海外）、工艺标签、采购区域、绑定关键词
4. 创意：广告图、文案、落地店铺链接，需平台审核
5. 报表：曝光、点击、CTR、消耗、进店数、询盘转化
6. 控制：随时启停，预算耗尽自动停投

## 3. 平台管理

1. 广告位管理：新增、关闭、底价、最大展示数量
2. 素材审核：图片与文案审核，违规导流驳回，联动风控关键词与 OCR
3. 排序引擎：`综合分 = 出价 × 店铺质量分 × 相关性系数`，避免纯价高者得
4. 财务：充值、消耗、退款台账，导出对账
5. 黑名单：违规供应商禁止投放
6. 流量配比：自然流量与付费流量占比可调

## 4. 计费与防作弊

- CPC 单次扣费 = 下一位出价 + 0.01（无下一位按底价）
- 同一 IP 或设备短时间内多次点击不计费，超过阈值进入风控
- 曝光免费但需上报，用于 CTR 与质量分计算

## 5. 优先级

- P0：广告位配置、素材审核、CPC 竞价、消耗流水、基础报表
- P1：包时段展位、预算上限、恶意点击过滤、关键词竞价
- P2：定向投放、广告折扣券、转化归因
- P3：自动出价、素材 A/B 测试、ROI 建议

## 6. 接口

```
GET    /api/v1/ad/account
GET    /api/v1/ad/position/list
POST   /api/v1/ad/plan/save
POST   /api/v1/ad/plan/submit-audit
POST   /api/v1/ad/plan/switch
GET    /api/v1/ad/plan/stat
GET    /api/v1/ad/show/list
POST   /api/v1/ad/imp/log
POST   /api/v1/ad/click/log
GET    /api/v1/admin/ad/position/list
POST   /api/v1/admin/ad/position/save
GET    /api/v1/admin/ad/audit/list
POST   /api/v1/admin/ad/audit/pass
POST   /api/v1/admin/ad/audit/reject
```

## 7. 建表（PostgreSQL 设计稿，仅参考不在本站执行）

```sql
CREATE TABLE ad_position (
  id bigserial PRIMARY KEY,
  pos_name varchar(128),
  pos_code varchar(64) UNIQUE,
  page_location varchar(255),
  min_price numeric(10,2) DEFAULT 0,
  max_show_num int DEFAULT 1,
  support_type varchar(64),         -- cpc / cpm / fixed
  status smallint DEFAULT 1,
  created_at timestamptz DEFAULT now(),
  updated_at timestamptz DEFAULT now()
);

CREATE TABLE ad_account (
  id bigserial PRIMARY KEY,
  supplier_id bigint NOT NULL UNIQUE,
  balance numeric(12,2) DEFAULT 0,
  frozen_balance numeric(12,2) DEFAULT 0,
  created_at timestamptz DEFAULT now(),
  updated_at timestamptz DEFAULT now()
);

CREATE TABLE ad_plan (
  id bigserial PRIMARY KEY,
  supplier_id bigint NOT NULL,
  pos_id bigint NOT NULL,
  plan_name varchar(255),
  ad_type varchar(32),              -- cpc / cpm / fixed
  bid_price numeric(10,2) DEFAULT 0,
  daily_budget numeric(12,2) DEFAULT 0,
  total_budget numeric(12,2) DEFAULT 0,
  start_time timestamptz,
  end_time timestamptz,
  target_tags varchar(512),
  target_country varchar(512),
  keyword_list varchar(1024),
  redirect_url varchar(512),
  img_url varchar(512),
  ad_desc varchar(255),
  audit_status smallint DEFAULT 0,  -- 0待审 1通过 2驳回
  reject_note varchar(255),
  status smallint DEFAULT 0,        -- 0暂停 1投放 2预算耗尽 3结束
  total_imp int DEFAULT 0,
  total_click int DEFAULT 0,
  total_cost numeric(12,2) DEFAULT 0,
  created_at timestamptz DEFAULT now(),
  updated_at timestamptz DEFAULT now()
);
CREATE INDEX idx_ad_plan_supplier ON ad_plan(supplier_id, status);

CREATE TABLE ad_cost_log (
  id bigserial PRIMARY KEY,
  plan_id bigint NOT NULL,
  supplier_id bigint NOT NULL,
  cost_type varchar(32),            -- click / imp / fixed
  cost_amount numeric(10,2) DEFAULT 0,
  ip varchar(64),
  device_id varchar(128),
  is_valid boolean DEFAULT true,
  created_at timestamptz DEFAULT now()
);
CREATE INDEX idx_ad_cost_plan ON ad_cost_log(plan_id, created_at);

CREATE TABLE ad_recharge_order (
  id bigserial PRIMARY KEY,
  order_sn varchar(64) NOT NULL UNIQUE,
  supplier_id bigint NOT NULL,
  recharge_amount numeric(12,2),
  pay_status smallint DEFAULT 0,
  pay_time timestamptz,
  created_at timestamptz DEFAULT now()
);
```

## 8. 排序与过滤逻辑

1. 取候选计划：位置匹配、审核通过、状态投放中、预算未耗尽、时间窗内。
2. 计算综合分：出价 × 店铺质量分（0.6–1.2）× 关键词相关性（0–1）。
3. 取前 N 展示，同一供应商在同一位置最多占 1 个名额。
4. 点击校验：IP + 设备指纹 + 时间窗去重，命中风控的点击标记 `is_valid=false` 不扣费。

## 9. 平台能力说明

广告充值与扣费涉及资金流转，不在当前平台可交付范围内。实际交付为：广告位配置、素材与计划管理、曝光与点击上报、消耗台账展示；充值与结算以线下对账完成。