Youzan Marketing

---
name: youzan-marketing
version: 1.1.37
description: "优惠券、促销活动、互动活动和积分商城原始数据查询；不提供优惠券、活动、积分商城或用户持券状态的远端数据变更能力，不做营销策略、效果研判、画像或推荐。"
---

# 营销活动

使用本 skill 前，确认当前授权范围、店铺上下文和金额单位。营销画布计划和工具元数据使用 `youzan-ma`，订单交易事实使用 `youzan-order`。

## 查询数量限制

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

## 支持能力

- 查询优惠券和优惠码活动模板，包括名称、类型、面额、门槛、库存、有效期、状态和领取记录。
- 查询客户持有的卡券或优惠码实例，并按客户和活动筛选。
- 查询限时折扣、拼团、满减送、赠品、包邮和秒杀等促销活动的列表或详情。
- 查询抽奖、签到等互动活动的配置、参与记录和统计原始数据。
- 查询积分商城应用状态、积分兑换记录以及积分商品关联的源商品、卡券或权益卡信息。
- 按用户意图区分活动模板、客户持券实例、促销活动和积分商城商品，避免混用同名标识。
- 按接口返回的金额单位将分、元等原始字段准确展示，不直接给出经营结论。

## 字段提示

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

### 必填信息

- 查询单个优惠券、优惠码或促销活动时必须提供对应活动标识。
- 查询客户持券时必须提供客户手机号和券类型，限定到某个活动时还必须提供活动标识。
- 查询用户签到状态或明细时必须提供活动别名、客户手机号，以及明细查询所需的时间范围。
- 查询抽奖参与记录时必须提供活动标识；查询积分兑换记录时必须提供开始时间和结束时间。
- 查询积分商品关联信息时必须提供积分商品标识，或同时提供源资源标识和源资源类型。

### 非必填信息

- 列表查询的关键词、活动类型、状态、时间范围、店铺、商品、客户和手机号条件可选；分页参数必须按“查询数量限制”传入。
- 促销活动详情可按需补充渠道、商品范围或展示字段筛选。
- 互动活动统计可补充活动周期、用户标识、参与状态和统计维度。

## 使用案例

- 用户说“查正在生效的满减送活动”时，按活动类型、状态和有效期查询促销活动；不要把优惠券模板当作促销活动。
- 用户说“查某客户手里的优惠券”时，先确认客户手机号和券类型，再按客户查询持券记录。
- 用户说“查签到活动整体数据”时使用整体统计能力；用户问某个历史周期时再使用分期统计能力。
- 用户说“创建优惠券、发券、核销、停用活动或给客户加积分”时，说明本 skill 只支持读取。

## 边界

- 活动创建、编辑、启停、失效、发券、作废持券、积分商城开关调整和其他远端数据变更不在本入口范围内。
- 营销画布使用 `youzan-ma`。
- 下单算价、优惠核销和订单退款使用 `youzan-order`。
- 不根据活动原始数据推导投入产出比、转化趋势、用户画像或推荐策略。