siluzan-tso-cli 1.1.12 → 1.1.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/README.md +33 -29
  2. package/dist/index.js +2267 -1440
  3. package/dist/skill/SKILL.md +93 -34
  4. package/dist/skill/_meta.json +2 -2
  5. package/dist/skill/assets/campaign-create-template.json +96 -101
  6. package/dist/skill/references/account-analytics.md +64 -62
  7. package/dist/skill/references/accounts.md +130 -130
  8. package/dist/skill/references/clue.md +13 -13
  9. package/dist/skill/references/finance.md +62 -61
  10. package/dist/skill/references/forewarning.md +40 -39
  11. package/dist/skill/references/google-ads-rules/google-ads-account-audit.md +165 -161
  12. package/dist/skill/references/google-ads-rules/google-ads-audience-strategy.md +94 -85
  13. package/dist/skill/references/google-ads-rules/google-ads-campaign-optimization.md +97 -85
  14. package/dist/skill/references/google-ads-rules/google-ads-compliance.md +274 -272
  15. package/dist/skill/references/google-ads-rules/google-ads-conversion-architecture.md +97 -82
  16. package/dist/skill/references/google-ads-rules/google-ads-creative-optimization.md +143 -139
  17. package/dist/skill/references/google-ads-rules/google-ads-keyword-optimization.md +131 -128
  18. package/dist/skill/references/google-ads-rules/google-ads-keyword-strategy.md +175 -173
  19. package/dist/skill/references/google-ads-rules/google-ads-launch-plan-template.md +126 -123
  20. package/dist/skill/references/google-ads-rules/google-ads-pmax-guide.md +86 -73
  21. package/dist/skill/references/google-ads-rules/sensitive-industries.md +43 -8
  22. package/dist/skill/references/google-ads.md +201 -196
  23. package/dist/skill/references/open-account-by-media.md +23 -23
  24. package/dist/skill/references/open-account-google-ui.md +26 -26
  25. package/dist/skill/references/optimize.md +8 -8
  26. package/dist/skill/references/reporting.md +28 -28
  27. package/dist/skill/references/setup.md +10 -7
  28. package/dist/skill/references/tso-home.md +11 -11
  29. package/dist/skill/references/workflows.md +28 -26
  30. package/dist/skill/report-templates/README.md +22 -21
  31. package/dist/skill/report-templates/REPORT-WORKFLOW.md +9 -9
  32. package/dist/skill/report-templates/bing-period-report.md +11 -11
  33. package/dist/skill/report-templates/google-ads-diagnosis.md +86 -86
  34. package/dist/skill/report-templates/google-period-report.md +23 -23
  35. package/dist/skill/report-templates/report-template-academic.html +433 -341
  36. package/dist/skill/report-templates/report-template-dark.html +440 -257
  37. package/dist/skill/report-templates/report-template-formal.html +438 -288
  38. package/dist/skill/report-templates/report-template-mobile.html +456 -241
  39. package/dist/skill/report-templates/report-template-onepager.html +452 -240
  40. package/dist/skill/report-templates/report-template-print.html +355 -243
  41. package/dist/skill/report-templates/report-template.html +485 -392
  42. package/dist/skill/report-templates/tiktok-period-report.md +10 -10
  43. package/package.json +13 -13
  44. package/scripts/postinstall.mjs +3 -1
@@ -9,11 +9,11 @@
9
9
 
10
10
  ### 三层审计框架
11
11
 
12
- | 层级 | 审计对象 | 核心命令 | 关注指标 |
13
- |------|---------|---------|---------|
14
- | 账户层 | 整体健康度、转化追踪、预算分配 | `overview`, `gold-account`, `ads-index`, `conversion-actions` | spend, conversions, costPerConversion, searchImpressionShare |
15
- | 广告系列层 | 结构合理性、出价策略、预算效率 | `campaigns`, `geographic`, `devices`, `daily-metrics` | searchBudgetLostImpressionShare, conversionRate, averageCpc |
16
- | 广告组/关键词层 | 关键词健康、创意质量、落地页 | `keywords`, `search-terms`, `ads`, `final-urls`, `extensions` | qualityScore, ctr, costPerConversion |
12
+ | 层级 | 审计对象 | 核心命令 | 关注指标 |
13
+ | --------------- | ------------------------------ | ------------------------------------------------------------- | ------------------------------------------------------------ |
14
+ | 账户层 | 整体健康度、转化追踪、预算分配 | `overview`, `gold-account`, `ads-index`, `conversion-actions` | spend, conversions, costPerConversion, searchImpressionShare |
15
+ | 广告系列层 | 结构合理性、出价策略、预算效率 | `campaigns`, `geographic`, `devices`, `daily-metrics` | searchBudgetLostImpressionShare, conversionRate, averageCpc |
16
+ | 广告组/关键词层 | 关键词健康、创意质量、落地页 | `keywords`, `search-terms`, `ads`, `final-urls`, `extensions` | qualityScore, ctr, costPerConversion |
17
17
 
18
18
  ### 效果下滑决策树
19
19
 
@@ -53,18 +53,18 @@ siluzan-tso google-analysis ads-index -a <CID>
53
53
 
54
54
  ### 健康指标阈值表
55
55
 
