首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >如何在 CMS 里自动生成 Schema 结构化数据(FAQ/Article/Product)

如何在 CMS 里自动生成 Schema 结构化数据(FAQ/Article/Product)

原创
作者头像
用户3237452
发布于 2026-11-19 17:57:49
发布于 2026-11-19 17:57:49
80
举报

一、2026 年,结构化数据为什么值得做

过去给网站加结构化数据,更多是为了搜索结果里多一个星级、多一块 FAQ 折叠,属于"锦上添花"。现在情况变了,网站要同时面对三类读者:

读者

它怎么读你的页面

结构化数据的价值

真人用户

看版面和文字

富摘要提升点击率,体验更好

搜索引擎

抓 HTML + 解析语义

富媒体结果、面包屑、站点名展示

AI 助手 / 大模型

抽取实体与字段

决定它能否准确、稳定地引用你

第三类是这两年最大的变量。大模型不喜欢"一大段散文",它喜欢字段清晰的结构:价格多少、作者是谁、发布时间、问答成对出现。Schema.org 的 JSON-LD 就是这种"机器友好的字段表"。无论你是做企业品牌站、电商产品站,还是集团站群,这件事都值得做。

但传统做法有个很现实的痛点:

  1. 运营每发一篇文章,都要手动往模板里塞一段 JSON-LD,改标题、改日期、改图片;
  2. 字段漏填,JSON 失效,还不容易发现;
  3. 站点一多、内容一多,人工维护就成了负担。

解法是把结构化数据变成 CMS 的自动产物:字段填一次,模板自动拼装,发布即生效。PageAdmin 的 Razor 模板、可视化表单、一对多子表、自定义触发器和开放 API,正好能把这条链路完整地搭起来。


二、方案总览:PageAdmin 里的三条实现路径

先对比一下常见的几种做法:

路径

做法

适合场景

模板输出(本文主推)

JSON-LD 写进详情模板,字段用 Html.InfoData() 取值

绝大多数企业站、内容站、站群

无头 API 输出

用 Html.ResponseJson() 提供结构化数据接口

前后端分离、APP/小程序多端复用

触发器 + AI 自动填充

保存时自动补全 description、日期等字段

内容量大、希望减少人工录入

三条路径可以组合使用,效果最好。推荐组合是:路径一负责前台输出,路径三负责把字段"喂饱",路径二留给多端复用。

先熟悉一下 PageAdmin 的官方取值方式

写 JSON-LD 之前,先记住这几类官方调用(均来自 PageAdmin 帮助文档):

用途

写法

说明

取当前内容页数据

Html.InfoData()

内容页模板中最常用,返回当前信息对象

按表名和 ID 取数据

Html.InfoData("news", 1)

取 news 表中 id 为 1 的数据

输出富文本正文

Html.Raw(infoData.Content)

不加 Raw 会被 HTML 编码

取内容页 URL

Html.InfoDataUrl((int)infoData.ColumnId, (int)infoData.Id)

生成内容页链接

取列表数据

Html.InfoDataList(new { ColumnId = 3, ShowNumber = 10 })

取栏目 ID 为 3 的 10 条数据,配合循环输出

快捷标签

{site:name} {column:name} {content:title} {site:tempath}

站点名 / 栏目名 / 内容标题 / 模板路径

用的时候,先在模板顶部声明一次变量,后面就能一直用:

@{

var infoData = Html.InfoData();

}

然后像 @infoData.Title、@infoData.Thedate 这样调用字段即可。

核心思想一句话:可视化表单里的每个字段,就是 Schema 的一个属性;模板只负责"翻译",不负责"创作"。


三、第一步:后台建表单,让字段成为 Schema 数据源

PageAdmin 的可视化内容表单采用低代码 + 元数据驱动,摒弃了预设死模型的做法,正好可以按 Schema 规范反向设计字段。

3.1 文章表单(对应 Article)

新建可视化表单"新闻文章",拖拽以下字段组件:

字段标识

组件类型

对应 Schema 属性

Title

单行文本(系统字段)

headline

Thedate

日期时间(系统字段)

datePublished

Cover

图片

image

Summary

多行文本

description

Author

单行文本

author.name

UpdateTime

日期时间

dateModified

Content

富文本(系统字段)

正文(页面可见,不进 Schema)

建议把 Summary 单独建字段,别指望从正文里现截取——后面 AI 提取摘要可以直接写进它。

3.2 FAQ 表单(对应 FAQPage)

