shopify-admin-cross-sell-opportunity-finder

用途

本技能用于发现几乎总是被单独购买（单件订单）的商品，并基于品类亲和度、价格互补性和客户重叠度，识别潜在的交叉销售搭档。与“经常一起购买”（frequently-bought-together）功能寻找已有模式不同，本技能寻找的是缺失的模式——那些本应被交叉销售但尚未实现的商品。

主要能力

查询指定回溯窗口内的订单，统计每个商品的总订单数、单独购买订单数与多件订单数。
计算单独购买率（solo rate = solo_orders / total_orders × 100），并将单独购买率不低于阈值的商品标记为“交叉销售候选”。
计算商品单独购买时与多件购买时的平均订单价值。
对候选商品进行商品信息补充查询，获取商品类型、供应商、价格、系列等信息用于亲和度匹配。
为每个单独购买商品推荐交叉销售搭档，依据包括：同供应商不同商品类型（互补）、同商品类型不同价格档位（好-更好-最佳）、同一客户群在分开订单中购买的商品、价格互补性（搭档价格应为主商品价格的 20%–50%，即冲动加购区间）。
输出人类可读报告或 JSON，并生成 CSV 文件。

使用方式

前置条件：

已认证的 Shopify CLI 会话：shopify store auth --store <domain> --scopes read_orders,read_products
API 权限范围：read_orders、read_products

参数：

参数	类型	必填	默认值	说明
store	string	是	—	店铺域名
days_back	integer	否	180	订单回溯窗口
solo_threshold	float	否	70	商品被单独购买订单占比达到该百分比即标记为“单独”
min_orders	integer	否	10	商品被分析所需的最低订单数
format	string	否	human	输出格式：human 或 json

工作流程：

订单查询：使用查询条件 created_at:>='<NOW - days_back days>'，每页 250 条，选取 lineItems 中的 product（id、title、productType、vendor）、quantity、originalTotalSet，并使用分页游标。
对每个商品计算：包含该商品的总订单数、单独订单（该商品是唯一商品）与多件订单、单独购买率、单独购买与多件购买时的平均订单价值，并将单独购买率不低于 solo_threshold 的商品标记为交叉销售候选。
商品查询（信息补充）：对单独购买商品及潜在搭档的商品 ID 查询商品类型、供应商、价格、系列，用于亲和度匹配。
为每个单独购买商品推荐交叉销售搭档，依据同供应商不同商品类型、同商品类型不同价格档位、同一客户群分开订单购买、价格互补性（搭档价格为主商品价格的 20%–50%）。

GraphQL 操作（已针对 api_version 2025-01 验证）：

# orders:query
query OrdersForCrossSell($query: String!, $after: String) {
  orders(first: 250, after: $after, query: $query) {
    edges {
      node {
        id
        customer { id }
        lineItems(first: 50) {
          edges {
            node {
              product { id title productType vendor }
              quantity
              originalTotalSet { shopMoney { amount currencyCode } }
            }
          }
        }
      }
    }
    pageInfo { hasNextPage endCursor }
  }
}

# products:query
query ProductEnrichment($ids: [ID!]!) {
  nodes(ids: $ids) {
    ... on Product {
      id
      title
      productType
      vendor
      priceRangeV2 {
        minVariantPrice { amount currencyCode }
      }
      totalInventory
      status
    }
  }
}

会话跟踪：技能要求在开始、每步之后和完成时输出指定格式的状态信息（开始横幅、步骤进度、完成报告）。

输出格式：生成 CSV 文件 cross_sell_opportunities_<YYYY-MM-DD>.csv，列包括：product_id、product_title、total_orders、solo_orders、solo_rate、suggested_partner_id、suggested_partner_title、affinity_type、potential_aov_lift。

适用场景

希望提升平均订单价值（AOV）的 Shopify 店铺。
需要发现尚未被利用的交叉销售机会，而非仅查看已有购买组合。
可将建议的搭配实现为“顾客还购买了”或购物车抽屉推荐。
可与 frequently-bought-together 交叉参考，对比哪些有效、哪些缺失。
可与 discount-ab-analysis 配合，测试“买 X，Y 享 15% 折扣”促销。

限制

只读技能，不执行任何写操作。
需要已认证的 Shopify CLI 会话及 read_orders、read_products 权限。
遇到 THROTTLED（API 速率限制）时，等待 2 秒并最多重试 3 次。
若所有订单均为多件订单，说明店铺自然交叉销售良好，报告为健康、无需操作。
若商品目录过小，可能无法形成有意义的配对，建议扩展目录。
最佳实践：单独购买率 80% 以上且订单量高的商品是最大的 AOV 机会。

技能介绍

用途

主要能力

使用方式

适用场景

限制