56
- | 指标 | 绿色(健康) | 黄色(关注) | 红色(立即处理) |
57
- |------|-------------|-------------|-----------------|
58
- | CTR(搜索) | > 5% | 3%-5% | < 3% |
59
- | 转化率 | > 5% | 2%-5% | < 2% |
60
- | 质量得分均值 | >= 7 | 5-6 | < 5 |
61
- | 搜索展示份额 | > 70% | 40%-70% | < 40% |
62
- | 预算损失展示份额 | < 5% | 5%-20% | > 20% |
63
- | 排名损失展示份额 | < 15% | 15%-30% | > 30% |
64
- | CPA vs 目标 | <= 1x 目标 | 1x-1.5x 目标 | > 1.5x 目标 |
65
- | 无效点击率 | < 5% | 5%-10% | > 10% |
66
- | 广告强度 | 优秀/良好 | 一般 | 差 |
67
- | 扩展覆盖率 | 全部广告系列 | > 50%系列 | < 50%系列 |
56
+ | 指标 | 绿色(健康) | 黄色(关注) | 红色(立即处理) |
57
+ | ---------------- | ------------ | ------------ | ---------------- |
58
+ | CTR(搜索) | > 5% | 3%-5% | < 3% |
59
+ | 转化率 | > 5% | 2%-5% | < 2% |
60
+ | 质量得分均值 | >= 7 | 5-6 | < 5 |
61
+ | 搜索展示份额 | > 70% | 40%-70% | < 40% |
62
+ | 预算损失展示份额 | < 5% | 5%-20% | > 20% |
63
+ | 排名损失展示份额 | < 15% | 15%-30% | > 30% |
64
+ | CPA vs 目标 | <= 1x 目标 | 1x-1.5x 目标 | > 1.5x 目标 |
65
+ | 无效点击率 | < 5% | 5%-10% | > 10% |
66
+ | 广告强度 | 优秀/良好 | 一般 | 差 |
67
+ | 扩展覆盖率 | 全部广告系列 | > 50%系列 | < 50%系列 |
68
68
 
69
69
  ### 快速诊断流程
70
70
 
@@ -85,12 +85,12 @@ siluzan-tso google-analysis campaigns -a <CID>
85
85
 
86
86
  ### 结构合理性判断矩阵
87
87
 
88
- | 月预算范围 | 建议最大广告系列数 | 建议每系列最大广告组数 | 理由 |
89
- |-----------|-------------------|---------------------|------|
90
- | < ¥5,000 | 2-3 | 3-5 | 预算有限,需集中火力 |
91
- | ¥5,000-¥20,000 | 3-5 | 5-8 | 适度细分,保证每系列有数据 |
92
- | ¥20,000-¥100,000 | 5-10 | 5-10 | 可按产品线/地域拆分 |
93
- | > ¥100,000 | 10-20 | 按需 | 充分细分,但仍需避免碎片化 |
88
+ | 月预算范围 | 建议最大广告系列数 | 建议每系列最大广告组数 | 理由 |
89
+ | ---------------- | ------------------ | ---------------------- | -------------------------- |
90
+ | < ¥5,000 | 2-3 | 3-5 | 预算有限,需集中火力 |
91
+ | ¥5,000-¥20,000 | 3-5 | 5-8 | 适度细分,保证每系列有数据 |
92
+ | ¥20,000-¥100,000 | 5-10 | 5-10 | 可按产品线/地域拆分 |
93
+ | > ¥100,000 | 10-20 | 按需 | 充分细分,但仍需避免碎片化 |
94
94
 
95
95
  ### Smart Bidding 数据量要求
96
96
 
@@ -103,13 +103,13 @@ siluzan-tso google-analysis campaigns -a <CID>
103
103
 
104
104
  ### 结构问题清单
105
105
 
106
- | 检查项 | 判定标准 | 处理方式 |
107
- |--------|---------|---------|
108
- | 广告系列过多 | 活跃系列 > 预算建议值的 2 倍 | 合并同类系列 |
109
- | 空广告组 | 广告组内无活跃关键词或无活跃广告 | 暂停或填充 |
110
- | 单关键词广告组过多 | SKAG 占比 > 50% | 按主题合并为 STAG |
111
- | 广告组主题混乱 | 同组关键词缺乏语义相关性 | 重新归类 |
112
- | 重复关键词跨组 | 同一关键词出现在多个广告组 | 去重,保留最优组 |
106
+ | 检查项 | 判定标准 | 处理方式 |
107
+ | ------------------ | -------------------------------- | ----------------- |
108
+ | 广告系列过多 | 活跃系列 > 预算建议值的 2 倍 | 合并同类系列 |
109
+ | 空广告组 | 广告组内无活跃关键词或无活跃广告 | 暂停或填充 |
110
+ | 单关键词广告组过多 | SKAG 占比 > 50% | 按主题合并为 STAG |
111
+ | 广告组主题混乱 | 同组关键词缺乏语义相关性 | 重新归类 |
112
+ | 重复关键词跨组 | 同一关键词出现在多个广告组 | 去重,保留最优组 |
113
113
 
114
114
  ## 4. 转化追踪审计
115
115
 
@@ -124,12 +124,12 @@ siluzan-tso google-analysis overview -a <CID>
124
124
 
125
125
  #### 4.1 主要转化操作检查
126
126
 
