Youzan Ma

---
name: youzan-ma
version: 1.1.37
description: "营销画布计划、计划效果、店铺效果和可调用工具元数据的原始查询；不提供营销计划、节点或工具调用造成的远端数据变更能力，不做营销策略、画像、推荐或经营结论。"
---

# 营销画布

使用本 skill 前，确认当前授权范围和店铺上下文。本入口提供营销画布计划、节点和效果的原始查询结果，业务方案和旅程编排由上层营销业务能力负责。

## 查询数量限制

- 列表查询必须显式传入页码和每页数量，不得依赖接口默认分页；每页最多查询 20 条。
- 批量查询每批最多传入 20 个对象或标识；超过 20 个时必须拆分为多个批次依次查询，且每批均不得超过 20 个。

## 支持能力

- 分页查询营销画布计划。
- 按计划标识查询画布流程、节点、连边和节点配置。
- 查询单个计划的触达、访问和支付效果。
- 按店铺和时间范围查询触达、访问或支付的汇总及时间维度数据。
- 查询营销画布可用工具列表和单个工具的输入输出说明。
- 返回效果、计划和工具元数据，不做多计划汇总之外的趋势研判、归因解释或策略建议。

## 字段提示

- 查询参数和返回结果中的字段必须使用中文字段名，不展示接口英文原始字段名。

### 必填信息

- 查询单个计划时必须提供计划标识。
- 查询计划效果时必须提供店铺标识、计划标识和指标类型。
- 查询店铺效果时必须提供店铺标识、开始时间和结束时间；指定计划时还需提供计划标识列表。
- 查询单个工具说明时必须提供工具名称和执行上下文标识；只查询工具列表时只需提供执行上下文标识。

### 非必填信息

- 计划列表的计划名称、状态、类型和时间范围可选；分页参数必须按“查询数量限制”传入。
- 效果查询可补充归因类型、指标列表、时间粒度和趋势开关。
- 工具列表可补充输出格式；执行上下文标识用于确定可见范围。

## 使用案例

- 用户说“查营销画布计划列表”时，使用计划列表；用户明确给出计划标识后再查询单个计划的节点和连边。
- 用户说“看某个计划最近 7 天的触达和支付效果”时，补齐店铺标识、计划标识、指标类型和时间范围。
- 用户说“这个画布使用了哪些工具”时，读取工具元数据，不执行工具调用。
- 用户说“创建、发布、暂停或结束营销画布”时，说明本 skill 只支持计划和效果查询。

## 边界

- 从自然语言设计、创建、发布、暂停或结束营销画布计划不在本入口范围内。
- 工具调用不作为本入口的能力描述；若业务流程需要执行工具，由上层流程单独负责权限与确认。
- 优惠券、促销活动和积分商城使用 `youzan-marketing`。
- 不做营销策略、客户画像、个性化推荐、转化诊断或经营结论。