商品推荐位想做「买了又买」，接口怎么用

接口是现成的，但返回空多数是「店铺数据不足」或「intent 传错」。推荐依赖销售与浏览数据，新店或商品少的时候本来就没有可推的。

1处理顺序

1. 用 productRecommendations(productId: $id, intent: RELATED)，intent 四选一：RELATED（相似）、COMPLEMENTARY（搭配）、UPSELL、COMPLEMENTARY 用于购物车场景。
2. scope 要够：Storefront API 需要 unauthenticated_read_product_recommendations，Admin API 用 read_products 查不到推荐。
3. 返回空的三类原因：商品是草稿或未发布到该渠道、店铺近 30 天无足够订单、商品属于同一 collection 但无关联行为。
4. 主题站直接用 recommendations 对象（recommendations.products），它内部就是这套接口，不用自己写 GraphQL。
5. 兜底：数据不足时按 collection 或标签取同类商品，用 metafield 手工配置「搭配商品」列表，比空着好。

缓存要按商品 + 市场分别存，推荐结果会随市场和库存变化。Headless 站点如果把推荐结果缓存在 CDN 上，注意剔除已下架商品。