amazon-feature-word-analyzer

定位

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

本 Skill 做三件事：

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

与 dinzee-search-term-report-analyzer 的区别：

• 后者：按完整搜索词做决策（否词/放量/观察）
• 本 Skill：按词根维度做特征分析，发现哪些"词片段"是表现核心

核心公式

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

输入参数

执行流程

Step 1: 读取并清洗数据

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

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 \x3C 目标 ACOS

⚠️ 待优化词根（降竞价 / 优化 Listing）：

• 高点击 + 高花费 + 低订单
• 点击≥15 且（订单=0 或 CVR \x3C 5%）

🔍 潜力词根（拓展长尾 / 提竞价抢量）：

• 低曝光 + 高 CVR
• 曝光≤500 且 CVR > 15% 且点击≥3

❌ 低效词根（否词候选）：

• 高曝光 + 低 CTR（曝光≥1000 且 CTR \x3C 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 \x3C 毛利率）：

   • 目标 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 升序排列：

6.2 两个词 Result 表

按 ACOS 升序排列：

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

6.4 词根价值总览

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

6.5 分析建议

基于数据给出：

• 哪些词根值得单独建精准广告组
• 哪些词根应降竞价或否词
• 哪些词根适合拓展长尾词
• Listing 中是否需要补充高频词根

输出文件

输出路径：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 \x3C 毛利率以保证利润
• 示例：利润 $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 越高

执行备忘（实战经验）

德国站报告字段映射

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

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

德语停用词

德国站必须加载德语停用词，否则 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：给出竞价建议但需用户确认后执行