FAQ 是"一对多"结构,正好用 PageAdmin 的一对多子表组件:

  • 主表单:QuestionSet(问答集),字段 Title
  • 子表字段:Question(单行文本)、Answer(富文本)

一个问答集挂 N 条问答,模板里 foreach 循环输出 mainEntity 数组。运营只需要像填表格一样维护问答,不用碰代码。

3.3 产品表单(对应 Product)

字段标识

组件类型

对应 Schema 属性

ProductName

单行文本

name

Gallery

图片组(一对多)

image(数组)

ProductDesc

多行文本

description

SKU

单行文本

sku

Brand

下拉 / 单行文本

brand.name

Price

数字

offers.price

StockStatus

下拉

offers.availability

Rating / ReviewCount

数字

aggregateRating

小技巧:StockStatus 下拉固定三个选项 InStock / OutOfStock / PreOrder,模板里拼上 https://schema.org/ 前缀即可,不用做中文到状态码的映射。


四、第二步:模板里输出三种 JSON-LD(完整代码)

⚠️ 先解决一个必踩的坑:Razor 默认会做 HTML 编码

@functions {

public static string JsonText(string s) {

if (string.IsNullOrEmpty(s)) return "";

return s.Replace("\\", "\\\\")

.Replace("\"", "\\\"")

.Replace("\r", "")

.Replace("\n", "\\n");

}

}

在 .cshtml 里直接写 @infoData.Title,Razor 会把引号、尖括号编码成 "、<,JSON 会失效。所以输出 JSON-LD 时统一用 @Html.Raw() 包裹,文本字段先做一次 JSON 转义。

把下面这个转义函数放到内容页模板顶部,或放进 _Layout.cshtml 全站复用:

4.1 Article:文章详情页

@{

var infoData = Html.InfoData();

var siteUrl = "https://www.yourdomain.com";

var siteName = "你的站点名称";

var logoUrl = siteUrl + "/uploads/logo.png";

var canonical = siteUrl + Html.InfoDataUrl((int)infoData.ColumnId, (int)infoData.Id);

var cover = string.IsNullOrEmpty(infoData.Cover)

? siteUrl + "/uploads/default-cover.jpg"

: siteUrl + infoData.Cover;

var pub = infoData.Thedate.ToString("yyyy-MM-ddTHH:mm:sszzz");

var mod = infoData.UpdateTime != null

? Convert.ToDateTime(infoData.UpdateTime).ToString("yyyy-MM-ddTHH:mm:sszzz")

: pub;

}

<script type="application/ld+json">

{

"@context": "https://schema.org",

"@type": "Article",

"mainEntityOfPage": {

"@type": "WebPage",

"@id": "@canonical"

},

"headline": "@JsonText(infoData.Title)",

"description": "@JsonText(infoData.Summary)",

"image": ["@cover"],

"datePublished": "@pub",

"dateModified": "@mod",

"author": { "@type": "Person", "name": "@JsonText(infoData.Author)" },

"publisher": {

"@type": "Organization",

"name": "@JsonText(siteName)",

"logo": { "@type": "ImageObject", "url": "@logoUrl" }

}

}

</script>

放在文章详情模板的 <head> 区域或正文之后:

要点:

  • 时间用 yyyy-MM-ddTHH:mm:sszzz,输出 ISO 8601 带时区(如 +08:00);
  • 图片必须是绝对 URL,相对路径会导致验证不通过;
  • dateModified 做了空值兜底,新文章没改过也能正常输出。

4.2 FAQPage:问答页

@{

var infoData = Html.InfoData();

var siteUrl = "https://www.yourdomain.com";

var gallery = infoData.Gallery;

var imgs = string.Join(",", gallery.Select(x => "\"" + siteUrl + x.Url + "\""));

var availability = "https://schema.org/" + infoData.StockStatus;

var productUrl = siteUrl + Html.InfoDataUrl((int)infoData.ColumnId, (int)infoData.Id);

}

<script type="application/ld+json">

{

"@context": "https://schema.org",

"@type": "Product",

"name": "@JsonText(infoData.ProductName)",

"description": "@JsonText(infoData.ProductDesc)",

"sku": "@JsonText(infoData.SKU)",

"image": [@imgs],

"brand": { "@type": "Brand", "name": "@JsonText(infoData.Brand)" },

"offers": {

"@type": "Offer",

"price": "@infoData.Price",

"priceCurrency": "CNY",

"availability": "@availability",

"url": "@productUrl"

}

@if (infoData.Rating > 0 && infoData.ReviewCount > 0) {

<text>,

"aggregateRating": {

"@type": "AggregateRating",

"ratingValue": "@infoData.Rating",

"reviewCount": "@infoData.ReviewCount"

}</text>

}

}