127
- | 检查项 | 正常状态 | 异常信号 |
128
- |--------|---------|---------|
129
- | 主要转化操作数量 | 1-3 个核心业务目标 | > 5 个设为主要 = 可能重复计数 |
130
- | 转化操作类型 | 与业务目标一致(购买/询盘/注册) | 微转化(页面浏览)被设为主要 |
131
- | 转化统计方式 | 购买类用"每次",询盘类用"一次" | 询盘类用"每次" = 重复计数 |
132
- | 转化窗口 | 与销售周期匹配(通常 30 天) | 窗口过短导致低估,过长导致高估 |
127
+ | 检查项 | 正常状态 | 异常信号 |
128
+ | ---------------- | -------------------------------- | ------------------------------ |
129
+ | 主要转化操作数量 | 1-3 个核心业务目标 | > 5 个设为主要 = 可能重复计数 |
130
+ | 转化操作类型 | 与业务目标一致(购买/询盘/注册) | 微转化(页面浏览)被设为主要 |
131
+ | 转化统计方式 | 购买类用"每次",询盘类用"一次" | 询盘类用"每次" = 重复计数 |
132
+ | 转化窗口 | 与销售周期匹配(通常 30 天) | 窗口过短导致低估,过长导致高估 |
133
133
 
134
134
  #### 4.2 重复计数检测
135
135
 
@@ -162,22 +162,22 @@ siluzan-tso google-analysis daily-metrics -a <CID>
162
162
 
163
163
  ### 出价策略选择矩阵
164
164
 
165
- | 月转化量 | 推荐出价策略 | 不推荐策略 | 原因 |
166
- |---------|-------------|-----------|------|
167
- | 0-15 | 手动CPC / 尽可能多的点击 | tCPA, tROAS | 数据不足,无法学习 |
168
- | 15-30 | 尽可能多的转化(不设目标) | tCPA(严格目标) | 数据勉强够,不宜限制过死 |
169
- | 30-50 | tCPA(宽松目标,+20%) | tROAS | 可开始用目标,但需留余量 |
170
- | 50+ | tCPA / tROAS | 手动CPC | 数据充足,应充分利用智能出价 |
165
+ | 月转化量 | 推荐出价策略 | 不推荐策略 | 原因 |
166
+ | -------- | -------------------------- | ---------------- | ---------------------------- |
167
+ | 0-15 | 手动CPC / 尽可能多的点击 | tCPA, tROAS | 数据不足,无法学习 |
168
+ | 15-30 | 尽可能多的转化(不设目标) | tCPA(严格目标) | 数据勉强够,不宜限制过死 |
169
+ | 30-50 | tCPA(宽松目标,+20%) | tROAS | 可开始用目标,但需留余量 |
170
+ | 50+ | tCPA / tROAS | 手动CPC | 数据充足,应充分利用智能出价 |
171
171
 
172
172
  ### 常见出价策略问题
173
173
 
174
- | 问题 | 检测方式 | 判定标准 | 处理建议 |
175
- |------|---------|---------|---------|
176
- | 策略与转化量不匹配 | 对比系列月转化量与上表 | 使用 tCPA 但月转化 < 15 | 切换到手动CPC或尽可能多的转化 |
177
- | tCPA 目标过低 | 对比实际 CPA 与目标 CPA | 目标 < 实际 CPA 的 70% | 提高目标至实际 CPA 的 90% |
178
- | tCPA 目标过高 | 对比实际 CPA 与目标 CPA | 目标 > 实际 CPA 的 150% | 逐步下调(每次不超过 20%) |
179
- | 学习期受干扰 | 检查 `daily-metrics` 波动 | 7 天内修改出价/预算超过 1 次 | 停止调整,等待学习期结束(通常7天) |
180
- | 预算限制出价 | 检查 searchBudgetLostImpressionShare | > 20% | 提高预算或降低出价目标 |
174
+ | 问题 | 检测方式 | 判定标准 | 处理建议 |
175
+ | ------------------ | ------------------------------------ | ---------------------------- | ----------------------------------- |
176
+ | 策略与转化量不匹配 | 对比系列月转化量与上表 | 使用 tCPA 但月转化 < 15 | 切换到手动CPC或尽可能多的转化 |
177
+ | tCPA 目标过低 | 对比实际 CPA 与目标 CPA | 目标 < 实际 CPA 的 70% | 提高目标至实际 CPA 的 90% |
178
+ | tCPA 目标过高 | 对比实际 CPA 与目标 CPA | 目标 > 实际 CPA 的 150% | 逐步下调(每次不超过 20%) |
179
+ | 学习期受干扰 | 检查 `daily-metrics` 波动 | 7 天内修改出价/预算超过 1 次 | 停止调整,等待学习期结束(通常7天) |
180
+ | 预算限制出价 | 检查 searchBudgetLostImpressionShare | > 20% | 提高预算或降低出价目标 |
181
181
 
182
182
  ### 学习期管理
183
183
 
@@ -200,31 +200,31 @@ siluzan-tso ad search-terms -a <CID>
200
200
 
201
201
  从 `keywords` 获取 qualityScore 数据:
202
202
 
203
- | 质量得分区间 | 健康占比 | 处理措施 |
204
- |-------------|---------|---------|
205
- | 8-10 | 应 > 30% | 维持,可适当提高出价获取更多流量 |
206
- | 5-7 | 应占主体 50-60% | 优化广告相关性和落地页体验 |
207
- | 1-4 | 应 < 10% | 立即优化或暂停;QS ≤ 3 且花费 > 0 = 浪费 |
208
- | 无评分 | — | 新词或低展示量词,暂不处理 |
203
+ | 质量得分区间 | 健康占比 | 处理措施 |
204
+ | ------------ | --------------- | ---------------------------------------- |
205
+ | 8-10 | 应 > 30% | 维持,可适当提高出价获取更多流量 |
206
+ | 5-7 | 应占主体 50-60% | 优化广告相关性和落地页体验 |
207
+ | 1-4 | 应 < 10% | 立即优化或暂停;QS ≤ 3 且花费 > 0 = 浪费 |
208
+ | 无评分 | — | 新词或低展示量词,暂不处理 |
209
209
 
