
过去给网站加结构化数据,更多是为了搜索结果里多一个星级、多一块 FAQ 折叠,属于"锦上添花"。现在情况变了,网站要同时面对三类读者:
读者 | 它怎么读你的页面 | 结构化数据的价值 |
|---|---|---|
真人用户 | 看版面和文字 | 富摘要提升点击率,体验更好 |
搜索引擎 | 抓 HTML + 解析语义 | 富媒体结果、面包屑、站点名展示 |
AI 助手 / 大模型 | 抽取实体与字段 | 决定它能否准确、稳定地引用你 |
第三类是这两年最大的变量。大模型不喜欢"一大段散文",它喜欢字段清晰的结构:价格多少、作者是谁、发布时间、问答成对出现。Schema.org 的 JSON-LD 就是这种"机器友好的字段表"。无论你是做企业品牌站、电商产品站,还是集团站群,这件事都值得做。
但传统做法有个很现实的痛点:
解法是把结构化数据变成 CMS 的自动产物:字段填一次,模板自动拼装,发布即生效。PageAdmin 的 Razor 模板、可视化表单、一对多子表、自定义触发器和开放 API,正好能把这条链路完整地搭起来。
先对比一下常见的几种做法:
路径 | 做法 | 适合场景 |
|---|---|---|
模板输出(本文主推) | JSON-LD 写进详情模板,字段用 Html.InfoData() 取值 | 绝大多数企业站、内容站、站群 |
无头 API 输出 | 用 Html.ResponseJson() 提供结构化数据接口 | 前后端分离、APP/小程序多端复用 |
触发器 + AI 自动填充 | 保存时自动补全 description、日期等字段 | 内容量大、希望减少人工录入 |
三条路径可以组合使用,效果最好。推荐组合是:路径一负责前台输出,路径三负责把字段"喂饱",路径二留给多端复用。
写 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 的一个属性;模板只负责"翻译",不负责"创作"。
PageAdmin 的可视化内容表单采用低代码 + 元数据驱动,摒弃了预设死模型的做法,正好可以按 Schema 规范反向设计字段。
新建可视化表单"新闻文章",拖拽以下字段组件:
字段标识 | 组件类型 | 对应 Schema 属性 |
|---|---|---|
Title | 单行文本(系统字段) | headline |
Thedate | 日期时间(系统字段) | datePublished |
Cover | 图片 | image |
Summary | 多行文本 | description |
Author | 单行文本 | author.name |
UpdateTime | 日期时间 | dateModified |
Content | 富文本(系统字段) | 正文(页面可见,不进 Schema) |
建议把
Summary单独建字段,别指望从正文里现截取——后面 AI 提取摘要可以直接写进它。
FAQ 是"一对多"结构,正好用 PageAdmin 的一对多子表组件:
QuestionSet(问答集),字段 TitleQuestion(单行文本)、Answer(富文本)一个问答集挂 N 条问答,模板里 foreach 循环输出 mainEntity 数组。运营只需要像填表格一样维护问答,不用碰代码。
字段标识 | 组件类型 | 对应 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/前缀即可,不用做中文到状态码的映射。
@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 全站复用:
@{
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);dateModified 做了空值兜底,新文章没改过也能正常输出。@{
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 里。
@{
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 必须对应页面上真实展示的评分。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)
模板解决了"输出","自动"还要让字段不用人填。PageAdmin 的可视化触发器和内置 AI 正好派上用场。
给文章表单配置自定义触发器(数据新增 / 更新时触发):
这样编辑只管填正文,Schema 需要的时间字段永远有值,模板里的空值兜底只是最后一道保险。
PageAdmin 默认集成阿里云千问大模型,支持 AI 创作、错别字识别、提取摘要和关键词,并且可以"自定义赋值给表单的其他组件"。配置方式:
Content 上开启"AI 提取摘要";Summary(多行文本);Keywords 字段,用于页面 meta 与主题聚类。效果:编辑写完正文点一下"提取",description 自动填好,前台 JSON-LD 里的 description 同步更新。这是"自动生成"体验最明显的环节——把最容易被漏填的字段交给 AI。
用定时触发器定期筛出以下记录并提醒维护人员:
Cover 为空的文章;Price 为 0 或负数的产品;Question 子表为空的问答集;UpdateTime 超过 1 年的内容(提示刷新)。结构化数据最怕"字段半残",例行巡检比一次性上线更重要。
这是 PageAdmin 很适合规模化应用的地方。它支持在一个平台里创建大量站点,站点之间数据可按库级或架构(schema)级隔离,并支持多语言站点、独立域名和独立权限。
对结构化数据来说,这意味着:
_Layout.cshtml 或模板目录,所有绑定该模板的站点一起生效;企业官网、品牌站、集团分站、学校与机构站点,都可以用这套方法统一把内容做成"机器可读"的数字资产。
代码写完别急着发,先用工具验证:
工具 | 地址 | 用途 |
|---|---|---|
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": ""标题"",就说明 Html.Raw 和转义函数用对了。
@Html.Raw(),文本字段先过 JsonText() 转义。zzz 正好输出 +08:00。image 必须是绝对 URL,统一拼接站点域名。"¥1999" 无效,写成 1999 + priceCurrency: "CNY"。https://schema.org/InStock 这类标准值。q == faqs.Last() 判断。aggregateRating 必须对应真实评价。完整链路回顾:
Html.InfoData() 取值,模板输出 JSON-LD,Html.Raw + JsonText 保证 JSON 合法;description,定时触发器巡检缺失字段;这套做法的本质,是从"每个页面手工写代码"变成"一次配置、全站自动生成"。对内容量大、站点多的组织来说,节省的不只是开发时间,更是长期的数据一致性——而一致性,恰恰是 AI 愿意引用你的前提。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。