如何按变体追踪 Shopify 产品库存情况
Senior Web Scraping Engineer
摘要：
- Shopify 商品可用性因变体而异。 一个商品整体上可以可购买，但某个尺码或颜色却不可用。
- “变体不可用”和“抓取失败”是不同的事件。 保留未知的观测结果，不要据此发出虚假的库存变更信号。
- 店面可售性是一个“报价状态”的观测结果。 库存数量和履约细节需要分别来自已授权的数据源。
- 变体 ID 与市场构成可用历史记录的核心。 保留选定的选项用于展示，并保留变体 ID 用于关联（join）。
介绍
一件蓝色夹克，小号有货，大号售罄。两个尺码共用同一商品页面。如果监控只读取商品级别的可用性标记，就会把这件夹克报告为“有货”，却遗漏买家真正关心的状态。
在每次观测中同时收集变体 ID 和市场信息。当标签、默认选项或店面语言区域发生变化时，这些字段可以为你提供稳定的对比基准。
每个变体和市场一行记录
对于每个已批准的商品，解析其变体，并在选择的市场中捕获店面的“可售性”信号。既要保留原始观测结果，也要保留规范化后的状态。告警任务只能比较同一商店、同一市场、同一变体的观测结果。
从店面读取变体 ID
变体标识应来自商店在店面公开的、有文档说明的表示方式。Shopify 的 Ajax Product API 参考 文档说明了一个支持本地化的商品路由，并展示了包含 ID 和可用性字段的变体对象。使用商店已文档化的访问路径，并将失败的响应视为“未知”。
在店面公开了有文档说明的商品记录时，用它来枚举变体。当选项是动态渲染时，可以使用一个适用于 JavaScript 店面的浏览器来观测可见的选择。在扩展市场列表前，先将覆盖计划与 Scrapeless 定价进行对比。
跟踪商店、商品 handle 或稳定的商品标识符、变体 ID 以及选定的选项值。在跨系统传递记录时，将标识符保留为字符串，以应对不同系统对大数值 ID 的处理差异。规范化展示标签以提升可读性，同时保留来源中的选项值以供审查。
ProductGroup 词汇将变体建模为商品组的成员。在数据集中也采用同样的区分方式，这样商品级别的观测记录就不能替代具体变体的记录。
在读取可用性之前先确认选项选择
一次变体观测描述的是在被观测上下文中的店面可售性。如果文档化的数据接口返回了明确的可用性标记，就连同选定市场一并记录下来。如果是由渲染后的页面提供证据，则通过常规选项选择该变体，并在读取购买控件之前确认该选择已经生效。
预购（preorder）依然可能是可购买的。将明确的预购和缺货预订（backorder）措辞保存在单独字段中。Offer 词汇将可用性与报价关联，这有助于解释为什么某个变体或某个市场会与其他情况不同。当运送或自提信息很重要时，单独存储相关观测结果。
使用 Scrapeless 开始你的抓取工作
使用 Scrapeless 为你的网页抓取和自动化流程加速！
立即注册可获得 $5 免费额度 —— 无需信用卡。现在就在 Scrapeless 控制面板领取你的免费额度。
将“未知的抓取结果”排除在库存历史之外
可用性历史既需要来源观测记录，也需要对其的解释。一条可用记录应包含商店、市场、变体 ID、选定选项、观测时间、来源界面以及抓取状态。当措辞能区分普通可用性与预购时，再附加上渲染出的购买文案。
| 观测结果 | 规范化结果 |
|---|---|
| 明确的正向变体标记 | 在观测情境下可购买 |
| 明确的负向变体标记 | 在观测情境下不可用 |
| 变体页面提供预购选项 | 可购买，但附带预购措辞 |
| 变体解析失败或抓取中途终止 | 未知 |
| 在一份完整的商品记录中缺失该变体 | 在该记录中缺失，待审核 |
| 如果在一次运行中大号夹克的变体始终未能解析，则写入一次“未知”观测。后续出现的显式“不可用”标记是可用证据。将这两条记录分开，可以防止主题问题被误认为库存变更。 |
与上一次有效观测进行比较
补货提醒应比较同一商店、同一市场、同一变体的有效观测。如果中间存在采集空档，需保留状态可能发生变化的时间窗口。其间出现的“未知”应在采集日志中保持可见。
在某些主题中，买家选择尺码后购买按钮会发生变化，此时可以使用用于页面检查的浏览器自动化来复现普通选择流程。在读取按钮前等待变体标记发生变化。否则，任务可能会把默认尺码的可用性附着到当前所选尺码上。
保留选择器版本和原始源状态。Etsy 产品抽取工作流展示了将浏览器抓取与结构化规范化分离的相关实践。如果店面主题发生变化，在重新启用提醒之前先验证所选变体的证据。
结论
可用性提醒应标识出精确的变体、观测到它的市场，以及上一次可比状态。如果这些当中有任何一项尚未解析，则保留此次抓取用于调查，并保持库存历史不变。
准备好构建你的变体可用性监控了吗？
加入 Discord 或 Telegram 社区，与正在构建店面可用性工作流的开发者交流。在 Scrapeless 控制面板 创建账号开始使用。
常见问题
问：店面可用性是否能反映 Shopify 的精确库存？
店面可用性描述的是该变体在当前环境下是否可供购买。精确库存和分配情况需要使用经过授权的库存来源。
问：跟踪 Shopify 变体是否一定需要代理？
如果路由取决于地理位置，那么使用获准的区域路径会更有用。只针对单一市场的检查可以使用商店普通且已批准的访问路径。
问：页面出现访问挑战时，监控该怎么做？
将此次观测标记为“未知”，并确认已批准的采集路径。保留上一次有效的变体状态。
问：监控如何处理新的店面主题？
针对已知选择测试变体选择器和可用性断言。在可公开且被允许的地方，应优先采用已文档化的店面呈现方式。
问：调度器能在没有 AI 代理的情况下运行检查吗？
调度器加上确定性的变体键就足够了。为每个商店设置有界的请求预算，并保持覆盖范围，以便缺失变体仍然可以被解释。
问：可以在报告中使用其他商店的产品数据吗？
查看该商店的条款、许可和适用法律。将采集限制在被允许的范围内，当可重用范围不明确时，咨询法律顾问。
在Scrapeless，我们仅访问公开可用的数据，并严格遵循适用的法律、法规和网站隐私政策。本博客中的内容仅供演示之用，不涉及任何非法或侵权活动。我们对使用本博客或第三方链接中的信息不做任何保证，并免除所有责任。在进行任何抓取活动之前，请咨询您的法律顾问，并审查目标网站的服务条款或获取必要的许可。