210
210
  ### 6.2 浪费花费识别
211
211
 
212
212
  从 `keywords` 按 spend 降序排列,筛选高花费 + 零转化关键词:
213
213
 
214
- | 条件 | 操作 |
215
- |------|------|
216
- | spend > 平均 CPA × 2 且 conversions = 0 | **暂停关键词** |
217
- | spend > 平均 CPA × 1 且 conversions = 0 | **降低出价或标记观察** |
218
- | CTR < 1% 且 impressions > 1000 | **优化广告文案相关性或暂停** |
219
- | QS < 4 且 spend > 0 | **优化落地页或暂停** |
214
+ | 条件 | 操作 |
215
+ | --------------------------------------- | ---------------------------- |
216
+ | spend > 平均 CPA × 2 且 conversions = 0 | **暂停关键词** |
217
+ | spend > 平均 CPA × 1 且 conversions = 0 | **降低出价或标记观察** |
218
+ | CTR < 1% 且 impressions > 1000 | **优化广告文案相关性或暂停** |
219
+ | QS < 4 且 spend > 0 | **优化落地页或暂停** |
220
220
 
221
221
  ### 6.3 匹配类型审计
222
222
 
223
- | 检查项 | 理想分布 | 问题信号 |
224
- |--------|---------|---------|
223
+ | 检查项 | 理想分布 | 问题信号 |
224
+ | ------------ | -------------------------- | ----------------------------------- |
225
225
  | 广泛匹配占比 | < 30% 花费(搭配智能出价) | 广泛匹配花费 > 50% 且不使用智能出价 |
226
- | 词组匹配占比 | 30-50% | — |
227
- | 完全匹配占比 | 20-40% | 完全匹配 < 10% = 缺乏精准流量 |
226
+ | 词组匹配占比 | 30-50% | — |
227
+ | 完全匹配占比 | 20-40% | 完全匹配 < 10% = 缺乏精准流量 |
228
228
 
229
229
  ### 6.4 搜索词审计
230
230
 
@@ -251,46 +251,46 @@ siluzan-tso ad extension list -a <CID>
251
251
 
252
252
  从 `ads-index` 获取广告强度(Ad Strength)分布:
253
253
 
254
- | 广告强度 | 目标占比 | 处理 |
255
- |---------|---------|------|
256
- | 优秀 | > 30% | 保持 |
257
- | 良好 | > 40% | 可优化但非紧急 |
258
- | 一般 | < 20% | 添加更多标题/描述素材 |
259
- | 差 | 0% | **必须立即优化** — 添加素材至 15 标题 + 4 描述 |
254
+ | 广告强度 | 目标占比 | 处理 |
255
+ | -------- | -------- | ---------------------------------------------- |
256
+ | 优秀 | > 30% | 保持 |
257
+ | 良好 | > 40% | 可优化但非紧急 |
258
+ | 一般 | < 20% | 添加更多标题/描述素材 |
259
+ | 差 | 0% | **必须立即优化** — 添加素材至 15 标题 + 4 描述 |
260
260
 
261
261
  ### 7.2 RSA 素材覆盖检查
262
262
 
263
263
  从 `ad list --json` 检查每个 RSA 的素材数量:
264
264
 
265
- | 素材类型 | 最低要求 | 推荐数量 | 不足时影响 |
266
- |---------|---------|---------|-----------|
267
- | 标题 | 3 | 15(上限) | 广告强度降低,组合测试不充分 |
268
- | 描述 | 2 | 4(上限) | 同上 |
269
- | 包含关键词的标题 | >= 2 | 5+ | 相关性降低,QS 受影响 |
270
- | 独特卖点标题 | >= 2 | 3+ | 差异化不足 |
271
- | CTA 标题 | >= 1 | 2+ | 缺乏行动号召 |
265
+ | 素材类型 | 最低要求 | 推荐数量 | 不足时影响 |
266
+ | ---------------- | -------- | ---------- | ---------------------------- |
267
+ | 标题 | 3 | 15(上限) | 广告强度降低,组合测试不充分 |
268
+ | 描述 | 2 | 4(上限) | 同上 |
269
+ | 包含关键词的标题 | >= 2 | 5+ | 相关性降低,QS 受影响 |
270
+ | 独特卖点标题 | >= 2 | 3+ | 差异化不足 |
271
+ | CTA 标题 | >= 1 | 2+ | 缺乏行动号召 |
272
272
 
273
273
  ### 7.3 广告组广告数量
274
274
 
275
- | 每广告组 RSA 数量 | 状态 | 处理 |
276
- |-----------------|------|------|
277
- | 0 | 红色 | 广告组无法投放,立即创建 |
278
- | 1 | 黄色 | 建议增至 2-3 个进行 A/B 测试 |
279
- | 2-3 | 绿色 | 理想状态 |
280
- | > 3 | 黄色 | 数据分散,暂停表现最差的 |
275
+ | 每广告组 RSA 数量 | 状态 | 处理 |
276
+ | ----------------- | ---- | ---------------------------- |
277
+ | 0 | 红色 | 广告组无法投放,立即创建 |
278
+ | 1 | 黄色 | 建议增至 2-3 个进行 A/B 测试 |
279
+ | 2-3 | 绿色 | 理想状态 |
280
+ | > 3 | 黄色 | 数据分散,暂停表现最差的 |
281
281
 
