接入之前
需要准备什么。
所有信息都在平台内创建，不需要开发介入，也不需要装插件。
店铺域名
your-store.myshopify.com
Admin API 的主机地址。自定义店铺域名不能替代它。
Client ID
Shopify 后台的自定义应用
设置 → 应用 → 开发应用。该应用需要内容的 Admin API 访问权限。
Client secret
以密钥形式保存
与 Client ID 一起用于申请 24 小时有效的 access token，不会被写进任何模板。
目标博客
博客名称或 handle
Rankow 创建文章的目标博客。未指定时使用店铺的主博客。
接入
先连接，再用一篇草稿验证。
测试草稿不是可选项。它用来确认字段真的落到位，再批准完整周期。
- 01
创建自定义应用
在 Shopify 后台创建自定义应用，开启内容的 Admin API 访问权限，并安装到店铺。复制 Client ID 与 Client secret。
- 02
填写连接信息
填写店铺域名与两项凭据。Rankow 通过 client credentials 授权获取 access token，并缓存 24 小时。
- 03
发布一篇测试草稿
先发一篇草稿到目标博客，检查正文、SEO 标题与描述、JSON-LD 和封面图，再批准整个周期。
- 04
审核并发布
通过审核的文章经 Admin API 发布。每次写入都是幂等的，改动之前先存快照。
发布之后
这个渠道实际会收到什么。
下面每一行都对应引擎读取的渠道能力矩阵，不是渠道拿不到的字段。
SEO 字段
包含SEO 标题、meta description 与 handle 与正文一起写入文章的 metafields。
JSON-LD
包含JSON-LD 脚本随文章一并写入，无需修改主题。
图片
包含封面以 WebP 上传到 Shopify 媒体库。正文配图转为 WebP 后经 CDN 分发。
内链
包含链接按真实文章 handle 校正。无法确认的目标会被丢弃，而不是作为死链发出去。
一条限制，直接说明
Shopify 不会注入相关文章区块。引擎支持读回原文，这也是已发布文章能进入刷新与优化的前提。
常见问题
接入之前。
不需要。发布通过 Admin API 写入文章与 metafields，不会修改主题文件。
文章仍然会发布。配图、JSON-LD、封面与内链的失败会被记录，而不会中止整次运行，正文不会丢失。
可以。Shopify 支持读回原文，已发布文章从第 14 天起可刷新（低于 3,000 字的薄文为 7 天），修改后进入 90 天冷却。