amazon-feature-word-analyzer

SKILL.md

---
name: amazon-feature-word-analyzer
description: |
  亚马逊广告搜索词特征词/词根分析工具。将搜索词拆分为单词和相邻双词组合，汇总广告表现指标（曝光/点击/花费/订单/销售额 + CPC/CTR/CVR/ACOS/CPA），判断哪些词根值得加预算、精准投放、降价或否词。
  使用时机：用户上传亚马逊广告搜索词报告，想从"词根维度"分析广告表现、找出高效/低效词根、制定竞价策略时调用。
  触发词：特征词分析 / 词根分析 / feature word analysis / 搜索词拆词 / 广告词根
benefits-from: []
user-invocable: true
allowed-tools: [Read, Write, Edit, Bash, Glob, Grep]
risk-level: medium
---

## 定位

亚马逊广告搜索词报告通常按完整搜索词展示数据，但运营决策需要知道**哪些单词或词组**才是真正驱动表现的因子。

本 Skill 做三件事：
1. 把每个搜索词拆成单词 + 相邻双词组合
2. 按词根维度汇总广告表现指标
3. 结合毛利率/目标 ACOS 计算目标竞价，指导投放策略

**与 `dinzee-search-term-report-analyzer` 的区别**：
- 后者：按完整搜索词做决策（否词/放量/观察）
- 本 Skill：按词根维度做特征分析，发现哪些"词片段"是表现核心

## 核心公式

| 指标 | 公式 | 含义 |
|------|------|------|
| CPC | Spend / Clicks | 平均点击成本 |
| CTR | Clicks / Impressions | 点击率 |
| CVR | Orders / Clicks | 转化率 |
| ACOS | Spend / Sales | 广告花费销售比 |
| CPA | Spend / Orders | 单笔订单广告成本 |
| 目标 Bid | 目标 ACOS × 售价 × CVR | 反推合理竞价 |
| 目标 CPA | 目标 ACOS × 售价 | 控制单笔获客成本 |

**关键关系**：CPC = ACOS × 售价 × CVR，CPA = CPC / CVR = ACOS × 售价

## 输入参数

| 参数 | 必须 | 默认值 | 说明 |
|------|------|--------|------|
| 搜索词报告文件 | 是 | - | CSV / XLSX，亚马逊广告后台导出 |
| 产品售价 | 否 | 报表推算 | 用于计算目标 Bid 和目标 CPA |
| 毛利率 | 否 | 不计算目标 Bid | 如 0.30 表示 30%，前期可设为全部毛利 |
| 目标 ACOS | 否 | = 毛利率 | 前期新品目标 ACOS = 毛利率，后期控制利润时降低 |
| 站点 | 否 | US | Amazon 站点 |
| 时间窗口 | 否 | 7天 | 7 / 30 / 90 天 |

## 执行流程

### Step 1: 读取并清洗数据

1. 读取用户上传的搜索词报告
2. 识别并保留核心字段（兼容多种报表格式）：

