Shopify Pinterest 购物广告目录：修复 CSV 价格、库存与链接

Pinterest 购物广告目录中的价格、可售状态和网址应来自同一个真实商品变体。本文限定 Shopify 普通实物零售商，准备首次手动上传单市场、单币种的 Pinterest CSV 主数据源，处理表单校验失败后再检查摄取结果。规则核验于2026年10月4日；示例商品、库存、网址和 CSV 均为假设，未执行上传或投放。

如果商店已用 Pinterest 官方应用生成目录，不要另建这份手工源；若同一手工源已经存在，应向原源上传最新文件，不能再次新增。原源的更新入口不可见时，请数据源所有者或官方支持处理，本文不虚构通用更新按钮。托管 URL 源与应用源也不能套用这里的首次上传流程。数据源上传与更新说明

先把错误绑定到具体变体

准备账户所有者权限、已认领网站及目录所需条件；首次数据源须由账户所有者添加。示例销售地区为美国，内容为英语，币种 USD，均是假设输入，应替换为实际市场。数据源国家和语言选择后不能再修改，不能为了通过校验随便选择。目录条件、数据源地区与权限

假设 Shopify 有两个蓝色上衣变体：M 码售价24.99 USD、可售库存3件；L 码同价、可售库存0件。库存已跟踪，且不允许缺货继续销售；该前置条件仅用于这个普通现货示例，不代表所有商店的预售规则。变体编号222和223也是占位值。Shopify 库存跟踪条件

Pinterest price 使用数值与 ISO-4217 币种格式；availability 接受 in stock、out of stock、preorder；链接应直达对应商品，变体必须带 item_group_id。不要把 Shopify 导出文件未经字段转换就当 Pinterest feed。下方仅展示字段组织：域名、变体编号、商品描述和图片都是占位，必须替换为真实可访问商品及图片后才可校验、上传。目录字段要求

id,title,description,link,image_link,price,availability,item_group_id
TEE-BLUE-M,Blue cotton tee M,Example blue cotton tee size M,https://shop.example.com/products/cotton-tee?variant=222,https://shop.example.com/images/blue-m.jpg,24.99 USD,in stock,TEE-BLUE
TEE-BLUE-L,Blue cotton tee L,Example blue cotton tee size L,https://shop.example.com/products/cotton-tee?variant=223,https://shop.example.com/images/blue-l.jpg,24.99 USD,out of stock,TEE-BLUE

每个变体保留原来唯一的 id，两个变体共享父级 item_group_id；修格式时不换商品身份。打开实际 link，应选中相应变体并显示同一价格、图片和可售状态。Shopify 支持 ?variant=[variant-id] 深层链接，但主题也要正确响应选中变体；网址能打开却落到另一尺码，仍需修正链接或主题。Shopify 变体链接说明

源字段正确时修映射，源字段错误时先保存商品

本例 Shopify 价格已经正确，$24.99 是导出格式问题：在 CSV 转换规则中保留数值，附上实际币种，重新生成文件。不要为了修目录格式，把后台正确的售价改成其他数字。库存同理：L 码为0件就保留缺货状态，不把它改成“有货”。

只有真实商品价格本身有误时，才进入 Shopify Products → 具体商品 → Variants → 具体变体，修改该变体的定价后点 Save，重新打开同一变体及商品页回读，再生成 CSV。不要误选整组变体而改到所有尺码；库存事实需要改正时交给库存维护人，不以广告资格倒推库存。Shopify 变体编辑步骤

在首次上传表单完成校验与上传

1. 用桌面登录 Pinterest 企业账户，从左上菜单进入 Manage business → Catalogs and product groups，点击 Add data source → Upload manually。先确认此前没有该商品集合的应用源或手工主源。
2. 填数据源名称，例如假设名称 US-English-Tees；国家选实际销售地区，语言对应文件内容，默认币种对应商品。在 Choose a file 选择已经替换全部占位资料的 CSV。
3. 打开 Test your data source，粘贴表头和两条真实样本行，点 Validate data source。若下方返回问题，读完整解释和建议，把错误绑定到 feed id，再回到文件或其转换规则修正。
4. 重新生成并选择修正后的文件，再验证样本。没有错误后返回数据源详情，点 Upload。只验证粘贴片段不能证明整个文件无误，完整上传后还要检查诊断结果。官方手动上传步骤

错误码表用于解释校验或后续摄取返回的问题，并不表示每个代码都会在本次表单中出现：

“警告”不保证商品继续发布：例如125虽为行级警告，官方仍写促销售价不符合要求的商品不会发布。本例没有促销字段，不添加虚假 sale_price 来绕过问题。始终以完整说明和商品实际状态判断。官方数据源错误码

上传后分别复核摄取与付费资格

从目录页面展开左侧目录，进入 Diagnostics，在 Data source 选择刚上传的源。检查 Ingestion issues，必要时点 Export details 留下错误清单；再检查 Distribution issues 中的付费资格。校验通过、成功摄取和适合购物广告是三种结果，不能互相替代。目录诊断入口与结果

按同一数据源、同一变体 id 留下修复前后文件、错误码和最近一次摄取结果。M 码应与真实价格及链接一致，L 码继续反映缺货；未改动的另一行也要回读。若商品事实已正确而仍出现技术错误1008，按错误表建议等待24小时，仍异常则带记录联系支持，不反复篡改售价。手工源不能依赖托管源的每日摄取；文件经修正后须再次上传原源。若被商家规则或付费分发规则拒绝，转入对应资格处理，不把字段校验成功写成广告获批。技术错误处理、手工源修正后的处理

真实商品变化后，手工源应上传最新文件到原数据源。官方还规定：主源30天未更新会失去自然分发，90天未更新会失去广告分发；这不能理解为价格、库存变化可以等30天再改。手工主源更新限制

本文没有承诺应用源、托管源或所有账户能即时重新摄取，也没有将缺货状态视为所有既有广告自动停止的证明。完成的是一份可追溯的目录纠错记录，投放设置仍需另行审核。