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
@@ -29,29 +29,32 @@
29
29
 
30
30
  ### 1.1 类型矩阵
31
31
 
32
- | 类型 | 最佳用途 | 漏斗位置 | 控制度 | 自动化程度 |
33
- |---|---|---|---|---|
34
- | **Search** | 高意图关键词捕获、线索、品牌防御 | 底部 | 高 | 中 |
35
- | **PMax** | 全漏斗覆盖、有产品 Feed 的电商 | 全部 | 低 | 极高 |
36
- | **Demand Gen** | YouTube/Discover/Gmail 视觉获客 | 中上部 | 中高 | 中 |
37
- | **Display** | 再营销、品牌曝光 | 顶部/中部 | 高 | 低中 |
38
- | **YouTube** | 视频驱动转化、品牌叙事 | 顶部/中部 | 中 | 中 |
39
- | **App** | 应用安装、应用内行为 | 全部 | 低 | 极高 |
32
+ | 类型 | 最佳用途 | 漏斗位置 | 控制度 | 自动化程度 |
33
+ | -------------- | -------------------------------- | --------- | ------ | ---------- |
34
+ | **Search** | 高意图关键词捕获、线索、品牌防御 | 底部 | 高 | 中 |
35
+ | **PMax** | 全漏斗覆盖、有产品 Feed 的电商 | 全部 | 低 | 极高 |
36
+ | **Demand Gen** | YouTube/Discover/Gmail 视觉获客 | 中上部 | 中高 | 中 |
37
+ | **Display** | 再营销、品牌曝光 | 顶部/中部 | 高 | 低中 |
38
+ | **YouTube** | 视频驱动转化、品牌叙事 | 顶部/中部 | 中 | 中 |
39
+ | **App** | 应用安装、应用内行为 | 全部 | 低 | 极高 |
40
40
 
41
41
  ### 1.2 选择决策树
42
42
 
43
43
  **第一步:主要目标是什么?**
44
+
44
45
  - 直接转化 + 有明确关键词 → **Search 优先,再叠加 PMax**
45
46
  - 有产品 Feed 的电商 → **PMax(Feed 驱动)+ Search(品牌/高价值词)+ Demand Gen**
46
47
  - 线索生成 → **Search + PMax(必须配置离线转化导入)**
47
48
  - 品牌知名度 → **YouTube + Display + Demand Gen**
48
49
 
49
50
  **第二步:有多少创意素材?**
51
+
50
52
  - 仅文字 → Search
51
53
  - 图片 + 文字 → Search + Display + Demand Gen
52
54
  - 视频 + 图片 + 文字 → 全类型
53
55
 
54
56
  **第三步:每月转化量多少?**
57
+
55
58
  - < 15 次/月/系列 → 仅 Search(Manual CPC 或 Max Clicks)
56
59
  - 15-30 次/月 → Search + 谨慎启动 PMax
57
60
  - 30+ 次/月 → Smart Bidding + PMax 可放心使用
