常见问题

Smart Bulk Image Upload 是一款 Shopify 应用，可从 Google Drive 或 Dropbox 文件夹批量上传产品图片，并自动把每张图片关联到正确的产品和多属性。

您不必再把图片逐张拖进产品，只需用目录中已有的标识符（SKU、条形码、产品标题、元字段值或多属性 ID）为文件命名，选择文件夹，剩下的交给应用。它还会为每张图片写入 SEO 替代文本。

应用会读取每张图片的文件名，并与您所选的多属性标识符进行比对：SKU、条形码、产品标题、元字段值或多属性 ID。匹配时不区分大小写。

因此，AB-1234.jpg 会关联到 SKU 为 AB-1234 的多属性。标准匹配类型基于规则，结果可预期、可重复。如果文件名不统一，可选的 AI 匹配（测试版） 会像人一样读懂它们；在上传之前，您仍会逐一确认每个匹配结果。

1. 从 Shopify App Store 安装应用。
2. 在 设置 → 图片来源 中选择 Google Drive 或 Dropbox，然后在 创建上传 页面连接您的账户。
3. 选择存放图片的文件夹和匹配类型，然后点击 开始匹配。
4. 检查预览（此时店铺中尚未写入任何内容），然后点击 开始上传。

用一个小型测试文件夹进行首次运行只需几分钟。我们建议先从 10 到 20 张图片开始。

有。YouTube 上有完整的演示视频，应用内的“客服支持”页面也有同一个视频。

不需要。图片保留在您自己的 Google Drive 或 Dropbox 中。应用会读取您选择的文件夹，下载每张匹配的图片并上传到 Shopify。Drive 或 Dropbox 中的任何文件都不会被重命名、移动或删除。

两者都支持。您可以在设置中为每个店铺选择一个来源，并随时切换。有两点区别值得了解：

• Google Drive：只列出 Drive 识别为图片的文件，文件夹中的文档或 ZIP 文件会被忽略。预览会显示缩略图和像素数。
• Dropbox：会列出文件夹中的所有文件，请保持文件夹整洁。Dropbox 不提供缩略图和像素数信息。

默认只读取所选文件夹。如有需要，可应您的要求为店铺开启子文件夹扫描。

用标识符为每个文件命名，可选择在后面加上下划线和表示图片顺序的数字：<标识符>_<顺序>.<扩展名>。

文件名	匹配到	位置
AB-1234.jpg	ab-1234	第 1 张
AB-1234_1.jpg	ab-1234	第 2 张
AB-1234_2.png	ab-1234	第 3 张
7891234567890.jpg	7891234567890	第 1 张

如果最后一个下划线后面是数字，它表示图片的位置；否则仍属于标识符的一部分。不区分大小写。完整规则请参阅 命名指南。

最常见的错误是末尾空格、缺少扩展名和非数字后缀：

• 末尾空格：AB-1234 .jpg 无法匹配，因为空格成了标识符的一部分。
• 没有扩展名：没有扩展名的文件永远无法匹配。
• 非数字后缀：AB-1234_a.jpg 查找的是标识符 ab-1234_a，而不是 ab-1234。
• 规则混用：同一文件夹中有的文件用 _1，有的用 -1。
• 同一文件夹中出现重名文件。

这些问题都会在上传之前出现在预览的“未匹配图片”列表中，所以出错时只需改个文件名，而不必事后清理。

可以。加上数字后缀，应用就会按该顺序排列：AB-1234_0.jpg → 第 1 张，AB-1234_1.jpg → 第 2 张，AB-1234_2.jpg → 第 3 张。

只有相对顺序才有意义，因此 _1, _3, _7 与 _1, _2, _3 的结果相同。没有后缀的文件视为第 1 张，所以不要对同一个产品同时使用 AB-1234.jpg 和 AB-1234_0.jpg。

有四种好办法：

• 按其他字段匹配：条形码、产品标题或多属性 ID 可能比 SKU 更合适。
• 使用元字段：把图片编码（通常是 ERP 或供应商编码）写入产品或多属性的元字段，再按它匹配。
• 使用“包含”选项：如果文件名中包含 SKU 和其他文字，例如 nikon-d750-AB1234-front.jpg，请选择“图片名称包含 SKU 时匹配”。
• 使用 AI 匹配（测试版）：适用于分隔符不同、带有多余词语或颜色名称的文件名。

我们还可以在匹配前对您店铺的标识符应用清理规则，例如忽略 SKU 中第一个连字符之后的所有内容。