282
282
  ### 7.4 扩展覆盖检查
283
283
 
284
284
  从 `extensions` + `ad extension list` 检查:
285
285
 
286
- | 扩展类型 | 是否必须 | 缺失影响 |
287
- |---------|---------|---------|
288
- | 站内链接(Sitelink) | 必须 | 广告面积小,CTR 损失 10-15% |
289
- | 摘要信息(Callout) | 必须 | 缺少信任信号 |
290
- | 结构化摘要(Snippet) | 推荐 | 缺少品类信息 |
291
- | 电话(Call) | 视业务而定 | 服务类必须,电商可选 |
292
- | 图片(Image) | 推荐 | 错失视觉吸引力 |
293
- | 促销(Promotion) | 季节性 | 有促销活动时必须添加 |
286
+ | 扩展类型 | 是否必须 | 缺失影响 |
287
+ | --------------------- | ---------- | --------------------------- |
288
+ | 站内链接(Sitelink) | 必须 | 广告面积小,CTR 损失 10-15% |
289
+ | 摘要信息(Callout) | 必须 | 缺少信任信号 |
290
+ | 结构化摘要(Snippet) | 推荐 | 缺少品类信息 |
291
+ | 电话(Call) | 视业务而定 | 服务类必须,电商可选 |
292
+ | 图片(Image) | 推荐 | 错失视觉吸引力 |
293
+ | 促销(Promotion) | 季节性 | 有促销活动时必须添加 |
294
294
 
295
295
  ## 8. 地域与设备审计
296
296
 
@@ -313,22 +313,22 @@ siluzan-tso ad geo list -a <CID> --mode targeted
313
313
 
314
314
  #### 地域性能分析
315
315
 
316
- | 检查项 | 判定标准 | 操作 |
317
- |--------|---------|------|
318
- | 地域 CPA 差异 | 某地域 CPA > 账户均值 2 倍 | 降低该地域出价调整或排除 |
319
- | 零转化地域 | 花费 > 2x 目标 CPA 且 0 转化 | 排除该地域 |
320
- | 高转化地域 | CPA < 账户均值 50% | 提高出价调整 +10%-30% |
321
- | 不在目标市场的地域 | 有花费但不在业务覆盖范围 | 立即排除 |
316
+ | 检查项 | 判定标准 | 操作 |
317
+ | ------------------ | ---------------------------- | ------------------------ |
318
+ | 地域 CPA 差异 | 某地域 CPA > 账户均值 2 倍 | 降低该地域出价调整或排除 |
319
+ | 零转化地域 | 花费 > 2x 目标 CPA 且 0 转化 | 排除该地域 |
320
+ | 高转化地域 | CPA < 账户均值 50% | 提高出价调整 +10%-30% |
321
+ | 不在目标市场的地域 | 有花费但不在业务覆盖范围 | 立即排除 |
322
322
 
323
323
  ### 8.2 设备审计
324
324
 
325
325
  从 `devices` 获取设备维度数据:
326
326
 
327
- | 设备 | 检查指标 | 常见问题 | 处理 |
328
- |------|---------|---------|------|
327
+ | 设备 | 检查指标 | 常见问题 | 处理 |
328
+ | ------ | ------------------------ | ------------------- | ------------------------------------ |
329
329
  | 移动端 | conversionRate vs 桌面端 | 移动端转化率低 50%+ | 检查移动落地页体验,考虑降低出价调整 |
330
- | 桌面端 | CPA 对比 | 通常 CPA 最优 | 如是,可提高出价调整 |
331
- | 平板 | 花费占比 | 花费高但转化差 | 考虑设置 -100% 出价排除 |
330
+ | 桌面端 | CPA 对比 | 通常 CPA 最优 | 如是,可提高出价调整 |
331
+ | 平板 | 花费占比 | 花费高但转化差 | 考虑设置 -100% 出价排除 |
332
332
 
333
333
  #### 设备出价调整建议
334
334
 
@@ -356,12 +356,12 @@ siluzan-tso google-analysis devices -a <CID>
356
356
 
357
357
  从 `final-urls` 获取各 URL 的 spend、clicks、conversions、conversionRate:
358
358
 
359
- | 检查项 | 判定标准 | 操作 |
360
- |--------|---------|------|
361
- | 高花费零转化 URL | spend > 3x 目标 CPA 且 conversions = 0 | 暂停指向该 URL 的广告或更换落地页 |
362
- | 转化率显著低于均值 | conversionRate < 账户均值 × 0.5 | 检查页面内容、加载速度、表单体验 |
363
- | 转化率显著高于均值 | conversionRate > 账户均值 × 1.5 | 将更多流量引向该页面 |
364
- | URL 过多 | 独立 URL > 20 个 | 检查是否有无效/重复页面 |
359
+ | 检查项 | 判定标准 | 操作 |
360
+ | ------------------ | -------------------------------------- | --------------------------------- |
361
+ | 高花费零转化 URL | spend > 3x 目标 CPA 且 conversions = 0 | 暂停指向该 URL 的广告或更换落地页 |
362
+ | 转化率显著低于均值 | conversionRate < 账户均值 × 0.5 | 检查页面内容、加载速度、表单体验 |
363
+ | 转化率显著高于均值 | conversionRate > 账户均值 × 1.5 | 将更多流量引向该页面 |
364
+ | URL 过多 | 独立 URL > 20 个 | 检查是否有无效/重复页面 |
365
365
 
