siluzan-tso-cli 1.1.19-beta.5 → 1.1.19-beta.6
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.
package/README.md
CHANGED
|
@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills # 写入自定义目录
|
|
|
51
51
|
siluzan-tso init --force # 强制覆盖已存在文件
|
|
52
52
|
```
|
|
53
53
|
|
|
54
|
-
> **注意**：当前为测试版（1.1.19-beta.
|
|
54
|
+
> **注意**：当前为测试版（1.1.19-beta.6），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
|
|
55
55
|
|
|
56
56
|
| 助手 | 建议 `--ai` |
|
|
57
57
|
| ----------------------- | ------------------------------------ |
|
package/dist/skill/SKILL.md
CHANGED
|
@@ -219,7 +219,7 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
|
|
|
219
219
|
|
|
220
220
|
1. **不要**按 `google-period-report.md` 展开默认 8 维并追问追加；改读 **`report-templates/okki-weekly-google-client.md`** 全文并按其结构交付。
|
|
221
221
|
2. 确认 `mediaCustomerId` 与 `--start` / `--end`（未给齐则按上文「时间范围强制反问」）。
|
|
222
|
-
3. 同一 `--json-out` 目录执行模板中的命令组合：`list-accounts`（可选但推荐）、`stats`、`balance`、`google-analysis --sections overview,campaigns,keywords,search-terms,
|
|
222
|
+
3. 同一 `--json-out` 目录执行模板中的命令组合：`list-accounts`（可选但推荐）、`stats`、`balance`、`google-analysis --sections overview,campaigns,keywords,search-terms,campaign-device,campaign-geo`。
|
|
223
223
|
4. **先 outline 后脚本**：读各 `*.outline.txt`，再编写并执行代码从 JSON 计算并写出：① 客户话术（Markdown/纯文本均可）；② 若需 **Excel**：**必须**产出多 Sheet `.xlsx`（版式与 Sheet 名见模板「必选交付」节），**只能**由 Agent 在当前环境执行脚本生成，**禁止**假设存在 `siluzan-tso … excel` 类 CLI 子命令。WorkBuddy 等编排器须在流程中显式包含「写 `.xlsx` 脚本并执行」一步，否则易缺产物。
|
|
224
224
|
5. 遵守 SKILL 硬规范：金额 `*Display`、禁止手填业务数、禁止编造 ID。
|
|
225
225
|
|
package/dist/skill/_meta.json
CHANGED
|
@@ -41,31 +41,23 @@ siluzan-tso stats -m Google -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
41
41
|
siluzan-tso balance -m Google -a <mediaCustomerId> --json-out ./snap-okki
|
|
42
42
|
|
|
43
43
|
siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-out ./snap-okki \
|
|
44
|
-
--sections overview,campaigns,keywords,search-terms,
|
|
44
|
+
--sections overview,campaigns,keywords,search-terms,campaign-device,campaign-geo
|
|
45
45
|
```
|
|
46
46
|
|
|
47
47
|
**说明**：
|
|
48
48
|
|
|
49
49
|
- `stats`：区间消耗、曝光、点击、转化、CTR、CPC 等与**账户级周报摘要**对齐；金额用 `*Display` 或文档规定的展示字段。
|
|
50
50
|
- `balance`：**当前**账户余额（非历史快照）；话术里写清「截至查询时点」。
|
|
51
|
-
- `google-analysis`：系列 / 词 /
|
|
52
|
-
-
|
|
51
|
+
- `google-analysis`：系列 / 词 / 搜索词；**设备与国家两 Sheet 的数据源**须用 **`campaign-device` / `campaign-geo`**（网关 `…/campaigns/reports/device` 与 `…/campaigns/reports/geo`，**按广告系列（及常见广告组）拆行**），**不要**再用账户级 `devices` / `geographic`。JSON 根结构仍为 `devices[]` / `countries[]`，落盘文件名分别为 `campaign-device-<id>.json`、`campaign-geo-<id>.json`。若运营需对「国家」「设备」做跨系列汇总，在脚本中聚合，**禁止**改回账户级维度冒充系列口径。
|
|
52
|
+
- 可选：`campaign-geo` 支持网关阈值过滤，与 CLI 一致时追加 `--cost-greater` / `--click-greater` / `--conversions-greater`（见 `references/account-analytics.md`）。
|
|
53
|
+
- TopN、排序、跨系列汇总均在脚本内对 JSON 完成，禁止心算。
|
|
53
54
|
- **写脚本前**先读各 `<section>-<id>.outline.txt`（及 stats/balance 的 outline，若有），再读对应 `.json`。
|
|
54
55
|
|
|
55
|
-
**样表占位（账户级 `devices` / `geographic` → 设备与国家 Sheet）**（写脚本时**必须**遵守，便于与运营样表逐列对齐）：
|
|
56
|
-
|
|
57
|
-
| 列（样表语义） | 规则 |
|
|
58
|
-
| --- | --- |
|
|
59
|
-
| **广告系列** | JSON 无 `campaignName`（或等价字段）时，**统一填** `所有广告系列` |
|
|
60
|
-
| **级别** | **统一填** `账户` |
|
|
61
|
-
| **出价调整** | **统一填** `-`（半角减号；勿与空单元格混用，除非运营另行约定） |
|
|
62
|
-
| **广告组**（仅「设备」Sheet R3 含该列） | 账户级 JSON 无广告组字段时，**统一填** `—`（全角长横，**勿**用 `-`，以免与「出价调整」列混淆） |
|
|
63
|
-
|
|
64
56
|
---
|
|
65
57
|
|
|
66
|
-
##
|
|
58
|
+
## xlsx 版式规范
|
|
67
59
|
|
|
68
|
-
以下按 **工作簿 → Sheet 名（须完全一致）→ 版式** 约定，便于 WorkBuddy / 人工用样表对照验收。**不**再单独建名为「广告系列」的 Sheet（系列表在 **`账户报告`**
|
|
60
|
+
以下按 **工作簿 → Sheet 名（须完全一致）→ 版式** 约定，便于 WorkBuddy / 人工用样表对照验收。**不**再单独建名为「广告系列」的 Sheet（系列表在 **`账户报告`** 内）,所有数据保留小数点后两位
|
|
69
61
|
|
|
70
62
|
### 工作簿级
|
|
71
63
|
|
|
@@ -74,8 +66,8 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
74
66
|
| 1 | `账户报告` | `campaigns` + 复盘文案（stats/overview 汇总后由 Agent 撰写） |
|
|
75
67
|
| 2 | `关键词` | `keywords` |
|
|
76
68
|
| 3 | `搜索词` | `search-terms` |
|
|
77
|
-
| 4 | `设备` | **`
|
|
78
|
-
| 5 | `国家` | **`
|
|
69
|
+
| 4 | `设备` | **`campaign-device`**（`campaign-device-*.json`；按系列/组拆行，非账户级 `devices`） |
|
|
70
|
+
| 5 | `国家` | **`campaign-geo`**（`campaign-geo-*.json`；按系列/地域拆行，非账户级 `geographic`） |
|
|
79
71
|
|
|
80
72
|
### 各 Sheet 共同版式
|
|
81
73
|
|
|
@@ -108,8 +100,8 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
108
100
|
**1. 账户层级**（整体消耗、展示、点击、点击率与 3% 基准对比、询盘/转化数、平均询盘成本等，数来自 stats/overview 与上表合计）；
|
|
109
101
|
**2. 关键词层级**（高转化词、高消耗低转化词及出价/竞争力建议）；
|
|
110
102
|
**3. 搜索字词层级**（标红/高意向词、否词与加词建议）；
|
|
111
|
-
**4.
|
|
112
|
-
**5.
|
|
103
|
+
**4. 设备层级**（基于 **`campaign-device`**：各设备在系列上的消耗/转化分布；复盘可汇总或点出高消耗系列×设备组合）；
|
|
104
|
+
**5. 国家层级**（基于 **`campaign-geo`**：各国家/地区在系列上的消耗/转化；高消耗/低转化地域与降权/调价建议）。
|
|
113
105
|
文案由 Agent 据 JSON 撰写，**不得编造**表中不存在的数字。
|
|
114
106
|
|
|
115
107
|
---
|
|
@@ -142,8 +134,8 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
142
134
|
| --- | --- |
|
|
143
135
|
| R1 标题 | `设备报告` |
|
|
144
136
|
| R2 | 统计区间 |
|
|
145
|
-
| R3 表头（A→M，共 13 列） | `设备` \| `级别` \|
|
|
146
|
-
| R4… | **`
|
|
137
|
+
| R3 表头（A→M，共 13 列） | `设备` \| `级别` \| `广告系列` \| `出价调整` \| `展示次数` \| `点击次数` \| `点击率` \| `平均每次点击费用` \| `费用` \| `转化次数` \| `每次转化费用` \| `转化率` |
|
|
138
|
+
| R4… | **`campaign-device-*.json`**（根字段仍为 `devices[]`）：`deviceType` → 设备；`campaignName` / `adGroupName` 等映射「广告系列」「广告组」列；**出价调整** 若 JSON 无字段则留空或「—」级别列统一填 广告系列 |
|
|
147
139
|
|
|
148
140
|
---
|
|
149
141
|
|
|
@@ -154,7 +146,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
154
146
|
| R1 标题 | `地理位置报告` |
|
|
155
147
|
| R2 | 统计区间 |
|
|
156
148
|
| R3 表头（A→L，共 12 列） | `地理位置` \| `广告系列` \| `展示次数` \| `互动次数` \| `互动率` \| `费用` \| `平均费用` \| `点击次数` \| `点击率` \| `转化次数` \| `每次转化费用` \| `转化率` |
|
|
157
|
-
| R4… | **`
|
|
149
|
+
| R4… | **`campaign-geo-*.json`**（根字段仍为 `countries[]`）：`countryOrRegion` → 地理位置；`campaignName` 映射「广告系列」列；**互动次数** → `interactions`；**互动率** → `interactionRate`；**平均费用**列 **必须**按 **`spend / interactions`** 写入（`spend` 已为元、与 JSON 一致；与「每次互动费用」口径一致）。若 `interactions` 为 `0` / `null` / `undefined`，**平均费用**格填 **`—`**，禁止除零或手填臆造。其余列按 outline 映射。 |
|
|
158
150
|
|
|
159
151
|
---
|
|
160
152
|
|
|
@@ -193,7 +185,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
193
185
|
|
|
194
186
|
## 复盘小结 + 优化建议（对内或可附在客户邮件末段）
|
|
195
187
|
|
|
196
|
-
基于同一批 JSON（尤其 `campaigns`、`keywords`、`search-terms
|
|
188
|
+
基于同一批 JSON（尤其 `campaigns`、`keywords`、`search-terms`、**`campaign-device`**、**`campaign-geo`**、`overview`）：
|
|
197
189
|
|
|
198
190
|
- **复盘**：3～6 条 bullet：消耗集中度、高消耗系列/词、地域与设备差异、CTR/CPC 相对水平。
|
|
199
191
|
- **优化建议**：3～5 条可执行项（预算、否词、落地页、系列状态等），**不额外拉数**；缺数据则标 `[数据不可用：原因]`。
|
|
@@ -204,7 +196,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
204
196
|
|
|
205
197
|
| 项 | 周期报告 `google-period-report.md` | 本文 OKKI 周报 |
|
|
206
198
|
| -- | ---------------------------------- | ---------------- |
|
|
207
|
-
| 默认维度 | 8 维 + 主动追问可选追加 | **固定** `overview,campaigns,keywords,search-terms,
|
|
199
|
+
| 默认维度 | 8 维 + 主动追问可选追加 | **固定** `overview,campaigns,keywords,search-terms,campaign-device,campaign-geo` + `stats` + `balance` |
|
|
208
200
|
| 输出形态 | 长文分析报告 | **固定话术** + 短复盘 + **多 Sheet Excel（Agent 脚本写，非 CLI）** |
|
|
209
201
|
| 典型用户 | 内部分析 | **发客户**的同步简报 |
|
|
210
202
|
|