您可以按 SKU、条形码、产品标题、元字段或多属性 ID 匹配：

• SKU：默认选项，也是最稳妥的选择。
• 条形码（EAN/UPC/GTIN）：非常可靠，因为条形码通常唯一且稳定。
• 产品标题：适用于没有 SKU 或条形码的目录。
• 元字段：您指定的任意产品或多属性元字段。
• 多属性 ID：Shopify 中的数字 ID。完全无歧义，非常适合修正。

它们决定文件名与标识符需要匹配到什么程度：

选项	匹配条件	适用场景
精确	文件名与标识符完全相同	文件名与 SKU 或条形码完全一致
图片名称包含标识符	标识符出现在文件名中	文件名带有额外文字：photo-AB1234-front.jpg
标识符包含图片名称	文件名出现在标识符中	一张照片用于多个多属性：AB1234.jpg → AB1234-S、AB1234-M、AB1234-L

使用“图片名称包含标识符”时，最长的匹配优先，因此较短的 SKU 不会抢走较长 SKU 的图片。使用“标识符包含图片名称”时，所有匹配都会生效，请在上传前于预览中核对数量。

AI 匹配（测试版）是一种可选的匹配类型，它会像人一样读懂每个文件名，因此分隔符不同、多了几个词、带有颜色名称或图片编号都不会影响匹配。

您仍需选择字段（SKU、条形码、标题或元字段），每个 AI 匹配都会在预览中显示置信度，方便您在上传前确认。免费套餐的店铺每天最多可用 AI 判断 1,000 张图片；付费套餐不设上限。

可以。“标识符包含图片名称”选项正是为此设计的：一张带有基础编码的照片会关联到在此编码基础上扩展的每个尺码或颜色。

如果多个多属性共用同一个标识符（相同的 SKU 或相同的产品标题），为避免意外重复，应用默认只保留第一个。如有需要，我们可以为您的店铺开启多属性和多产品匹配。

常见原因按可能性排序为：标识符重复、标识符为空、命名错误和数据过期：

1. 标识符重复：两个多属性共用同一个 SKU 或标题。默认只有第一个会获得图片。
2. 标识符为空：没有 SKU（或条形码、元字段值）的多属性会被跳过。
3. 命名错误：末尾空格、缺少扩展名或输入错误。
4. 数据过期：匹配后您又编辑了产品。请在预览中点击 清除缓存 并重新匹配。

每张未匹配的图片都会在预览中列出，并显示应用查找的标识符，您还可以将列表导出为 CSV。

默认情况下，在售、草稿和已归档的产品都会包含在内。我们可以为您的店铺排除已归档的产品，也可以把匹配范围限定在特定的产品系列或供应商。

可以。匹配过程完全是只读的：应用会预览每个匹配（缩略图、文件名、位置、将关联的多属性、匹配到的标识符以及确切的替代文本），并列出所有未匹配的图片。

在您点击 开始上传 之前，店铺中不会写入任何内容，所以在调整命名时可以随意多次运行匹配。

可以。在预览中，您可以：

• 取消匹配：一键移除任意匹配。
• 手动匹配：为未匹配的图片选择产品。
• 编辑多属性：从预览中打开产品，之后应用会自动重新匹配。
• 导出：将完整的未匹配图片列表下载为 CSV。

每张匹配的图片都会上传到产品的媒体库，每个多属性的第一张图片还会被设为该多属性的图片。

• 其余图片保留在产品图库中。
• 只有默认多属性的产品会在产品层级获得图片。
• 如果您希望使用统一的图库而不设置多属性图片，请在设置中开启 不将图片关联到多属性。

会，每张上传的图片都会设置。默认的替代文本是多属性标题，即产品标题加上选项值（例如 基础款 T 恤 / 蓝色 / M）；只有一个多属性的产品则使用产品标题。上传前您可以在预览中看到确切内容。

还可以为您的店铺配置其他格式（仅选项值、元字段加标题、自定义后缀、字符替换）。

每次上传时由您选择：

• 不替换现有图片（测试时推荐）：新图片会追加在产品现有图片之后，现有内容不受任何影响。
• 替换现有图片：在上传某个产品的第一张新图片之前，会删除该产品的所有现有图片。没有匹配到任何图片的产品不受影响。

在替换模式下，您还可以开启 不从“文件”中删除被替换的图片，旧图片会与产品解除关联，但文件仍保留在 内容 → 文件 中。

