从 API 版本 2026-07 开始,销售渠道应用可以使用 订单归因定义 来识别创建订单的来源。
当您的销售渠道应用需要比应用或渠道本身更具体的归因时,订单归因定义非常有用。例如,您可以将订单归因于市场、地区、账户或展示面。
仅需默认应用或渠道归因的应用无需进行任何更改。
更新内容
销售渠道应用现在可以:
- 在创建渠道连接时创建基于渠道的归因定义。
- 使用 order_attribution_config 扩展定义静态归因来源。
- 通过 orderAttributionDefinitionUpsert 突变(mutation)创建或更新归因定义。
- 通过 orderAttributionDefinitions 查询(query)查询归因定义。
- 使用 GraphQL Admin API 删除归因定义。
- 在使用 orderCreate 创建订单时传入归因定义的句柄(handle)。
- 在使用 Storefront API cartCreate 突变创建购物车或使用 购物车永久链接 时,通过 source_name 传入归因定义的句柄。
- 使用 Order.attribution 读取已解析的归因详情。
要使用订单归因定义,您的应用必须是具有 channel_config 扩展的销售渠道应用。
您需要执行的操作
如果您的应用需要比应用级或渠道级归因更具体的归因,请创建订单归因定义,并在创建购物车或订单时在 sourceName 中传入该定义 handle。
如果 sourceName 未匹配到已批准的订单归因定义,Shopify 将回退至仅应用级归因。
请使用 Order.attribution 进行新的归因读取。Order.channelInformation 仍可用,但已弃用。

