把店铺搬过来的那把 Shopify 密钥

这把密钥是什么，为什么要你自己创建

Shopify 不会发放一个让别的服务读取你店铺的密码。你要做的是在自己店铺里创建一个小应用，精确勾选它可以读取哪些内容，Shopify 随后把一个令牌交给这个应用。你把令牌粘贴到 Omniterra，我们就通过它读取你的商品目录。

由此带来两件事，都对你有利：

• 我们能看到什么由你决定。 我们只拿到你勾选的权限。我们申请的是读取权限，没有任何会写入你 Shopify 店铺的内容。
• 你随时可以切断。 在 Shopify 里删除该应用，令牌立刻失效，不会给任何人发邮件。

整个过程中你的 Shopify 店铺照常运转。我们所做的一切都不会改动它。

第 1 步 —— 打开应用设置

在 Shopify 后台进入 设置 → 应用和销售渠道 → 开发应用。

如果看到 允许开发自定义应用 的按钮，点它。Shopify 每个店铺只问一次，而且只有店主能确认。

第 2 步 —— 创建应用

点 创建应用，起一个你以后认得出的名字——「Omniterra 迁移」就够用了——然后确认。

此时应用是空的，还读不到任何东西。

第 3 步 —— 勾选权限

打开 配置 标签页，再进入 Admin API 集成 → 编辑。

把你想带走的内容都勾上读取权限：

点 保存。

Omniterra 在导入页面上也会把这份清单原样列出、方便复制；如果连接回来发现不全，还会告诉你还缺哪几项。

第 4 步 —— 安装应用并复制令牌

进入 API 凭据 标签页，点 安装应用。

Shopify 现在会显示 Admin API 访问令牌，一串以 `shpat_` 开头的字符。把它复制下来。

这一段请仔细读：Shopify 只显示这个令牌一次。 如果你没复制就关掉页面，就再也看不到了——只能卸载应用再重新安装，才能拿到新的。东西不会丢，但那是让人恼火的五分钟。

第 5 步 —— 粘贴到 Omniterra

在 Omniterra 后台进入 商品 → 导入 / 导出，选择 Shopify，填写你的店铺地址（`my-store.myshopify.com`），粘贴令牌。

点 连接。我们会读取你的目录，并在写入任何内容之前先把结果摆给你看：多少商品、客户、订单、页面。你不点头，什么都不会动。

如果提示权限不足

这一条常常出人意料，所以值得先知道：Shopify 报告的是安装应用时授予的权限，而不是配置里现在写的内容。 如果你在安装之后又勾选了更多项目，应用仍然保持原先那套较窄的权限。

办法是重新安装：配置 → Admin API 集成 → 编辑，勾上缺的项，保存，然后 API 凭据 → 重新安装应用。令牌保持不变。

如果你的应用是在 Dev Dashboard 里建的

有些店铺的应用建在 `dev.shopify.com`，而不是店铺后台里。道理相同，只是多两个细节：

1. 在应用配置里修改 `access_scopes`，点 保存。
2. 点 发布。不发布的话，你的修改只是一个未发布的版本，店铺永远看不到。
3. 在店铺上重新安装该应用，新权限才会真正生效。

哪些能搬，哪些搬不了

商品连同变体、图片、分类、客户、订单、折扣、页面、博客文章、菜单、重定向和文件，全都能搬过来。

有些东西搬不了，我们在开始之前就说清楚，而不是事后才讲：礼品卡码（Shopify 从不对外提供）、已保存的银行卡信息（它们属于你的支付服务商，而不是你的店铺），以及已安装的第三方应用及其自己留存的数据。

如果迁入的商品比预期少

几乎所有情况都出于三个原因，而且没有一个意味着导入失败了。

草稿和已归档的商品默认留在原处。 Shopify 把它们排除在活跃目录之外，我们也一样。如果您需要，请在导入前先在 Shopify 中发布，或者先迁过来，之后在这里设为草稿。

没有价格或没有规格的商品会被跳过，因为这样无法销售。它们会按名称出现在最后的报告里，让您清楚看到是哪些、为什么。

安装之后才勾选的权限要等到重新安装应用才生效，这和前面是同一个坑。重新安装后，在导入页面点“重新检查”——我们会再读一次您的目录，不会动已经迁过来的内容。

需要的话，导入可以跑两次。商品按其 Shopify 标识匹配，所以第二次会更新已有的内容，而不会产生重复。

需要多久

几百件商品的目录通常两分钟左右就完成。大店铺分批进行，你可以离开页面——导入会继续，回来时能看到进度。