不使用替换模式时，再次处理同一个文件夹会添加重复的图片。重新处理文件夹时，请使用替换模式，或取消不需要的匹配。

自动重试则不同：如果任务以错误结束，应用只会重试失败的图片，绝不会重新上传已成功的图片。

可以。任务页面会显示实时进度百分比、已上传/总数计数，以及逐张图片的日志，其中包含每个多属性的链接和每次失败的明确原因。任务完成后，同样的日志会发送到您的邮箱。

您可以关闭浏览器：任务在后台运行，重启后会从中断处继续。

支持 JPG、JPEG、PNG、WEBP 和 GIF。为获得最佳效果，建议使用 JPG 或 WEBP，长边 2048 到 4096 像素，sRGB，小于 5 MB。Shopify 本身会重新编码图片并按设备提供合适的尺寸。

Shopify 将产品图片限制为 20 MB 和 2000 万像素；超过限制的文件会由应用自动缩小并重新编码，只有在仍然无法满足时才会报错。超限文件会在上传前于预览中标出。

此外，Shopify 每个产品最多允许 250 张图片。

单次可处理数万张图片。应用专为大型目录设计：通过一次批量操作加载整个目录，并行下载和上传，重启后继续执行。已有商家用它迁移了 4 万到 6 万个 SKU 的目录。

Shopify 会限制店铺中文件的变更速度，因此非常大的批次会在数小时内稳步完成，而不是几分钟。应用会自动放慢速度并重试，您无需守着。

匹配结果的有效期为两小时。超过两小时后，请在上传前点击 重新匹配。重命名文件后请使用 重新匹配，在 Shopify 中编辑 SKU、条形码、标题或元字段后请使用 清除缓存。

25 张图片以内免费；无限上传套餐根据您的 Shopify 套餐，每月 69、99 或 149 美元。

套餐	价格	上传数量
Free	0 美元	累计 25 张
Premium（Shopify Basic、Grow 及以下）	每月 69 美元	无限
Premium PRO（Shopify Advanced）	每月 99 美元	无限
Enterprise（Shopify Plus）	每月 149 美元	无限

费用通过 Shopify 收取，会显示在您常规的 Shopify 账单中。

免费套餐包含全部功能，累计可上传 25 张图片（不是每个任务 25 张）。匹配不限次数且免费，您可以在付费前用整个目录测试命名方式。达到上限后，任务会停止并显示“Free upload limit reached”。

在应用内降级到较低的套餐，或直接卸载应用。两种方式都会自动取消订阅。已上传的图片会原样保留在您的店铺中。

付费套餐与您的 Shopify 套餐挂钩，这样规模较小的店铺可以用更低的价格享受同样的无限上传。所有付费套餐的功能相同：无限上传、设置指导、上传队列优先处理和为店铺定制的匹配方式。

应用需要 Shopify 中产品的读写权限和文件的写入权限，以及 Google Drive 或 Dropbox 的只读权限。

它绝不会在您的云存储中写入、重命名或删除任何内容。您可以随时断开云账户的连接，卸载应用后，应用对店铺的访问权限也会被移除。

安全。所有数据都通过 TLS 1.2+ 传输，并在存储时加密。Google Drive 和 Dropbox 的令牌仅在连接存在期间保存；断开连接或卸载应用后，令牌会连同您的店铺数据一起立即被撤销并删除。

图片只会为了直接传给 Shopify 而下载；我们不会保留您媒体库的副本。您的数据绝不会与第三方共享，Drive 访问已通过 Google 的 CASA 安全评估。请参阅我们的 隐私政策。

可以。我们可以为您的店铺记录一次匹配的完整追踪，准确告诉您哪些标识符被索引、哪些发生了冲突、每张图片匹配到了什么。请 联系我们，并提供店铺域名、文件夹名称、匹配类型、大致运行时间，以及两三个示例文件名。

通常可以。我们可以为每个店铺开启的选项包括：扫描子文件夹、多属性和多产品匹配、一张图片关联多个多属性、仅替换匹配到的多属性的图片、排除已归档产品、按产品系列或供应商筛选、标识符清理规则、替代文本格式，以及针对带重音字符标题的 Unicode 规范化。

如果您的目录有不在此列表中的特殊情况，请告诉我们。这些选项大多最初都来自商家的需求。

请使用应用内“客服支持”页面上的在线客服，或发送邮件至 hello@craftshift.com。我们的团队位于欧洲，会回复每一条消息。