Shopify Catalog API 开放站外品牌搜索：10 月 27 日新增 sources 参数，AI 推荐位佣金 0.3% 起

一个 AI 购物助手给你推荐了一件冲锋衣，你点进去，落地页却是品牌自己的官网。在 2026 年 10 月 27 日之前，这条路在 Shopify 的目录接口里根本不存在。

加拿大渥太华时间对应的 10 月 27 日 10:00 UTC，Shopify（NYSE: SHOP）在官方开发者 changelog 挂出一条 beta 更新：Catalog API 的 search_catalog 方法新增 sources 参数，AI 应用可以在一次调用里同时拿到 Shopify 商户商品和「不使用 Shopify 建站的站外品牌」商品。同期开发者文档披露，Promoted Placements 进入邀请制 Developer Preview，基础佣金为归因购买金额的 0.3%（30 bps），商户若开通面向外部平台的 Shop Campaigns，可叠加商户出资的额外佣金，官方给出的示例总费率为 1.5%。

两件事放在一起看，方向很明确：Shopify 想把 Catalog 从「自家商户的商品库」，做成 AI 时代的通用商品索引层——不管这个品牌是不是它的客户。但同样要先把话说清楚：这两条目前分别处于 beta 与 Developer Preview 阶段，官方既没有给出 Promoted Placements 的正式发布时间，也没有承诺最终费率。

一、一个参数，三种取法

变化落在一个字段上，不新增接口。

官方 changelog 写得很直白：Catalog API beta 的 search_catalog 现在支持 sources 参数，用来控制返回哪些商品。省略 sources 或设成 ["shopify"]，只返回 Shopify 商户商品；设成 ["shopify","external"]，Shopify 商户商品与站外品牌商品一起返回；设成 ["external"]，则只返回不使用 Shopify 建站的品牌商品。

对已经在跑的调用来说，这是零成本的：官方明确说明，省略 sources 时结果仍然限于 Shopify 商户商品，现有 search_catalog 调用不需要任何改动。换句话说，这是一个「你要主动打开才生效」的开关，不是一次强制的行为变更。

两个配套方法则不同步。get_product 传入对应 ID 时可以返回外部商品，但 lookup_catalog 的支持在官方原文里是「coming later」，也就是尚未落地。

再往下挖一层，是开发者博客 Makro 对同一份文档的技术解读：每个 variant 现在都会带上 source 字段，应用因此可以据此打标、分组或过滤，不必再做一次查询来分辨来源；请求侧还有两个容易被忽略的约束——sources 需要 API 版本 2026-08-25 或 draft，且 API client 需要 Shopify 侧开启，否则字段会被忽略；当请求里带 catalog_id 时，该 saved catalog 配置的 sources 既是默认值也是上限，超出上限的取值会被丢弃，无法识别的取值会被忽略并在响应的 messages 数组里回报，而不是报错。

这些属于第三方对文档的技术转述，不等同于 changelog 原文，动手前最好自己在沙箱里验一遍。

二、native_checkout: false 这条硬边界

站外商品进来了，但结账这件事一步都没让。

每个外部商品固定返回 eligible.native_checkout: false。这意味着消费者无法在 Shopify 结账里买下它，只能跳到品牌自己的站点完成购买。相应地，外部商品返回的内容也被压缩到最小集合：一段描述、一张图片、一个价格，以及一个指向品牌官网商品页的链接。

beta 阶段还有两条硬限制。其一，外部商品的数据来自各品牌自己的官网，Shopify 未做核验，按 API 条款以「as is」提供。其二，外部商品只在消费者位于美国时才返回，其他国家的搜索依旧只返回 Shopify 商户商品。

所以这不是什么跨平台统一结账系统。官方 changelog 的措辞也很克制：它只是让你在同一个响应里看见更多东西。

问题也随之而来：搜索结果会变得「看起来更完整」，但转化路径并不在你手里。长尾词、替换配件、冷门品类这类原本返回条数稀薄的场景，补上站外商品之后体验会明显改观，代价是一次你无法控制的跳转，且没有任何 checkout 归因可拿。开发者如果不在前端做清晰的视觉区隔，站外点击很容易被混进转化报表，把 Shopify 商户的真实转化率算歪。

对大多数商户而言，这一节的正确结论是不用着急动。真正需要问的是那个问题：你用的搜索或推荐服务商，准不准备打开 sources，你能不能拒绝。

三、0.3% 这笔账怎么算

Promoted Placements 是这次更新的另一半，也是第一次把「AI 推荐位怎么赚钱」写成了可执行的规则。

官方开发者文档给的前提有两个：已有 Global Catalog 集成，以及能访问所在组织的 Dev Dashboard。机制上，开发者在一个 saved catalog 上开启 promoted placements，然后在 search_catalog 调用里通过 catalog.catalog_id 引用它；返回的推广 variant 会带一个 placement 对象，开发者据此识别，并让消费者走带归因参数的 variant url，成交后赚佣金。

