Visora
注册
返回博客

· Visora

ShopifySchemaGEO

Shopify 添加 JSON-LD 结构化数据完整指南:跨境店铺实操步骤

JSON-LD(JavaScript Object Notation for Linked Data)是大语言模型与 AI 搜索引擎从产品页面提取可验证事实所使用的结构化数据格式。没有 JSON-LD,你的店铺对 ChatGPT Search、Perplexity 和 Google AI 概览内部的引用管道就是不可见的——无论产品图片或文案多好都无济于事。

对于 Shopify 店主来说,添加 JSON-LD 比其他平台更具系统性,因为 Shopify 的 Liquid 模板系统控制着每个页面的渲染内容。好消息是:在大多数主题中,你只需修改三个文件即可获得完整的 Schema 覆盖。

JSON-LD 为你的店铺做什么

当 AI 搜索引擎评估产品页面时,它会寻找机器可读的事实:价格、货币、库存、品牌、配送详情和产品标识符。JSON-LD 以检索增强生成(RAG)系统能够直接提取和引用的方式呈现这些事实。

没有 JSON-LD 的页面迫使 AI 从散文中猜测事实——当价格以格式化文本显示或库存状态仅被暗示而非明确声明时,这种猜测常常失败。而带有完整 JSON-LD 的页面会被视为经过验证的数据源,其被引用概率会大幅提升。

第一步:找到主题渲染产品页面的位置

每个 Shopify 主题都通过 Liquid 模板渲染产品页面。在大多数现代主题(Dawn、Sense、Craft 及其衍生产品)中,产品模板位于以下位置之一:

  • Sections/main-product.liquid — Dawn 及 Dawn 系主题的主要文件
  • Templates/product.json — 基于 JSON 模板的主题(Shopify 2.0+)

登录 Shopify 后台,进入在线商店 → 主题 → 编辑代码,查看 Sections 或 Templates 文件夹中是否包含 "product" 或 "main-product" 的模板文件。

第二步:添加 Product Schema 的 Liquid 代码片段

在 Snippets 文件夹中新建一个名为 product-jsonld.liquid 的文件,粘贴以下内容:

```liquid {% schema %} { "name": "Product JSON-LD", "target": "section", "settings": [] } {% endschema %}

<script type="application/ld+json"> { "@context": "https://schema.org/", "@type": "Product", "name": {{ product.title | json }}, "brand": { "@type": "Brand", "name": {{ product.vendor | json }} }, "sku": {{ product.selected_or_first_available_variant.sku | default: product.id | json }}, "description": {{ product.description | strip_html | truncate: 300 | json }}, "offers": { "@type": "Offer", "url": {{ shop.url | append: product.url | json }}, "priceCurrency": {{ cart.currency.iso_code | json }}, "price": {{ product.selected_or_first_available_variant.price | divided_by: 100.0 | json }}, "availability": "{% if product.selected_or_first_available_variant.available %}https://schema.org/InStock{% else %}https://schema.org/OutOfStock{% endif %}", "priceValidUntil": {{ "now" | date: "%Y-%m-%d" | date: "%s" | plus: 31536000 | date: "%Y-%m-%d" | json }} }, "image": {% if product.featured_image %}{{ product.featured_image | image_url: width: 800 | json }}{% else %}""{% endif %} } </script> {% schema %} {% endschema %} ```

此代码片段创建了一个包含 Offer 块的基本 Product Schema。Liquid 标签动态提取当前产品的标题、品牌、价格和货币——无需手动录入数据。

第三步:在产品页面上渲染代码片段

打开产品页面模板(Sections/main-product.liquid 或 Templates/product.json),在顶部附近添加以下行:

```liquid {% render 'product-jsonld' %} ```

将其放在任何视觉效果输出之前,这样 JSON-LD 会在浏览器开始渲染之前被解析。顺序不会影响搜索引擎读取方式,但有利于将结构化数据与显示元素保持逻辑分离。

第四步:为跨境可见性添加 ShippingDetails Schema

ShippingDetails Schema 是跨境店铺中单个影响最大的结构化数据补充。AI 引擎在产品比价查询中使用它来回答"这个能寄到我所在的国家吗?"的问题。

创建第二个代码片段文件 shipping-jsonld.liquid:

