必须使用 Schema.org 标准 URI 如 https://schema.org/DeliveryEvent,配合 itemscope 和 itemprop 才生效;推荐优先采用 JSON-LD 方式标记配送信息,且 expectedArrivalFrom 和 deliveryStatus 等关键字段须严格符合 ISO 8601 及预定义 URI 规范。

itemtype 要用 Schema.org 的配送类,不是随便写 URL
直接写 itemtype="DeliveryEvent" 是无效的——HTML 不认识这个字符串。必须用完整、可验证的 Schema.org 类型 URI:https://schema.org/DeliveryEvent。同理,如果描述的是物流服务商(比如快递公司),要用 https://schema.org/Organization;如果是预计送达时间,则需嵌套在 https://schema.org/ParcelDelivery 下。浏览器和搜索引擎只认这些标准 URI,写错一个字符(比如漏掉末尾斜杠或拼错 Delivery)会导致结构化数据完全不被识别。
必须配合 itemscope 和 itemprop 才能生效
itemtype 单独存在毫无意义。它必须包裹在带有 itemscope 的元素内,并通过子元素的 itemprop 关联具体字段。常见错误是只加 itemtype,忘了声明作用域,或者把 itemprop 写在了错误层级。例如:
<div itemscope itemtype="https://schema.org/ParcelDelivery">
<span itemprop="expectedArrivalFrom">2024-06-15</span>
<div itemprop="deliveryAddress" itemscope itemtype="https://schema.org/PostalAddress">
<span itemprop="addressLocality">杭州市</span>
</div>
</div>
注意:嵌套的 PostalAddress 必须有自己的 itemscope,且 itemprop="deliveryAddress" 指向的是整个地址块,不是其中某个 <span>。
关键配送属性别硬凑,优先选 Google 支持的字段
Schema.org 定义了几十个与配送相关的属性,但 Google 搜索结果中实际展示富摘要(如“预计 6 月 15 日送达”)只认有限几个。实测有效且推荐使用的有:
立即学习“前端免费学习笔记(深入)”;
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
-
expectedArrivalFrom和expectedArrivalUntil(日期格式必须是YYYY-MM-DD或YYYY-MM-DDTHH:MM:SS) -
deliveryStatus(值应为https://schema.org/InTransit、https://schema.org/Delivered等预定义枚举 URI,不能写中文或自定义字符串) -
provider(指向快递公司,需嵌套Organization并提供name) -
trackingNumber(纯文本,无需额外标记,但建议放在itemprop下)
像 hasDeliveryMethod 或 availableDeliveryMethod 这类属性,Google 目前不提取、不展示,加了也白加,还可能干扰解析。
微数据 vs JSON-LD:现在更推荐后者
虽然 itemtype 属于 HTML 微数据规范,但实际项目中越来越难维护:嵌套深、易错位、模板逻辑耦合重。Google 官方明确表示对 JSON-LD 的支持更稳定、容错更强,且不影响页面渲染。如果你只是想让商品页正确上报配送状态,直接在 <head> 里加一段 JSON-LD 更可靠:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "ParcelDelivery",
"expectedArrivalFrom": "2024-06-15",
"deliveryStatus": "https://schema.org/InTransit",
"provider": {
"@type": "Organization",
"name": "顺丰速运"
}
}
</script>
微数据方式只有在需要将结构化数据与可视 DOM 强绑定(比如动态更新某段文字同时刷新 schema)时才值得考虑。多数电商详情页,JSON-LD 是更省心的选择。
真正容易被忽略的点是:日期字段必须严格符合 ISO 8601,且 deliveryStatus 必须用完整 URI —— 这两个地方出错,整个 ParcelDelivery 就会被搜索引擎静默丢弃,连错误提示都不会给。


