366
366
  ### 9.2 移动端 vs 桌面端落地页
367
367
 
@@ -390,13 +390,13 @@ siluzan-tso ad campaigns -a <CID> --json
390
390
 
391
391
  从 `campaigns` 获取 searchBudgetLostImpressionShare:
392
392
 
393
- | 预算损失展示份额 | 状态 | 操作 |
394
- |-----------------|------|------|
395
- | 0% | 可能预算过高或关键词过少 | 检查是否有扩量空间 |
396
- | 1%-10% | 理想状态 | 维持,可微调 |
397
- | 10%-20% | 黄色 | 评估是否有增加预算的 ROI 空间 |
398
- | 20%-50% | 红色 | 错失大量展示机会,优先加预算 |
399
- | > 50% | 严重 | 预算严重不足,需大幅调整或收窄定向 |
393
+ | 预算损失展示份额 | 状态 | 操作 |
394
+ | ---------------- | ------------------------ | ---------------------------------- |
395
+ | 0% | 可能预算过高或关键词过少 | 检查是否有扩量空间 |
396
+ | 1%-10% | 理想状态 | 维持,可微调 |
397
+ | 10%-20% | 黄色 | 评估是否有增加预算的 ROI 空间 |
398
+ | 20%-50% | 红色 | 错失大量展示机会,优先加预算 |
399
+ | > 50% | 严重 | 预算严重不足,需大幅调整或收窄定向 |
400
400
 
401
401
  ### 10.2 预算分配合理性
402
402
 
@@ -404,16 +404,17 @@ siluzan-tso ad campaigns -a <CID> --json
404
404
  2. 计算每个系列的 ROAS 或 CPA
405
405
  3. 检查以下不合理分配:
406
406
 
407
- | 问题 | 检测方式 | 处理 |
408
- |------|---------|------|
409
- | 高 CPA 系列获得高预算 | CPA 排名前 25% 但预算也在前 25% | 降低预算,转移至低 CPA 系列 |
410
- | 低 CPA 系列预算受限 | CPA 最优但 searchBudgetLostIS > 20% | 增加预算 |
411
- | 无转化系列持续花费 | 30 天 spend > 0 且 conversions = 0 | 暂停或重新诊断 |
412
- | 每日预算过低 | 日预算 < 目标 CPA × 2 | 提高日预算至少为目标 CPA 的 2-3 倍 |
407
+ | 问题 | 检测方式 | 处理 |
408
+ | --------------------- | ----------------------------------- | ---------------------------------- |
409
+ | 高 CPA 系列获得高预算 | CPA 排名前 25% 但预算也在前 25% | 降低预算,转移至低 CPA 系列 |
410
+ | 低 CPA 系列预算受限 | CPA 最优但 searchBudgetLostIS > 20% | 增加预算 |
411
+ | 无转化系列持续花费 | 30 天 spend > 0 且 conversions = 0 | 暂停或重新诊断 |
412
+ | 每日预算过低 | 日预算 < 目标 CPA × 2 | 提高日预算至少为目标 CPA 的 2-3 倍 |
413
413
 
414
414
  ### 10.3 花费趋势分析
415
415
 
416
416
  运行 `daily-metrics` 检查:
417
+
417
418
  - 花费突然下降 → 可能是预算耗尽、广告被拒、出价策略异常
418
419
  - 花费突然上升 → 可能是新关键词触发或出价策略调整
419
420
  - 周末/工作日花费差异大 → 考虑设置广告投放时间
@@ -430,22 +431,22 @@ siluzan-tso google-analysis dimension-summary -a <CID>
430
431
 
431
432
  ### 展示份额指标解读
432
433
 
433
- | 指标 | 含义 | 取值范围 |
434
- |------|------|---------|
435
- | searchImpressionShare | 实际展示次数 / 有资格展示的总次数 | 0%-100% |
436
- | searchBudgetLostImpressionShare | 因预算不足损失的展示份额 | 0%-100% |
437
- | searchRankLostImpressionShare | 因广告排名不足损失的展示份额 | 0%-100% |
434
+ | 指标 | 含义 | 取值范围 |
435
+ | ------------------------------- | --------------------------------- | -------- |
436
+ | searchImpressionShare | 实际展示次数 / 有资格展示的总次数 | 0%-100% |
437
+ | searchBudgetLostImpressionShare | 因预算不足损失的展示份额 | 0%-100% |
438
+ | searchRankLostImpressionShare | 因广告排名不足损失的展示份额 | 0%-100% |
438
439
 
439
440
  **核心公式:** searchImpressionShare + searchBudgetLostIS + searchRankLostIS ≈ 100%
440
441
 
441
442
  ### 竞争策略决策矩阵
442
443
 
