18 lines
1.6 KiB
Markdown
18 lines
1.6 KiB
Markdown
---
|
|
name: ads-analysis
|
|
description: 使用已连接的 SW Ads MCP 读取真实广告账户数据，分析投放表现、识别异常 Campaign，并形成只读优化建议。
|
|
---
|
|
# Ads Analysis
|
|
|
|
分析真实 SW Ads 数据时：
|
|
|
|
1. 先调用 `swads_whoami` 确认当前身份及可见账户；用户未指定账户时，使用该工具返回的当前或唯一可见账户，不要编造账户 ID。
|
|
2. 用户指定账户名、店铺名或品牌名时，只有在 `swads_whoami` 的可见账户中出现精确名称匹配，或工具结果明确返回其与 `external_account_id` 的映射时，才能选择该账户。不得用商品标题、素材文案、品牌关键词或相似名称推断账户归属。
|
|
3. 如果用户指定的名称无法唯一映射到可见账户，明确说明当前无法证实其账户归属，列出可见账户并请用户提供或选择精确的 `external_account_id`；在确认前不得调用该账户的指标查询。
|
|
4. 调用 `metrics_catalog` 确认可用指标、维度和查询结构。
|
|
5. 使用 `metrics_semantic_query` 获取分析所需的聚合数据。优先采用窄时间范围和聚合查询，避免一次请求大量明细。
|
|
6. 需要商品信息时调用 `commerce_list_products`。商品结果只能证明某账户下可见该商品，不能反向证明品牌或店铺名就是该广告账户。
|
|
7. 数值结论只能来自工具结果；若账户不可见、权限不足或数据缺失，明确说明原因并停止猜测。
|
|
|
|
所有 SW Ads 操作保持只读。优化预算、状态或账户数据只能作为建议，不得直接修改。
|