```liquid <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Product", "name": {{ product.title | json }}, "shippingDetails": { "@type": "OfferShippingDetails", "shippingDestination": [ {% for zone in shop.shipping_zones %} {% for country in zone.countries %} { "@type": "DefinedRegion", "addressCountry": {{ country.code | json }} } {% unless forloop.last and forloop.parentloop.last %},{% endunless %} {% endfor %} {% endfor %} ], "deliveryTime": { "@type": "ShippingDeliveryTime", "handlingTime": { "@type": "QuantitativeValue", "minValue": 1, "maxValue": 3, "unitCode": "DAY" }, "transitTime": { "@type": "QuantitativeValue", "minValue": 5, "maxValue": 14, "unitCode": "DAY" } } } } </script> {% render 'product-jsonld' %} {% render 'shipping-jsonld' %} ```

在产品页模板中与 product-jsonld 一起渲染此片段。如果你的店铺发货至 10 个以上国家,根据 Visora 的审计基准,仅此一个 Schema 补充就能将多市场引用率提升 2-3 倍。

第五步:使用 Google 富文本结果测试验证

在假设一切正常之前,先验证 JSON-LD 输出。打开店铺的某个线上产品页面,查看页面源代码,复制 JSON-LD 块。粘贴到以下工具中:

1. Google 富文本结果测试 — 检查语法和富文本结果资格 2. Schema.org Validator — 检查 Schema 词汇表的严格合规性 3. Visora 免费审计(geovisora.com/audit)——专为 AI 引用就绪检查结构化数据完整度,包括 ChatGPT Search 和 Perplexity 所需的 Schema 类型

常见错误:缺少闭合大括号、产品名称中未转义的引号、打破 JSON 格式的 Liquid 语法(配送国家循环中的尾随逗号是最常见问题)。

第六步:添加 FAQPage Schema 提升引用率

FAQPage Schema 是单个投入产出比最高的 Schema 类型。在产品页面模板中添加 FAQ 区块,并将每个问答包裹在 FAQPage 格式中:

```liquid <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "寄到德国需要多久?", "acceptedAnswer": { "@type": "Answer", "text": "标准配送至德国需要 7-14 个工作日。100 欧元以上订单可选快递配送(5-7 个工作日)。" } }, { "@type": "Question", "name": "如果不合适可以退货吗?", "acceptedAnswer": { "@type": "Answer", "text": "可以,我们提供自收货日起 30 天退换货服务。同品类换货免退货运费。" } } ] } </script> ```

添加 5-7 个 FAQ 条目,覆盖买家最常见的问题。每个 FAQ 应该是目标市场实际搜索的问题——而不是通用填充内容。配送、尺码、保修和兼容性问题在所有 AI 引擎中表现最佳。

第七步:监控与维护

JSON-LD 不是一次性设置就一劳永逸的优化。价格会变化、配送范围会扩大、产品会下架。建立每月审计周期:

  • 检查 Offer 价格是否与当前 PDP 价格一致
  • 验证配送国家是否覆盖所有活跃市场
  • 确认 FAQ 答案仍然准确
  • 每月重新运行 Visora 审计,追踪结构化数据完整度得分

持续维护 JSON-LD 的店铺的引用留存率是仅添加一次 Schema 就从不维护的店铺的 3 倍。

常见问题

添加 JSON-LD 会降低 Shopify 店铺速度吗? 不会。JSON-LD 只是一个附加到页面的脚本标签,增加约 1-3KB 重量,不影响页面渲染时间。

我需要安装 Shopify 应用来添加 JSON-LD 吗? 不需要。以上 Liquid 代码片段适用于任何原生 Shopify 主题,无需第三方应用。应用对库存同步有帮助,但不是 Schema 实现的必要条件。

每页应添加多少种 Schema 类型? 产品页从 Product + Offer + ShippingDetails 开始,FAQ 页面或关于页面添加 FAQPage。这些是在 ChatGPT Search、Perplexity 和 Google AI 概览中提供最高引用提升的 Schema 类型。

JSON-LD 对 Google 自然排名也有帮助吗? 有。结构化数据是某些富文本结果(产品轮播、评价摘要、FAQ 富文本结果)的确认排名因素。JSON-LD 通过同一投资同时提升 AI 引用可见性和传统 SERP 表现。

从免费审计开始

在编辑主题文件之前,通过 Visora 的免费结构化数据审计(geovisora.com/audit)运行你的店铺。扫描会识别你缺少哪些 Schema 类型并提供优先级修复列表。大多数跨境 Shopify 店铺会发现他们缺少 ShippingDetails Schema——多市场 AI 可见性中影响最大的补充——使用上面的代码片段可在 15 分钟内完成修复。

马上落地

用 Visora 审计你的商品页或类目页,优先修复阻碍 AI 引用的 Schema 与 FAQ 缺口。

免费 GEO 审计

https://geovisora.com/zh/blog/shopify-json-ld-step-by-step