443
- | 预算损失IS | 排名损失IS | 诊断 | 建议操作 |
444
- |-----------|-----------|------|---------|
445
- | 高 (>20%) | 低 (<15%) | 预算受限,但竞争力足 | 增加预算即可获取更多转化 |
446
- | 低 (<10%) | 高 (>30%) | 预算充足,但竞争力不足 | 提高 QS(优化广告+落地页)或提高出价 |
447
- | 高 (>20%) | 高 (>20%) | 预算和竞争力双重不足 | 优先提 QS(免费提升),再考虑加预算 |
448
- | 低 (<10%) | 低 (<15%) | 展示份额已较高 | 维持现状或开拓新关键词 |
444
+ | 预算损失IS | 排名损失IS | 诊断 | 建议操作 |
445
+ | ---------- | ---------- | ---------------------- | ------------------------------------ |
446
+ | 高 (>20%) | 低 (<15%) | 预算受限,但竞争力足 | 增加预算即可获取更多转化 |
447
+ | 低 (<10%) | 高 (>30%) | 预算充足,但竞争力不足 | 提高 QS(优化广告+落地页)或提高出价 |
448
+ | 高 (>20%) | 高 (>20%) | 预算和竞争力双重不足 | 优先提 QS(免费提升),再考虑加预算 |
449
+ | 低 (<10%) | 低 (<15%) | 展示份额已较高 | 维持现状或开拓新关键词 |
449
450
 
450
451
  ### 提升广告排名的优先级
451
452
 
@@ -467,19 +468,20 @@ siluzan-tso google-analysis dimension-summary -a <CID>
467
468
 
468
469
  ## 账户概要
469
470
 
470
- | 指标 | 数值 | 趋势(vs 上期) |
471
- |------|------|----------------|
472
- | 总花费 | ¥<SPEND> | ↑/↓ <PERCENT>% |
473
- | 总转化 | <CONVERSIONS> | ↑/↓ <PERCENT>% |
474
- | 平均 CPA | ¥<CPA> | ↑/↓ <PERCENT>% |
475
- | 平均 CTR | <CTR>% | ↑/↓ <PERCENT>% |
476
- | 搜索展示份额 | <IS>% | ↑/↓ <PERCENT>% |
471
+ | 指标 | 数值 | 趋势(vs 上期) |
472
+ | ------------ | ------------- | --------------- |
473
+ | 总花费 | ¥<SPEND> | ↑/↓ <PERCENT>% |
474
+ | 总转化 | <CONVERSIONS> | ↑/↓ <PERCENT>% |
475
+ | 平均 CPA | ¥<CPA> | ↑/↓ <PERCENT>% |
476
+ | 平均 CTR | <CTR>% | ↑/↓ <PERCENT>% |
477
+ | 搜索展示份额 | <IS>% | ↑/↓ <PERCENT>% |
477
478
 
478
479
  ## 严重问题(Critical)
479
480
 
480
481
  > 需立即处理,正在造成资金浪费或数据失真
481
482
 
482
483
  ### C1: <问题标题>
484
+
483
485
  - **数据依据:** 运行 `<CLI命令>` 发现 <具体数据>
484
486
  - **影响:** <对账户的具体影响>
485
487
  - **建议操作:** <具体修复步骤>
@@ -490,6 +492,7 @@ siluzan-tso google-analysis dimension-summary -a <CID>
490
492
  > 需尽快处理,正在影响效果但非紧急
491
493
 
492
494
  ### W1: <问题标题>
495
+
493
496
  - **数据依据:** 运行 `<CLI命令>` 发现 <具体数据>
494
497
  - **影响:** <对账户的具体影响>
495
498
  - **建议操作:** <具体修复步骤>
@@ -499,6 +502,7 @@ siluzan-tso google-analysis dimension-summary -a <CID>
499
502
  > 非问题,但有提升空间
500
503
 
501
504
  ### O1: <机会标题>
505
+
502
506
  - **数据依据:** 运行 `<CLI命令>` 发现 <具体数据>
503
507
  - **潜在收益:** <预估提升幅度>
504
508
  - **建议操作:** <具体优化步骤>
@@ -517,28 +521,28 @@ siluzan-tso google-analysis dimension-summary -a <CID>
517
521
 
518
522
  ## 13. 常见问题诊断速查表
519
523
 
