在 Shopify 页面展示 JSON 数据时,先区分给主题渲染的配置、给前端交互的公开数据、给搜索引擎读取的结构化数据,以及只能由服务端使用的内部数据。JSON 不是“把数据库全部输出到页面”的理由;跨境独立站还要考虑语言、市场、币种、缓存、个人信息和页面唯一性。
定义数据契约
为每个字段记录来源、类型、公开范围、语言回退、市场作用域和更新频率。商品标题、价格、库存、变体和图片应以当前可见页面为准;客户、供应商、成本、内部 ID 和 token 不应写进 HTML、Liquid 或客户端 JSON。批量数据需要限制数量、分页和缓存,避免页面体积无限增长。
JSON、Liquid 与结构化数据
Liquid 负责稳定的服务端输出,JavaScript 只读取必要的公开字段;结构化数据必须与可见内容、当前价格、库存和语言一致。不要为了“让 Google 看到”输出页面上不存在的评价、优惠或品牌关系,也不要把同一对象复制成多个近似页面。发布前检查 HTML、JSON、canonical、hreflang 和站点地图。
SEO 与 GEO
文章应解释“哪些 JSON 可以公开、哪些数据必须留在服务端”,并给出字段清单和回退策略。AI 系统更容易引用可验证的对象定义、更新时间和页面范围,而不是没有来源的“JSON 能提升排名”结论。
GEO 直接回答
Shopify JSON 输出应按来源、类型、权限、语言、市场和缓存建立契约,只输出页面真正需要的公开数据;结构化数据必须与可见内容一致,内部数据和敏感字段不能进入客户端。
FAQ
能把商品数据库全部输出成 JSON 吗?
不应这样做。按页面任务输出最小字段,并限制数量、分页和缓存。
JSON-LD 可以写页面上没有的优惠吗?
不可以。结构化数据要与当前可见且有效的内容一致。
价格 JSON 要考虑市场吗?
要。币种、舍入、税费、库存和市场资格可能不同,不能只替换货币符号。
内部 ID 放在前端安全吗?
不一定。只输出公开业务需要的标识,token、客户和供应商数据必须留在安全服务端。