一条容易被误读的规则是：加入计划本身不改变你现有的请求。只有在请求里带了「已开启 Earn commission 的 saved catalog 的 catalog_id」时，才会产生佣金。

费率部分，文档拆成四块讲。基础费率是归因购买金额的 0.3%（30 bps）；更高的费率来自商户——开了面向外部平台 Shop Campaigns 的商户，其 Catalog API 属于其中一个平台，Shopify 会把 campaign 设置折算成佣金叠加到基础费率上；每个推广 variant 在 placement.commission.percentage.value 里给出的是总费率，也就是基础费率加商户出资部分，官方响应示例里的数值是 1.5%；placement.type 的值恒为 affiliate，即使叠加了 Shop Campaigns 佣金也不变。

归因与结算同样写死了：采用 last non-direct click 方法，归因窗口 7 天；按开发者实测与媒体转述，URL 上会追加 shdid（开发者 ID）与 shclid（点击 ID）用于追踪，佣金在完成 KYC 后按月结算。

四、1.5% 这道加法，三道门槛

叠加佣金听起来诱人，但它不是普遍可得的。

第一道门槛是范围：Shop Campaigns 佣金只适用于处于 active campaign 中的商品，且限美国市场、以美元计价。第二道门槛是成交路径：只有当消费者在 Shop 内完成购买——Shop 移动应用或 shop.com——开发者才能拿到高于基础费率的部分。第三道门槛是身份：来自 Shopify 之外商户、用 gid://catalog/... 形式 ID 的商品不参与这一机制，响应里永远不会出现 placement 对象，因为它们本来就不在 Shopify 上销售。

还有一个反直觉但很重要的规则写在订单范围里：佣金覆盖的是归因订单内每一件「可通过 Global Catalog 购买」的符合条件商品，而不只是消费者点击的那一个 variant。同一笔订单里，不同商品可能适用不同费率，取决于该商品所属商户有没有通过 Shop Campaigns 出资。

同样的边界回到站外品牌身上：外部商品既不能走 Shopify 原生结账，也不参与这套佣金机制。官方措辞是「这些商品不在 Shopify 上销售，因此不属于该计划」。

另外据开发者实测转述，推广位并不是想塞就能塞的：结果有相关性门槛，不相关商品不会插入；佣金率由商户侧控制，前提是商品本身得先进入 catalog 搜索的候选集。这些属于第三方实测描述，尚未在官方文档里逐条确认。

五、预览期，别按终稿用

最该盯住的其实是官方自己的免责声明。

Promoted Placements 页面上反复出现同一段话：Developer Preview 期间访问受限、采取邀请制并需加入 waitlist，用组织 ID 报名后由 Shopify 分批接入；该能力是为收集开发者反馈而提前发布的，字段名、字段结构、行为均未定稿，可能变更；佣金费率是为 Developer Preview 设定的，在正式可用之前可能调整。

至于正式发布时间与最终费率，官方目前没有披露。

时间上还有一件要并行处理的事：据第三方开发者博客转述 Shopify 的 changelog，Global Catalog REST API 将于 2026 年 11 月 2 日停止服务，需要迁移到 UCP/MCP 体系。这条来自二手转述，动手前请以官方 changelog 原文为准。

放到更大的盘子里看，这两步都服务同一个判断。Shopify 官方口径称，UCP 是与 Google 共同开发的开放标准，已获得 Amazon、Meta、Microsoft、Salesforce、Stripe、Etsy、Target、Wayfair 等公司支持；公司还披露，由 Shopify Catalog 驱动的 AI 搜索转化率是抓取数据路线的 2 倍——这是公司自述数据，不是第三方验证结论。

把这些串起来，Shopify 想做的不是「多一个广告位」，而是让 AI 侧的每一次商品发现都从它的索引层出发，哪怕卖东西的人不是它的客户。站外品牌被纳入搜索，是补覆盖；0.3% 起的佣金，是给开发者一个参与的价码。

但 0.3% 这个数字，横向对比联盟营销的常见费率并不高，它能撬动多少开发者真正去建 AI 购物体验，还是个问号。而在此之前，还有一个更朴素的问题要先回答：当站外品牌的商品和自家商户的商品排在同一屏里，谁来决定它们的顺序？

六、参考资料

• Shopify 开发者 changelog：《Search brands that don't sell on Shopify in the Catalog API (beta)》（2026 年 10 月 27 日 10:00 UTC）
• Shopify 开发者文档：《Earn with promoted placements》（Developer Preview 版，含基础费率 30 bps、7 天归因窗口、订单范围等条款）
• Shopify 官方新闻：《Agentic commerce for every developer: The Spring '26 Edition》（UCP 与 Catalog API 定位）
• Makro（Shopify 更新解读站）：《Shopify Catalog API External Sources in Beta》（sources 参数技术细节解读）