---
name: sem-account-analyzer
label: 账户分析
description: >
  SEM账户层级数据分析与诊断。通过百度API读取账户数据，环比/同比对比分析，
  从账户→计划→单元→关键词逐层下钻诊断问题，给出具体检查方向和优化建议。
  当用户提到以下任一触发词时使用：
  (1) 账户分析 / 诊断账户 / 账户诊断
  (2) 分析账户数据 / 账户数据分析 / 账户体检
  (3) 账户问题排查 / 账户异常分析 / 账户优化建议
  (4) 帮我看看账户 / 账户怎么了 / 账户数据不对劲
  支持手动触发分析 + 每日自动定时分析发现异常并提醒。
  前提假设：后端转化（线索→有效线索→MQL→SQL→成交）一切正常。
---

# SEM账户分析

## 概述

本skill用于SEM账户层级的数据分析与问题诊断。核心分工：
- **运营人员（小雪、tom等）**：触发分析、查看诊断报告、按建议排查问题
- **AI小助理**：通过API读取账户数据、执行对比分析、逐层诊断、生成报告

**核心前提**：后端转化（线索→有效线索→MQL→SQL→成交）一切正常，聚焦账户层级问题。

**分析粒度**：账户 → 计划 → 单元 → 关键词，全层级逐层下钻。

## 触发方式

### 方式1：手动触发（即时分析）

运营人员对AI小助理说：
- "帮我分析XX客户的账户"
- "XX客户账户最近数据怎么样"
- "诊断一下XX客户的账户"
- "帮我看看XX客户账户出了什么问题"

### 方式2：自动触发（每日巡检）

通过 `aily-cli auto --trigger-type cron` 配置每日定时分析：
- 每天上午9:00自动读取昨日账户数据
- 与前一天/上周同日数据对比
- 发现异常指标自动发送提醒给运营人员

> 自动触发配置详见 [usage-guide.md](references/usage-guide.md)。

## 核心功能

1. **数据读取**：通过百度API自动拉取账户、计划、单元、关键词各层级数据
2. **对比分析**：环比（昨日vs前日、本周vs上周）或同比（本月vs上月）
3. **逐层诊断**：账户 → 计划 → 单元 → 关键词，定位问题所在层级
4. **问题识别**：根据12个分析维度识别异常指标
5. **优化建议**：针对每个异常给出具体检查方向和操作建议
6. **报告输出**：结构化诊断报告（飞书云文档）+ 问题清单（Excel/多维表格）

## 使用流程（手动触发）

### Step 1: 触发分析

运营人员对AI小助理说出分析指令，可附加参数：
- 时间范围（如"最近7天""本周""本月"）
- 对比基准（如"环比上周""同比上月"）
- 关注指标（如"主要看点击和CPC"）

### Step 2: AI读取数据

AI通过百度API自动拉取以下数据：

**账户层级**：展现量、点击量、消费、CPC、CTR、转化数、转化成本
**计划层级**：各计划的展现、点击、消费、CPC、CTR、转化
**单元层级**：各单元的展现、点击、消费、CPC、CTR
**关键词层级**：各关键词的展现、点击、消费、CPC、排名、质量度

### Step 3: 对比分析

AI执行环比/同比对比，计算变化幅度：

| 变化幅度 | 标记 | 说明 |
|---------|------|------|
| > +30% | 🔴 大幅上升 | 需要关注是否正常 |
| +10%~+30% | 🟡 小幅上升 | 正常波动或优化效果 |
| -10%~+10% | 🟢 基本稳定 | 正常范围 |
| -30%~-10% | 🟡 小幅下降 | 需要关注 |
| < -30% | 🔴 大幅下降 | 需要排查问题 |

### Step 4: 逐层诊断

AI按照以下优先级逐层定位问题：

```
账户层级（整体趋势）
  └─ 展现异常？→ 进入【展现诊断】
  └─ 点击异常？→ 进入【点击诊断】
  └─ CPC异常？→ 进入【CPC诊断】
  └─ CTR异常？→ 进入【CTR诊断】
  └─ 消费异常？→ 进入【消费诊断】
      └─ 下钻到计划层级：哪个计划异常？
          └─ 下钻到单元层级：哪个单元异常？
              └─ 下钻到关键词层级：哪个关键词异常？
```

每个维度的诊断逻辑详见 [diagnosis-rules.md](references/diagnosis-rules.md)。

### Step 5: 生成诊断报告

AI生成结构化诊断报告，包含：

1. **数据概览**：各指标环比/同比变化
2. **异常指标列表**：哪些指标出现异常，幅度多大
3. **逐层诊断结论**：问题定位到哪个层级
4. **检查方向**：针对每个异常给出具体检查建议
5. **优化建议**：针对每个问题给出操作建议

输出格式详见 [output-template.md](references/output-template.md)。

### Step 6: 运营人员排查

运营人员根据诊断报告中的"检查方向"逐项排查：
- 检查排名是否变化
- 检查创意是否老化
- 检查竞争对手动态
- 检查匹配方式设置
- 检查否定关键词
- ...（具体检查项见诊断报告）

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

### 配置方式

通过 `aily-cli auto --trigger-type cron` 创建定时任务：

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

### 自动巡检逻辑

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

> 异常阈值可根据实际情况调整。

## 数据字段要求

通过API拉取的数据至少包含：

| 层级 | 必填字段 | 可选字段 |
|------|---------|---------|
| 账户 | 展现、点击、消费、CPC、CTR | 转化数、转化成本 |
| 计划 | 展现、点击、消费、CPC、CTR | 转化数、预算 |
| 单元 | 展现、点击、消费、CPC、CTR | 移动出价比例 |
| 关键词 | 展现、点击、消费、CPC、排名 | 质量度、匹配方式 |

## 分析维度

本skill覆盖12个分析维度，详见 [analysis-framework.md](references/analysis-framework.md)：

1. 展现数分析
2. 点击数分析
3. CPC分析
4. CTR分析
5. 消费分析
6. 计划层级分析
7. 单元层级分析
8. 关键词四象限分析
9. 创意层面分析
10. 否定关键词分析
11. 质量度分析
12. 间接转化分析

## 关键原则

1. **从整体到局部**：先分析账户整体趋势，再逐层下钻定位问题
2. **先数据后判断**：所有诊断基于数据对比，不凭感觉
3. **多维度交叉验证**：单一指标异常需结合其他指标综合判断
4. **给出可操作建议**：每个诊断结论必须附带具体检查方向
5. **区分轻重缓急**：🔴大幅异常优先处理，🟡小幅异常持续观察
6. **定期复盘**：建议每周做一次深度分析，每天做自动巡检

## 参考文件

| 文件 | 用途 | 何时读取 |
|------|------|---------|
| [analysis-framework.md](references/analysis-framework.md) | 12个分析维度的完整框架 | 执行分析时 |
| [diagnosis-rules.md](references/diagnosis-rules.md) | 诊断规则和检查清单 | 逐层诊断时 |
| [output-template.md](references/output-template.md) | 诊断报告输出模板 | 生成报告时 |
| [usage-guide.md](references/usage-guide.md) | 给小雪/tom的使用说明 | 首次使用时 |