amazon-feature-word-analyzer

亚马逊广告搜索词特征词/词根分析工具。将搜索词拆分为单词和相邻双词组合，汇总广告表现指标（曝光/点击/花费/订单/销售额 + CPC/CTR/CVR/ACOS/CPA），判断哪些词根值得加预算、精准投放、降价或否词。 使用时机：用户上传亚马逊广告搜索词报告，想从"词根维度"分析广告表现、找出高效/低效词根、制定竞价策略时调用。 触发词：特征词分析 / 词根分析 / feature word analysis / 搜索词拆词 / 广告词根

定位

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

本 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 绕过）：

'search_term': ['客户搜索词'],  # 脚本中只有 '搜索词'
'impressions': ['展示量'],      # 脚本中只有 '曝光量'
'clicks': ['点击量'],           # 脚本中只有 '点击次数'
'spend': ['花费'],              # 脚本中只有 '广告花费'
'orders': ['7天总订单数(#)'],   # 脚本中只有 '7天总订单数'

解决方案：优先使用 execute_code 内联执行，手动定义 FIELD_MAP 字典：

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：给出竞价建议但需用户确认后执行