520
- | # | 症状 | 检查数据 | 可能原因 | 修复命令/操作 |
521
- |---|------|---------|---------|-------------|
522
- | 1 | CPA 突然飙升 | `campaigns` 查 costPerConversion 趋势 | 出价策略进入学习期 | `daily-metrics` 确认,等待 7 天或回退策略 |
523
- | 2 | CPA 突然飙升 | `search-terms` 查新增搜索词 | 触发不相关搜索词 | 添加否定关键词 |
524
- | 3 | CPA 突然飙升 | `keywords` 查 qualityScore 变化 | QS 下降导致 CPC 上升 | 优化广告相关性和落地页 |
525
- | 4 | CTR 持续下降 | `ads` 查广告强度和创意内容 | 广告疲劳 | 更新广告素材,添加新标题/描述 |
526
- | 5 | CTR 持续下降 | `campaigns` 查 searchImpressionShare | 广告位置下降 | 检查出价竞争力和 QS |
527
- | 6 | 展示量大幅下降 | `campaigns` 查 searchBudgetLostIS | 预算耗尽 | 增加预算 |
528
- | 7 | 展示量大幅下降 | `keywords` 查关键词状态 | 关键词被暂停或否定 | `ad keywords --json` 检查状态 |
529
- | 8 | 展示量大幅下降 | `campaigns` 查系列状态 | 广告被拒或系列暂停 | `ad campaigns --json` 检查状态 |
530
- | 9 | 转化量下降但点击正常 | `final-urls` 查转化率 | 落地页问题(改版/故障) | 检查落地页是否可访问且正常 |
531
- | 10 | 转化量下降但点击正常 | `conversion-actions` 查转化操作 | 转化追踪代码失效 | 检查 Google Tag 是否正常触发 |
532
- | 11 | 预算花不出去 | `keywords` 查展示量和出价 | 出价过低无竞争力 | 提高出价或切换出价策略 |
533
- | 12 | 预算花不出去 | `ad keywords --json` 查关键词数量 | 关键词太少或搜索量低 | 扩展关键词列表 |
534
- | 13 | QS 整体下降 | `keywords` 查 QS 分布 | 落地页体验下降 | 检查落地页加载速度和内容相关性 |
535
- | 14 | QS 整体下降 | `ads` 查广告相关性 | 广告与关键词不匹配 | 重写广告,确保包含核心关键词 |
536
- | 15 | 移动端效果差 | `devices` 查移动端 CPA | 移动落地页体验差 | 优化移动端页面或降低移动出价 |
537
- | 16 | 某地域 CPA 极高 | `geographic` 查各地域 CPA | 地域定向过宽 | 排除低效地域或降低出价调整 |
538
- | 17 | 搜索展示份额骤降 | `campaigns` 查 searchRankLostIS | 竞争对手加大投放 | 提高 QS 和出价应对 |
539
- | 18 | 转化波动大(时高时低) | `daily-metrics` 查每日趋势 | 转化延迟或追踪不稳定 | `conversion-actions` 确认追踪和归因窗口 |
540
- | 19 | 花费突然激增 | `search-terms` 查新搜索词 | 广泛匹配触发大量新词 | 添加否定关键词,收紧匹配类型 |
541
- | 20 | 广告审核被拒 | `ad list --json` 查广告状态 | 广告违规政策 | 修改广告内容后重新提交 |
524
+ | # | 症状 | 检查数据 | 可能原因 | 修复命令/操作 |
525
+ | --- | ---------------------- | ------------------------------------- | ----------------------- | ----------------------------------------- |
526
+ | 1 | CPA 突然飙升 | `campaigns` 查 costPerConversion 趋势 | 出价策略进入学习期 | `daily-metrics` 确认,等待 7 天或回退策略 |
527
+ | 2 | CPA 突然飙升 | `search-terms` 查新增搜索词 | 触发不相关搜索词 | 添加否定关键词 |
528
+ | 3 | CPA 突然飙升 | `keywords` 查 qualityScore 变化 | QS 下降导致 CPC 上升 | 优化广告相关性和落地页 |
529
+ | 4 | CTR 持续下降 | `ads` 查广告强度和创意内容 | 广告疲劳 | 更新广告素材,添加新标题/描述 |
530
+ | 5 | CTR 持续下降 | `campaigns` 查 searchImpressionShare | 广告位置下降 | 检查出价竞争力和 QS |
531
+ | 6 | 展示量大幅下降 | `campaigns` 查 searchBudgetLostIS | 预算耗尽 | 增加预算 |
532
+ | 7 | 展示量大幅下降 | `keywords` 查关键词状态 | 关键词被暂停或否定 | `ad keywords --json` 检查状态 |
533
+ | 8 | 展示量大幅下降 | `campaigns` 查系列状态 | 广告被拒或系列暂停 | `ad campaigns --json` 检查状态 |
534
+ | 9 | 转化量下降但点击正常 | `final-urls` 查转化率 | 落地页问题(改版/故障) | 检查落地页是否可访问且正常 |
535
+ | 10 | 转化量下降但点击正常 | `conversion-actions` 查转化操作 | 转化追踪代码失效 | 检查 Google Tag 是否正常触发 |
536
+ | 11 | 预算花不出去 | `keywords` 查展示量和出价 | 出价过低无竞争力 | 提高出价或切换出价策略 |
537
+ | 12 | 预算花不出去 | `ad keywords --json` 查关键词数量 | 关键词太少或搜索量低 | 扩展关键词列表 |
538
+ | 13 | QS 整体下降 | `keywords` 查 QS 分布 | 落地页体验下降 | 检查落地页加载速度和内容相关性 |
539
+ | 14 | QS 整体下降 | `ads` 查广告相关性 | 广告与关键词不匹配 | 重写广告,确保包含核心关键词 |
540
+ | 15 | 移动端效果差 | `devices` 查移动端 CPA | 移动落地页体验差 | 优化移动端页面或降低移动出价 |
541
+ | 16 | 某地域 CPA 极高 | `geographic` 查各地域 CPA | 地域定向过宽 | 排除低效地域或降低出价调整 |
542
+ | 17 | 搜索展示份额骤降 | `campaigns` 查 searchRankLostIS | 竞争对手加大投放 | 提高 QS 和出价应对 |
543
+ | 18 | 转化波动大(时高时低) | `daily-metrics` 查每日趋势 | 转化延迟或追踪不稳定 | `conversion-actions` 确认追踪和归因窗口 |
544
+ | 19 | 花费突然激增 | `search-terms` 查新搜索词 | 广泛匹配触发大量新词 | 添加否定关键词,收紧匹配类型 |
545
+ | 20 | 广告审核被拒 | `ad list --json` 查广告状态 | 广告违规政策 | 修改广告内容后重新提交 |
542
546
 
543
547
  ## 14. CLI 审计命令序列
544
548