</script>

提示:Google 对 FAQ 富摘要的展示范围做了收紧,但 FAQPage 标记对 AI 理解"问题—答案"的成对关系依然很有价值,从 GEO 角度依然值得做。另外,答案文本要在页面上真实可见,不能只藏在 JSON-LD 里。

4.3 Product:产品详情页

@{

var infoData = Html.InfoData();

var siteUrl = "https://www.yourdomain.com";

var gallery = infoData.Gallery;

var imgs = string.Join(",", gallery.Select(x => "\"" + siteUrl + x.Url + "\""));

var availability = "https://schema.org/" + infoData.StockStatus;

var productUrl = siteUrl + Html.InfoDataUrl((int)infoData.ColumnId, (int)infoData.Id);

}

<script type="application/ld+json">

{

"@context": "https://schema.org",

"@type": "Product",

"name": "@JsonText(infoData.ProductName)",

"description": "@JsonText(infoData.ProductDesc)",

"sku": "@JsonText(infoData.SKU)",

"image": [@imgs],

"brand": { "@type": "Brand", "name": "@JsonText(infoData.Brand)" },

"offers": {

"@type": "Offer",

"price": "@infoData.Price",

"priceCurrency": "CNY",

"availability": "@availability",

"url": "@productUrl"

}

@if (infoData.Rating > 0 && infoData.ReviewCount > 0) {

<text>,

"aggregateRating": {

"@type": "AggregateRating",

"ratingValue": "@infoData.Rating",

"reviewCount": "@infoData.ReviewCount"

}</text>

}

}

</script>

要点:

  • price 只写数字,不要带 ¥ 符号,币种用 priceCurrency: "CNY" 单独声明;
  • availability 用 schema.org 的标准 URL,别写"有货"这类中文;
  • aggregateRating 必须对应页面上真实展示的评分。

4.4 进阶:用无头 API 输出结构化数据,一次创建多端复用

PageAdmin 内置无头 CMS 能力,可以用 Html.ResponseJson() 把结构化数据做成接口,供前端、APP、小程序或第三方调用。官方帮助示例中,只需取消母版页再输出 JSON:

这套做法的价值在于:结构化数据不再绑定某一个页面模板,WEB、APP、小程序用到同一份数据,改一处、全端同步。

@{

Layout = null; // 必须声明,避免母版页 html 污染 json

var infoData = Html.InfoData("news", 1);

var schema = new {

context = "https://schema.org",

type = "Product",

name = infoData.Title,

image = infoData.Cover

};

}

@Html.ResponseJson(schema)


五、第三步:用触发器 + AI 让字段自动长出来

模板解决了"输出","自动"还要让字段不用人填。PageAdmin 的可视化触发器和内置 AI 正好派上用场。

5.1 触发器自动补全日期字段

给文章表单配置自定义触发器(数据新增 / 更新时触发):

这样编辑只管填正文,Schema 需要的时间字段永远有值,模板里的空值兜底只是最后一道保险。

5.2 用 AI 提取摘要,自动填充 description

PageAdmin 默认集成阿里云千问大模型,支持 AI 创作、错别字识别、提取摘要和关键词,并且可以"自定义赋值给表单的其他组件"。配置方式:

  1. 在富文本组件 Content 上开启"AI 提取摘要";
  2. 目标字段指向 Summary(多行文本);
  3. 关键词可指向 Keywords 字段,用于页面 meta 与主题聚类。

效果:编辑写完正文点一下"提取",description 自动填好,前台 JSON-LD 里的 description 同步更新。这是"自动生成"体验最明显的环节——把最容易被漏填的字段交给 AI。

5.3 定时触发器做例行巡检

用定时触发器定期筛出以下记录并提醒维护人员:

  • Cover 为空的文章;
  • Price 为 0 或负数的产品;
  • Question 子表为空的问答集;
  • UpdateTime 超过 1 年的内容(提示刷新)。

结构化数据最怕"字段半残",例行巡检比一次性上线更重要。


六、第四步:站群场景下,一套模板全站复用

这是 PageAdmin 很适合规模化应用的地方。它支持在一个平台里创建大量站点,站点之间数据可按库级或架构(schema)级隔离,并支持多语言站点、独立域名和独立权限。

