用途:对比不同折扣码的表现,按兑换次数与带来的收入进行并排比较,适合在没有专用分析应用时做促销活动 A/B 测试。技能为只读,不执行任何数据修改。
主要能力:对每个折扣码查询折扣元数据(title、code、asyncUsageCount、status、起止时间等),并按折扣码分页查询指定日期范围内的订单,聚合订单数、收入总额、平均客单价与每次使用收入,最后输出对比表;human 格式内联展示,json 格式给出结构化结果,含每码一条记录。
必要用法:需先完成 Shopify CLI 认证:shopify auth login --store <domain>;API 作用域为 read_discounts、read_orders。主要参数:store(必填)、discount_codes(必填,至少 2 个码)、date_range_start 与 date_range_end(必填,ISO 8601)、format(human 或 json,默认 human)、dry_run(默认 false)。查询使用 GraphQL 操作 discountNodes 与 OrdersByDiscountCode,API 版本 2025-01。
适用场景:活动周期结束时比较各折扣策略,决定复投哪一个;比较使用量差异较大的折扣码时,可参考“每次使用收入”这一信号。
限制:使用量高时订单查询需分页,日期范围越大 API 调用越多,可能触发 429 限流,需等待重试或缩小范围;折扣码不存在或被删除、日期范围内无订单、折扣码少于 2 个时会报错或无法比较。asyncUsageCount 为折扣对象的生命周期使用次数,orders_in_range 才是所选日期窗口内实际兑换的订单;若 asyncUsageCount 为 0,应确认该码在日期范围内是否生效并在结账时正确应用。其他未在资料中说明的细节暂未提供。