@@ -74,6 +77,7 @@
74
77
  ```
75
78
 
76
79
  示例:
80
+
77
81
  - `Search_LeadGen_BrandedTerms_US_Exact`
78
82
  - `PMax_Ecom_AllProducts_US`
79
83
  - `DemandGen_Prospecting_LookalikeBuyers_US`
@@ -142,24 +146,26 @@ Account
142
146
 
143
147
  ### 3.1 策略选择指南
144
148
 
145
- | 场景 | 推荐策略 | 原因 |
146
- |---|---|---|
147
- | 新系列,< 15 转化/月 | Max Clicks(设 CPC 上限) | 积累数据 |
148
- | 15-30 转化/月 | Max Conversions(无目标) | 让算法无约束学习 |
149
- | 30+ 转化/月,明确 CPA 目标 | **Target CPA** | 数据充足,可精准控制 |
150
- | 30+ 转化/月,价值差异大 | **Target ROAS** | 按价值优化 |
151
- | 品牌系列 | Target Impression Share(90%+) | 品牌防御 |
152
- | 竞品系列 | Manual CPC 或 Max Clicks + CPC 上限 | 成本不可预测,需精细控制 |
149
+ | 场景 | 推荐策略 | 原因 |
150
+ | -------------------------- | ----------------------------------- | ------------------------ |
151
+ | 新系列,< 15 转化/月 | Max Clicks(设 CPC 上限) | 积累数据 |
152
+ | 15-30 转化/月 | Max Conversions(无目标) | 让算法无约束学习 |
153
+ | 30+ 转化/月,明确 CPA 目标 | **Target CPA** | 数据充足,可精准控制 |
154
+ | 30+ 转化/月,价值差异大 | **Target ROAS** | 按价值优化 |
155
+ | 品牌系列 | Target Impression Share(90%+) | 品牌防御 |
156
+ | 竞品系列 | Manual CPC 或 Max Clicks + CPC 上限 | 成本不可预测,需精细控制 |
153
157
 
154
158
  ### 3.2 校准 tCPA / tROAS
155
159
 
156
160
  **设定初始 tCPA:**
161
+
157
162
  1. 先用 Max Conversions(不设目标)运行 2-4 周
158
163
  2. 计算该期间的平均 CPA
159
164
  3. 设 tCPA = 平均 CPA 或高 10-20%(避免过度约束)
160
165
  4. 每 2 周收紧不超过 10-15%
161
166
 
162
167
  **设定初始 tROAS:**
168
+
163
169
  1. 先用 Max Conversion Value(不设目标)运行 2-4 周
164
170
  2. 计算平均 ROAS
165
171
  3. 设 tROAS = 平均 ROAS 或低 10-20%(给算法空间)
@@ -167,12 +173,12 @@ Account
167
173
 
168
174
  ### 3.3 新系列启动协议
169
175
 
170
- | 阶段 | 时间 | 策略 | 目标 |
171
- |---|---|---|---|
172
- | 1 | 第 1-2 周 | Max Clicks(CPC 上限 = 2× 预期均值) | 积累点击数据 |
173
- | 2 | 第 2-4 周 | Max Conversions(无目标) | 积累 15+ 转化 |
174
- | 3 | 第 4-8 周 | tCPA / tROAS(按平均值设) | 稳定优化 |
175
- | 4 | 持续 | 每 2 周调整 10-15% | 逐步趋近目标 |
176
+ | 阶段 | 时间 | 策略 | 目标 |
177
+ | ---- | --------- | ------------------------------------ | ------------- |
178
+ | 1 | 第 1-2 周 | Max Clicks(CPC 上限 = 2× 预期均值) | 积累点击数据 |
179
+ | 2 | 第 2-4 周 | Max Conversions(无目标) | 积累 15+ 转化 |
180
+ | 3 | 第 4-8 周 | tCPA / tROAS(按平均值设) | 稳定优化 |
181
+ | 4 | 持续 | 每 2 周调整 10-15% | 逐步趋近目标 |
176
182
 
177
183
  ### 3.4 学习期规则
178
184
 
@@ -183,6 +189,7 @@ Account
183
189
  ### 3.5 组合出价策略(Portfolio Bid Strategies)
184
190
 
185
191
  **适用场景**:
192
+
186
193
  - 多个系列共享同一转化目标和 CPA/ROAS 目标
187
194
  - 单系列 < 30 转化/月但合计 > 50
188
195
  - **禁忌**:不把品牌和非品牌系列放同一组合
@@ -193,10 +200,10 @@ Account
193
200
 
194
201
  ### 4.1 位置定向模式
195
202
 
196
- | 模式 | 含义 | 推荐场景 |
197
- |---|---|---|
198
- | **Presence or interest**(默认) | 在该地区 + 对该地区有兴趣的人 | 旅游、房产、留学 |
199
- | **Presence only** | 仅物理上在该地区的人 | **线索生成、本地服务、有配送限制的电商** |
203
+ | 模式 | 含义 | 推荐场景 |
204
+ | -------------------------------- | ----------------------------- | ---------------------------------------- |
205
+ | **Presence or interest**(默认) | 在该地区 + 对该地区有兴趣的人 | 旅游、房产、留学 |
206
+ | **Presence only** | 仅物理上在该地区的人 | **线索生成、本地服务、有配送限制的电商** |
200
207
 
201
208
  > 多数业务应改为 **Presence only**,避免预算浪费在「仅感兴趣」的用户上。
202
209
 
@@ -223,6 +230,7 @@ Account
223
230
  ### 4.3 地域排除
224
231
 
225
232
  始终排除:
233
+
226
234
  - 不提供服务/不配送的国家
227
235
  - 有法律限制的地区
228
236
  - 60+ 天有显著花费但 0 转化的地区
@@ -256,9 +264,9 @@ siluzan-tso ad geo list -a <CID> --mode excluded
256
264
 
257
265
  ### 5.1 设备出价调整规则
258
266
 
259
- | 出价策略 | 设备调整生效? |
260
- |---|---|
261
- | Manual CPC / ECPC | ✅ 生效(-100% ~ +900%) |
267
+ | 出价策略 | 设备调整生效? |
268
+ | ------------------------------------ | --------------------------------------------- |
269
+ | Manual CPC / ECPC | ✅ 生效(-100% ~ +900%) |
262
270
  | Smart Bidding(tCPA/tROAS/Max Conv) | ❌ **被忽略**(唯一例外:-100% 移动端仍生效) |
263
271
 
264
272
  ### 5.2 设备分析框架
@@ -270,20 +278,22 @@ siluzan-tso google-analysis devices -a <CID>
270
278
 
271
279
  对比 CTR、转化率、CPA、ROAS 按设备:
272
280
 
273
- | 情况 | 诊断 | 操作 |
274
- |---|---|---|
275
- | 移动端 CPA > 桌面端 50%+ | 移动落地页体验差 | 优先修复移动端 UX |
276
- | 移动端转化率 < 桌面端 40% | 严重移动端问题 | 短期可用 -100% 移动端;中期修页面 |
277
- | 移动端 CTR 高但转化低 | 点击真实但页面不转化 | 检查页面速度、表单、支付流程 |
281
+ | 情况 | 诊断 | 操作 |
282
+ | ------------------------- | -------------------- | --------------------------------- |
283
+ | 移动端 CPA > 桌面端 50%+ | 移动落地页体验差 | 优先修复移动端 UX |
284
+ | 移动端转化率 < 桌面端 40% | 严重移动端问题 | 短期可用 -100% 移动端;中期修页面 |
285
+ | 移动端 CTR 高但转化低 | 点击真实但页面不转化 | 检查页面速度、表单、支付流程 |
278
286
 
279
287
  ### 5.3 是否按设备拆分系列?
280
288
 
281
289
  **拆分条件**(同时满足):
290
+
282
291
  - 使用 Manual CPC
283
292
  - 移动端 vs 桌面端 CPA/ROAS 差异 >40%,持续 30+ 天
284
293
  - 有不同的移动端/桌面端落地页或优惠
285
294
 
286
295
  **不拆分**(2025 最佳实践):
296
+
287
297
  - 使用 Smart Bidding 时(自动处理设备优化)
288
298
  - 转化量低(拆分进一步碎片化数据)
289
299
 
@@ -293,48 +303,48 @@ siluzan-tso google-analysis devices -a <CID>
293
303
 
294
304
  ### 6.1 主转化 vs 次转化
295
305
 
296
- | 类型 | 含义 | 示例 |
297
- |---|---|---|
298
- | **主转化** | 纳入「转化」列 + Smart Bidding 优化依据 | 购买、合格线索、60s+ 通话 |
299
- | **次转化** | 仅观察,不影响出价 | 页面浏览、视频播放、微转化 |
306
+ | 类型 | 含义 | 示例 |
307
+ | ---------- | --------------------------------------- | -------------------------- |
308
+ | **主转化** | 纳入「转化」列 + Smart Bidding 优化依据 | 购买、合格线索、60s+ 通话 |
309
+ | **次转化** | 仅观察,不影响出价 | 页面浏览、视频播放、微转化 |
300
310
 
301
311
  **规则**:每个系列目标只设**一种**主转化。多种主转化表示同一行为(如表单 + 感谢页)会导致重复计数。
302
312
 
303
313
  ### 6.2 Enhanced Conversions
304
314
 
305
- | 类型 | 用途 | 效果 |
306
- |---|---|---|
307
- | **Enhanced Conversions for Web** | 在线转化 → hash 用户数据匹配 | 恢复 5-15% 未归因转化 |
308
- | **Enhanced Conversions for Leads** | 离线转化 → CRM 数据回传 | 替代旧版 GCLID 导入 |
315
+ | 类型 | 用途 | 效果 |
316
+ | ---------------------------------- | ---------------------------- | --------------------- |
317
+ | **Enhanced Conversions for Web** | 在线转化 → hash 用户数据匹配 | 恢复 5-15% 未归因转化 |
318
+ | **Enhanced Conversions for Leads** | 离线转化 → CRM 数据回传 | 替代旧版 GCLID 导入 |
309
319
 
310
320
  **2025 优先级**:所有账户启用 Web 版;所有线索生成账户启用 Leads 版。
311
321
 
312
322
  ### 6.3 离线转化导入要点
313
323
 
314
- | 要素 | 建议 |
315
- |---|---|
316
- | 上传频率 | 每 24 小时(越新鲜越好) |
317
- | 最大回溯期 | 90 天(Enhanced for Leads 为 63 天) |
324
+ | 要素 | 建议 |
325
+ | ---------- | ------------------------------------------ |
326
+ | 上传频率 | 每 24 小时(越新鲜越好) |
327
+ | 最大回溯期 | 90 天(Enhanced for Leads 为 63 天) |
318
328
  | 主转化设为 | 最深漏斗阶段(如「成交」而非「表单提交」) |
319
- | 转化价值 | 反映实际收入或预估 LTV |
320
- | 匹配率目标 | > 50%(70%+ 为佳) |
329
+ | 转化价值 | 反映实际收入或预估 LTV |
330
+ | 匹配率目标 | > 50%(70%+ 为佳) |
321
331
 
322
332
  ### 6.4 转化价值规则
323
333
 
324
334
  在不修改网站/CRM 的情况下,按条件调整报告中的转化价值:
325
335
 
326
- | 维度 | 示例 | 影响 |
327
- |---|---|---|
328
- | 地域 | 加州线索价值 +100% | 影响 tROAS 出价 |
329
- | 受众 | 回头客 +50% | 影响 tROAS 出价 |
336
+ | 维度 | 示例 | 影响 |
337
+ | ---- | ------------------- | --------------- |
338
+ | 地域 | 加州线索价值 +100% | 影响 tROAS 出价 |
339
+ | 受众 | 回头客 +50% | 影响 tROAS 出价 |
330
340
  | 设备 | 移动端线索价值 -30% | 影响 tROAS 出价 |
331
341
 
332
342
  ### 6.5 归因模型
333
343
 
334
- | 模型 | 说明 | 推荐 |
335
- |---|---|---|
336
- | **DDA(数据驱动归因)** | ML 分配跨触点功劳 | **默认推荐** |
337
- | Last-click | 100% 归功于最后一次点击 | 低转化量或简单结构时 |
344
+ | 模型 | 说明 | 推荐 |
345
+ | ----------------------- | ----------------------- | -------------------- |
346
+ | **DDA(数据驱动归因)** | ML 分配跨触点功劳 | **默认推荐** |
347
+ | Last-click | 100% 归功于最后一次点击 | 低转化量或简单结构时 |
338
348
 
339
349
  DDA 最低要求:~300 转化 + ~3,000 广告互动/30 天。
340
350
 
@@ -350,11 +360,11 @@ DDA 最低要求:~300 转化 + ~3,000 广告互动/30 天。
350
360
 
351
361
  ### 7.2 共享预算 vs 独立预算
352
362
 
353
- | 共享预算 | 独立预算 |
354
- |---|---|
355
- | 系列目标和 CPA/ROAS 相近 | 系列目标/盈利能力不同 |
356
- | 希望 Google 按日动态分配 | 需要按系列保底花费 |
357
- | **不适用**:品牌 vs 非品牌混合 | 品牌系列必须独立预算 |
363
+ | 共享预算 | 独立预算 |
364
+ | ------------------------------ | --------------------- |
365
+ | 系列目标和 CPA/ROAS 相近 | 系列目标/盈利能力不同 |
366
+ | 希望 Google 按日动态分配 | 需要按系列保底花费 |
367
+ | **不适用**:品牌 vs 非品牌混合 | 品牌系列必须独立预算 |
358
368
 
359
369
  ### 7.3 扩量协议
360
370
 
@@ -369,11 +379,11 @@ DDA 最低要求:~300 转化 + ~3,000 广告互动/30 天。
369
379
 
370
380
  ### 8.1 Google Search Partners
371
381
 
372
- | 状态 | 建议 |
373
- |---|---|
374
- | **默认关闭** | 2025 最佳实践:先关闭,测试后再开 |
375
- | 开启条件 | Search Partners CPA 在 Google Search CPA 的 120% 以内 |
376
- | 关闭条件 | Search Partners CPA > Google Search 130% |
382
+ | 状态 | 建议 |
383
+ | ------------ | ----------------------------------------------------- |
384
+ | **默认关闭** | 2025 最佳实践:先关闭,测试后再开 |
385
+ | 开启条件 | Search Partners CPA 在 Google Search CPA 的 120% 以内 |
386
+ | 关闭条件 | Search Partners CPA > Google Search 130% |
377
387
 
378
388
  ### 8.2 Display Network 扩展(Search 系列)
379
389
 
@@ -385,21 +395,21 @@ DDA 最低要求:~300 转化 + ~3,000 广告互动/30 天。
385
395
 
386
396
  ### 9.1 可用实验类型(2025)
387
397
 
388
- | 类型 | 适用 |
389
- |---|---|
398
+ | 类型 | 适用 |
399
+ | ------------------ | ------------------------------------ |
390
400
  | Custom Experiments | Search/Display/Demand Gen 系列级变更 |
391
- | PMax Experiments | PMax 增量测试 |
392
- | Video Experiments | 视频创意对比 |
393
- | Ad Variations | 跨多系列文案变更 |
401
+ | PMax Experiments | PMax 增量测试 |
402
+ | Video Experiments | 视频创意对比 |
403
+ | Ad Variations | 跨多系列文案变更 |
394
404
 
395
405
  ### 9.2 实验设置建议
396
406
 
397
- | 参数 | 推荐 |
398
- |---|---|
399
- | 流量分配 | 50/50(最快达到统计显著;风险低时用 70/30) |
400
- | 运行时长 | 最少 2 周,推荐 4-8 周 |
401
- | 置信度阈值 | ≥ 95% 再做决策 |
402
- | 评估指标 | 转化量、CPA、ROAS — 不仅看点击或 CTR |
407
+ | 参数 | 推荐 |
408
+ | ---------- | ------------------------------------------- |
409
+ | 流量分配 | 50/50(最快达到统计显著;风险低时用 70/30) |
410
+ | 运行时长 | 最少 2 周,推荐 4-8 周 |
411
+ | 置信度阈值 | ≥ 95% 再做决策 |
412
+ | 评估指标 | 转化量、CPA、ROAS — 不仅看点击或 CTR |
403
413
 
404
414
  ### 9.3 高价值测试清单
405
415
 
@@ -420,6 +430,7 @@ DDA 最低要求:~300 转化 + ~3,000 广告互动/30 天。
420
430
  ### 10.2 推荐处理原则
421
431
 
422
432
  **接受**:
433
+
423
434
  - 修复被拒广告/附加信息
424
435
  - 添加 RSA 变体(如 <3 个/广告组)
425
436
  - 添加 sitelink/callout/snippet
@@ -427,6 +438,7 @@ DDA 最低要求:~300 转化 + ~3,000 广告互动/30 天。
427
438
  - 移除重复/冲突关键词
428
439
 
429
440
  **谨慎/拒绝**:
441
+
430
442
  - 「提高预算」→ 仅在受限且 CPA 达标时接受
431
443
  - 「切换到 Max Conversions」→ 仅在数据充足时
432
444
  - 「开启 Display Network 扩展」→ 几乎总是拒绝
@@ -435,14 +447,14 @@ DDA 最低要求:~300 转化 + ~3,000 广告互动/30 天。
435
447
 
436
448
  ### 10.3 账户级关键设置
437
449
 
438
- | 设置 | 要求 |
439
- |---|---|
440
- | Auto-tagging | **必须开启**(转化追踪和 Analytics 集成前提) |
441
- | 转化目标 | 确认仅预期的转化设为账户默认主转化 |
442
- | 自动应用推荐 | 检查并**关闭**高风险项 |
443
- | IP 排除 | 排除已知机器人/竞品 IP(每系列最多 500) |
444
- | 品牌限制(PMax) | 使用品牌列表防止 PMax 竞价无关品牌 |
445
- | 内容适宜性 | 设置账户级内容排除(暴力/色情/争议内容) |
450
+ | 设置 | 要求 |
451
+ | ---------------- | --------------------------------------------- |
452
+ | Auto-tagging | **必须开启**(转化追踪和 Analytics 集成前提) |
453
+ | 转化目标 | 确认仅预期的转化设为账户默认主转化 |
454
+ | 自动应用推荐 | 检查并**关闭**高风险项 |
455
+ | IP 排除 | 排除已知机器人/竞品 IP(每系列最多 500) |
456
+ | 品牌限制(PMax) | 使用品牌列表防止 PMax 竞价无关品牌 |
457
+ | 内容适宜性 | 设置账户级内容排除(暴力/色情/争议内容) |
446
458
 
447
459
  ---
448
460