对结构化数据来说,这意味着:

  1. 模板复用:把上面几段 JSON-LD 放进共用母版页 _Layout.cshtml 或模板目录,所有绑定该模板的站点一起生效;
  2. 字段统一:用同一套可视化表单结构管理字段,各站点内容独立,Schema 输出格式一致;
  3. 一次改、全站更新:Schema 规范调整时,改模板即可,不用逐站改页面;
  4. 多语言站点:各语言站点用同一套字段映射,AI 抓取到的是结构一致、语言对应的实体信息。

企业官网、品牌站、集团分站、学校与机构站点,都可以用这套方法统一把内容做成"机器可读"的数字资产。


七、验证与调试

代码写完别急着发,先用工具验证:

工具

地址

用途

Google 富媒体搜索结果测试

search.google.com/test/rich-results

看能否识别 Article / Product / FAQ

Schema.org Validator

validator.schema.org

检查语法与类型是否合法

百度搜索资源平台

结构化数据提交/检测

国内搜索引擎侧验证

静态化站点特别注意:PageAdmin 支持 HTML 页面静态化,模板改完后要重新生成静态文件,否则线上看到的还是旧 HTML。顺序是:改模板 → 后台重新生成 → 再验证。

调试技巧:浏览器 F12 → Elements 里搜索 application/ld+json,确认输出的是合法 JSON。看到 "headline": "标题" 而不是 "headline": "&quot;标题&quot;",就说明 Html.Raw 和转义函数用对了。


八、10 条避坑清单

  1. Razor 自动编码破坏 JSON——JSON 输出用 @Html.Raw(),文本字段先过 JsonText() 转义。
  2. 日期格式不对——必须 ISO 8601 + 时区,zzz 正好输出 +08:00。
  3. 图片用相对路径——image 必须是绝对 URL,统一拼接站点域名。
  4. 价格带符号——"¥1999" 无效,写成 1999 + priceCurrency: "CNY"。
  5. 库存状态写中文——要用 https://schema.org/InStock 这类标准值。
  6. 空值输出 null——所有可选字段都要有兜底(默认值或条件判断)。
  7. JSON 末尾多逗号——循环里最后一项不能带逗号,用 q == faqs.Last() 判断。
  8. 标记与页面不一致——JSON-LD 里写的问答、评分,页面上必须真实可见。
  9. 改模板不重新静态化——静态站必须重新生成 HTML 才能生效。
  10. 评分编造——aggregateRating 必须对应真实评价。

九、总结

完整链路回顾:

  1. 建表单:按 Schema 规范设计可视化表单字段,一个字段对应一个属性;
  2. 写模板:用官方 Html.InfoData() 取值,模板输出 JSON-LD,Html.Raw + JsonText 保证 JSON 合法;
  3. 接自动化:触发器补全日期,AI 提取摘要填 description,定时触发器巡检缺失字段;
  4. 做验证:富媒体测试工具 + Schema Validator + 重新静态化;
  5. 守规范:标记真实、可见、可验证。

这套做法的本质,是从"每个页面手工写代码"变成"一次配置、全站自动生成"。对内容量大、站点多的组织来说,节省的不只是开发时间,更是长期的数据一致性——而一致性,恰恰是 AI 愿意引用你的前提。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、2026 年,结构化数据为什么值得做
  • 二、方案总览:PageAdmin 里的三条实现路径
    • 先熟悉一下 PageAdmin 的官方取值方式
  • 三、第一步:后台建表单,让字段成为 Schema 数据源
    • 3.1 文章表单(对应 Article)
    • 3.2 FAQ 表单(对应 FAQPage)
    • 3.3 产品表单(对应 Product)
  • 四、第二步:模板里输出三种 JSON-LD(完整代码)
    • ⚠️ 先解决一个必踩的坑:Razor 默认会做 HTML 编码
    • 4.1 Article:文章详情页
    • 4.2 FAQPage:问答页
    • 4.3 Product:产品详情页
    • 4.4 进阶:用无头 API 输出结构化数据,一次创建多端复用
  • 五、第三步:用触发器 + AI 让字段自动长出来
    • 5.1 触发器自动补全日期字段
    • 5.2 用 AI 提取摘要,自动填充 description
    • 5.3 定时触发器做例行巡检
  • 六、第四步:站群场景下,一套模板全站复用
  • 七、验证与调试
  • 八、10 条避坑清单
  • 九、总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档