| 内部字段 | 可能的原始列名 |
|---------|--------------|
| search_term | Customer Search Term, 搜索词, Search Term |
| impressions | Impressions, 曝光量 |
| clicks | Clicks, 点击量 |
| spend | Spend, 广告花费, Cost |
| sales | 7 Day Total Sales, 7天总销售额, Sales, 7 Day Sales |
| orders | 7 Day Total Orders, 7天总订单, Orders, 7 Day Orders (#) |

3. 数据清洗：
   - 去除 search_term 为空的行
   - 统一转小写、去首尾空格、去标点
   - 数值字段强制转为 float，异常值标记

### Step 2: 单词维度拆分与汇总

1. 对每个 search_term 按空格拆分为单词列表
2. 过滤停用词（可选）：a, an, the, is, are, of, for, in, on, to, with, and, or, by, at
3. 每个单词继承原始搜索词的曝光/点击/花费/销售额/订单数据
4. 按单词分组汇总：
   - Impressions: 求和
   - Clicks: 求和
   - Spend: 求和
   - Sales: 求和
   - Orders: 求和
5. 计算衍生指标：
   - CPC = Spend / Clicks（Clicks=0 时留空）
   - CTR = Clicks / Impressions（Impressions=0 时留空）
   - CVR = Orders / Clicks（Clicks=0 时留空）
   - ACOS = Spend / Sales（Sales=0 时留空）
   - CPA = Spend / Orders（Orders=0 时留空）
6. 如果提供了毛利率和售价，额外计算：
   - 目标 Bid = 目标 ACOS × 售价 × CVR
   - 目标 CPA = 目标 ACOS × 售价

### Step 3: 相邻双词组合拆分与汇总

1. 对每个 search_term，生成相邻双词组合：
   - `stainless steel cat water fountain` → `stainless steel`, `steel cat`, `cat water`, `water fountain`
2. 使用**相邻双词**（而非任意两词组合），更接近真实词组含义
3. 同样汇总曝光/点击/花费/销售额/订单
4. 计算 CPC / CTR / CVR / ACOS / CPA
5. 额外计算每个组合中**两个单词各自的 CVR / ACOS / CPA**，用于对比

### Step 4: 词根价值判断

按以下维度对每个词根标记价值等级：

**⭐ 高价值词根（加预算 / 精准投放）**：
- CVR 高 + ACOS 低 + CPA 低
- 点击≥10 且订单≥2 且 ACOS < 目标 ACOS

**⚠️ 待优化词根（降竞价 / 优化 Listing）**：
- 高点击 + 高花费 + 低订单
- 点击≥15 且（订单=0 或 CVR < 5%）

**🔍 潜力词根（拓展长尾 / 提竞价抢量）**：
- 低曝光 + 高 CVR
- 曝光≤500 且 CVR > 15% 且点击≥3

**❌ 低效词根（否词候选）**：
- 高曝光 + 低 CTR（曝光≥1000 且 CTR < 0.3%）
- 高花费 + 零转化（Spend > 平均 CPC × 10 且订单=0）

**📊 观察词根**：
- 数据量不足或指标中等，暂无明确结论

### Step 5: 竞价策略计算

如果用户提供了**售价**和**毛利率**：

1. **前期新品策略**（ACOS = 毛利率，用全部毛利做广告）：
   - 目标 Bid = 毛利率 × 售价 × CVR
   - 示例：售价 $19.99，毛利率 30%，CVR 5% → 目标 Bid = 0.30 × 19.99 × 0.05 = $0.30

2. **后期利润策略**（控制 ACOS < 毛利率）：
   - 目标 ACOS = 毛利率 × 0.6~0.8（留利润空间）
   - 目标 Bid = 目标 ACOS × 售价 × CVR

3. **CPA 控制**：
   - 目标 CPA = 目标 ACOS × 售价
   - CPA = CPC / CVR，CPC 降下来或 CVR 拉上去都能降 CPA

4. **梯度预估**（新品期间 CPC 和 CVR 波动大）：
   - 情景1：CPC 高 × CVR 低 → 广告费最高
   - 情景2：CPC 中 × CVR 中 → 广告费中等
   - 情景3：CPC 低 × CVR 高 → 广告费最低
   - 按三种情景分别计算日广告费，给出预算区间

### Step 6: 输出报告

#### 6.1 单词 Result 表

按 ACOS 升序排列：

| 搜索词(单词) | Impressions | Clicks | Spend | 7 Day Total Sales | 7 Day Total Orders | CPC | CTR | CVR | ACOS | CPA | 价值等级 |
|-------------|-------------|--------|-------|-------------------|-------------------|-----|-----|-----|------|-----|---------|

#### 6.2 两个词 Result 表

按 ACOS 升序排列：

| Customer Search Term(双词) | Impressions | Clicks | Spend | 7 Day Total Sales | 7 Day Total Orders | CPC | CTR | CVR | ACOS | CPA | 单词1 | CVR1 | ACOS1 | CPA1 | 单词2 | CVR2 | ACOS2 | CPA2 |
|--------------------------|-------------|--------|-------|-------------------|-------------------|-----|-----|-----|------|-----|-------|------|-------|------|-------|------|-------|------|

#### 6.3 竞价策略表（如提供了售价和毛利率）

| 词根 | 当前CPC | 当前CVR | 目标Bid | 目标CPA | 竞价建议 | 说明 |
|------|--------|--------|--------|--------|---------|------|

#### 6.4 词根价值总览

按价值等级分组汇总，每组列出 top 词根及其核心指标。

#### 6.5 分析建议

基于数据给出：
- 哪些词根值得单独建精准广告组
- 哪些词根应降竞价或否词
- 哪些词根适合拓展长尾词
- Listing 中是否需要补充高频词根

## 输出文件

| 文件 | 格式 | 说明 |
|------|------|------|
| 主报告 | .md | 完整分析报告 |
| 特征词分析报告.html | .html | 可视化报告（用于Dinzee上传分享） |
| 单词Result表 | .csv | 单词维度汇总明细 |
| 双词Result表 | .csv | 双词组合维度汇总明细 |
| 竞价策略表 | .csv | 目标Bid和CPA计算（需提供售价/毛利率） |

输出路径：`outputs/feature-word-analyzer/{date}_{country_code}_{brand_or_asin}/`

## 报告模版与示例

- **报告模版**: `references/report-template.md` - 定义标准报告结构和字段说明
- **实际示例**: `references/report-example-it.md` - 意大利站完整报告示例

报告格式规范详见模版文件，包含6个核心章节：
1. 单词维度总览
2. 高价值词根 Top 10
3. 低效/否词候选
4. 双词组合分析 Top 10
5. 竞价策略建议
6. 策略建议

**注意**: Dinzee 上传不支持 .md 格式，需先转为 .html 再上传。

## 分析经验与最佳实践

### CPC 预估
- 在同行平均 CPC 基础上适当上调 50-60% 作为预算空间
- 参考同品类已投放商品的历史 CPC

### CVR 预估
- 新品期 CVR 波动大，建议用梯度预估
- 示例：CPC $2.5 + CVR 5% → 日广告费 $105；CPC $2.3 + CVR 7% → 日广告费 $69

### 利润与 ACOS 的关系
- 毛利率 = 可承受的最大 ACOS（前期）
- 后期稳定后，控制 ACOS < 毛利率以保证利润
- 示例：利润 $6，售价 $19.99，毛利率 30%，CVR 8%
  - 12.5 个点击出 1 单 → CPC 上限 = $6 / 12.5 = $0.48

### 新品期 vs 稳定期策略
- **新品期**：ACOS = 毛利率，用全部毛利做广告，优先跑数据
- **稳定期**：CVR 起来后控制 ACOS，降 CPC，拉利润
- **核心公式**：CPC = ACOS × 售价 × CVR，CVR 越高可承受的 CPC 越高

## 执行备忘（实战经验）

### 德国站报告字段映射
德国站广告报告列名为中文，实际字段对照：

| 德国站报表列名 | 内部字段 |
|--------------|---------|
| 客户搜索词 | search_term |
| 展示量 | impressions |
| 点击量 | clicks |
| 花费 | spend |
| 7天总销售额 | sales |
| 7天总订单数(#) | orders |
| 点击率 (CTR) | ctr（已有，可跳过计算） |
| 单次点击成本 (CPC) | cpc（已有） |
| 广告投入产出比 (ACOS) 总计 | acos（已有） |

其他站点报表也可能使用中文列名，脚本已内置兼容。

### 德语停用词
德国站必须加载德语停用词，否则 der/die/das/und/für/mit/von 等高频虚词会污染结果。
脚本中的 STOP_WORDS 集合已包含完整德语停用词（约100个）。

### ASIN 型搜索词处理
搜索词中可能出现 ASIN 本身（如 b0drxmvt81、b0ds21w3rh），这些是用户直接搜索竞品 ASIN。
分析时建议：
- 在报告中单独标注 ASIN 型词根，不与常规词根混排
- ASIN 型词根的 CVR/ACOS 反映的是竞品流量转化，不是词根本身的含义价值
- 可考虑在停用词中添加已知的高频无关 ASIN

### 货币符号
德国站报表货币为 EUR（€），脚本输出自动使用 € 前缀。其他站点需注意货币字段（报表中有"货币"列）。

### 脚本 FIELD_MAPPING 缺陷（重要）
`scripts/feature_word_analyzer.py` 中的 `FIELD_MAPPING` 字典**未包含**德国站中文列名，直接运行脚本会读取到 0 行数据。

缺失的映射（需手动补充或用 execute_code 绕过）：
```python
'search_term': ['客户搜索词'],  # 脚本中只有 '搜索词'
'impressions': ['展示量'],      # 脚本中只有 '曝光量'
'clicks': ['点击量'],           # 脚本中只有 '点击次数'
'spend': ['花费'],              # 脚本中只有 '广告花费'
'orders': ['7天总订单数(#)'],   # 脚本中只有 '7天总订单数'
```

**解决方案**：优先使用 `execute_code` 内联执行，手动定义 FIELD_MAP 字典：
```python
FIELD_MAP = {
    'search_term': '客户搜索词',
    'impressions': '展示量',
    'clicks': '点击量',
    'spend': '花费',
    'sales': '7天总销售额',
    'orders': '7天总订单数(#)'
}
```

### 执行方式建议
优先使用 `execute_code` 内联执行而非直接调用脚本文件，因为：
- 不同站点的停用词和字段映射需要动态调整（脚本 FIELD_MAPPING 不完整）
- 报告格式（MD）需要根据具体数据定制排版
- 竞价策略表的筛选逻辑可能因场景变化
- Dinzee 上传不支持 .md，需转 .html 后上传

## 风险与边界

- **本 Skill 不做**：不直接修改广告设置，不上传原始报表
- **需要人工复核**：低点击量词根的结论可靠性有限；停用词过滤可能误伤
- **数据要求**：至少需要 search_term + impressions + clicks + spend 四个字段
- **risk-level = medium**：给出竞价建议但需用户确认后执行