# 账户分析Skill使用说明

## 一、谁能用？怎么用？

| 角色 | 使用方式 | 负责内容 |
|------|---------|---------|
| **运营人员（小雪、tom等）** | 对AI说"帮我分析账户"或接收自动提醒 | 触发分析、查看报告、按检查清单排查问题 |
| **AI小助理** | 接收指令后自动调用skill | 读取数据、对比分析、逐层诊断、生成报告 |

**使用入口**：
- 手动：对AI小助理说"帮我分析XX客户的账户"
- 自动：每天上午9:00自动巡检，发现异常自动提醒

---

## 二、手动触发流程

```
【运营人员】                    【AI小助理】
    │                             │
    ▼                             │
说："帮我分析XX客户账户"         │
（可附加：时间范围、对比基准）  │
    │ ──────────────────────────► │
    │                             ▼
    │                    通过API读取账户数据
    │                    （账户/计划/单元/关键词）
    │                             │
    │                             ▼
    │                    环比/同比对比分析
    │                    计算各指标变化幅度
    │                             │
    │                             ▼
    │                    逐层诊断
    │                    账户→计划→单元→关键词
    │                             │
    │                             ▼
    │                    生成诊断报告
    │                    （飞书云文档+问题清单）
    │◄─────────────────────────── │
    │                             │
    ▼                             │
按检查清单逐项排查               │
    │                             │
    ▼                             │
处理问题                         │
    │                             │
    ▼                             │
完成                             │
```

---

## 三、指令模板

### 标准指令
```
帮我分析【客户名】的账户
```

### 带时间范围的指令
```
帮我分析【客户名】的账户，最近7天
```

### 带对比基准的指令
```
帮我分析【客户名】的账户，本周环比上周
```

### 带关注指标的指令
```
帮我分析【客户名】的账户，重点关注CPC和CTR
```

### 完整指令
```
帮我分析【客户名】的账户，最近7天环比上周，重点关注CPC和CTR
```

---

## 四、自动触发配置（每日巡检）

### 配置步骤

**Step 1：创建定时任务**

```bash
aily-cli auto create --trigger-type cron \
  --schedule "0 9 * * *" \
  --name "XX客户-SEM账户每日巡检" \
  --instruction "读取XX客户昨日SEM账户数据，与前天对比，如发现展现/点击/CPC/CTR/消费任一指标变化幅度超过±30%，发送提醒消息给运营人员"
```

**Step 2：验证配置**

创建后系统会返回管理链接，可查看和修改定时任务。

### 巡检逻辑

1. 每天上午9:00自动执行
2. 读取昨日账户数据
3. 与前天数据环比对比
4. 检查以下指标：
   - 展现量变化 > ±30%
   - 点击量变化 > ±30%
   - CPC变化 > ±30%
   - CTR变化 > ±30%
   - 消费变化 > ±30%
5. 如有异常 → 发送提醒消息
6. 如无异常 → 静默执行（不打扰）

### 提醒消息示例

```
【XX客户-账户异常提醒-10月11日】

发现以下异常指标：

🔴 CPC上涨33.3%（¥3.0→¥4.0）
   涉及层级：ocpc计划 > 通用词单元
   可能原因：匹配方式变宽/自动扩量
   检查方向：
   1. 检查ocpc计划是否开启自动扩量
   2. 检查通用词单元匹配方式
   3. 下载搜索词报告排查无效流量

🟡 CTR下降25%（4.0%→3.0%）
   涉及层级：ocpc计划
   可能原因：创意老化/竞品抢位
   检查方向：
   1. 检查创意是否超过30天未更新
   2. 检查竞品是否上线新样式

完整诊断报告：https://shichengup.feishu.cn/docx/xxxxx
```

---

## 五、诊断报告怎么看？

### 报告结构

1. **数据概览**：一目了然看到哪些指标异常
2. **异常指标**：按优先级排列（P0>P1>P2>P3）
3. **逐层诊断**：从账户→计划→单元→关键词，定位问题
4. **检查方向**：每个异常都有具体的检查清单
5. **优化建议**：按优先级给出操作建议

### 优先级含义

| 优先级 | 含义 | 处理时限 |
|--------|------|---------|
| 🔴 P0 | 紧急 | 当天处理 |
| 🟠 P1 | 高 | 1-2天 |
| 🟡 P2 | 中 | 本周内 |
| 🟢 P3 | 低 | 持续优化 |

### 处理流程

1. 先看"异常指标"部分，了解有哪些问题
2. 按优先级从高到低处理（先P0/P1，再P2/P3）
3. 对每个异常，按"检查方向"逐项排查
4. 排查完成后，更新问题清单的"处理状态"
5. 处理完成后，可再次触发分析验证效果

---

## 六、常见问题

**Q1：AI分析的数据从哪里来？**
A：通过百度推广API自动拉取。如果API未打通，需要运营人员手动上传数据报表（Excel/CSV）。

**Q2：分析一次需要多长时间？**
A：API自动拉取数据+分析生成报告，通常2-5分钟。数据量大的账户可能需要更久。

**Q3：可以分析多长时间的账户数据？**
A：建议分析最近7天或14天的数据。时间太短样本不足，时间太长数据过时。

**Q4：自动巡检的阈值可以调整吗？**
A：可以。创建定时任务时可以自定义异常阈值，如±20%、±50%等。

**Q5：如果多个指标同时异常，先看哪个？**
A：按优先级看：先看🔴P0，再看🟠P1。同一优先级内，先看消费类指标（CPC、消费），再看流量类指标（展现、点击、CTR）。

**Q6：诊断报告中的建议一定对吗？**
A：不一定。AI基于数据和规则给出可能的诊断方向，具体原因需要运营人员结合实际排查确认。AI提供的是"检查方向"，不是"最终结论"。

**Q7：多久分析一次账户？**
A：建议：
- 每日：自动巡检（只看异常指标）
- 每周：深度分析一次（全维度诊断）
- 异常时：立即分析（发现问题随时触发）

**Q8：可以分析非百度渠道吗？**
A：当前版本主要针对百度渠道。如需要360、必应等渠道分析，需要打通对应API。

---

## 七、数据准备

### API自动拉取（推荐）

需要配置百度推广API权限：
- API Key
- API Secret
- 账户ID

配置完成后，AI自动拉取数据，无需人工干预。

### 手动上传（备用）

如果API未打通，运营人员可从百度后台导出数据：

**导出步骤：**
1. 登录 https://fengchao.baidu.com
2. 进入「数据报告」→「账户报告」/「计划报告」/「单元报告」/「关键词报告」
3. 选择时间范围
4. 勾选所需指标
5. 下载为Excel

**上传方式：**
- 直接把Excel文件发给AI小助理
- AI自动解析并执行分析