google要求event结构化数据必填字段为:name(非空字符串)、startdate(iso 8601格式时间)、url(完整https链接)、location(嵌套对象,含@type和name,线下用place+address,线上用virtuallocation+url)。

Event类型结构化数据必须填哪些字段
Google 对 Event 类型的结构化数据有硬性要求,漏掉任一必填项,整段标记就会被忽略。不是“建议填”,而是“不填就不认”。
-
name:活动标题,字符串,不能为空(比如不能是空格或) -
startDate:开始时间,必须是 ISO 8601 格式,如"2026-05-20T14:00:00+08:00";只写日期"2026-05-20"也合法,但不能用中文或斜杠分隔 -
url:活动详情页的完整 HTTPS URL,相对路径(如/event/123)或协议相对路径(如//example.com/event/123)均无效 -
location:必须是嵌套对象,且至少含@type和name;若为实体场所,推荐用Place类型并补全address(含streetAddress、addressLocality等)
怎么写 location 才不被 Google 报“缺失地址”
绝大多数 Event 标记失败,根源在 location 字段——它不能是字符串,也不能只写个名字。Google 明确要求语义化描述。
- 错误写法:
"location": "上海国际会议中心"(纯字符串,无结构) - 正确写法:用
Place类型,并确保address是对象而非字符串 - 如果活动在线上举行,
@type应设为VirtualLocation,且必须带url字段指向会议链接 - 线下+线上混合?得用
EventSeries或拆成两个独立Event,单个Event不支持多 location
示例(线下):
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
{
"@context": "https://schema.org",
"@type": "Event",
"name": "2026 上海人工智能峰会",
"startDate": "2026-05-20T09:00:00+08:00",
"url": "https://example.com/events/ai-summit-2026",
"location": {
"@type": "Place",
"name": "上海国际会议中心",
"address": {
"@type": "PostalAddress",
"streetAddress": "浦东滨江大道2727号",
"addressLocality": "上海",
"postalCode": "200120"
}
}
}
JSON-LD 放哪儿才保证 Google 能抓到
别信“放哪都行”。Google 的爬虫优先解析 ,且明确不执行 JS 动态注入的脚本。服务端未吐出的 JSON-LD,基本等于没写。
- 必须放在
内,或顶部(开始后第一块 script) - 绝对不要包裹在
<div>、<code><template></template>或其他 HTML 标签里 - Next.js、Nuxt 等 SSR 框架中,必须通过
getStaticProps或generateMetadata在服务端生成,而非useEffect客户端拼接 - 本地测试时,用 Google URL Inspection Tool 粘贴完整 HTML 源码(含 script 块),别只粘 JSON 片段
-
startDate写成过去时间(如今天是 2026-05-09,却填了"2026-05-01")——Google 会直接丢弃,不报格式错 -
location用了Organization类型但没提供sameAs或logo——类型错配,字段再全也无效 - 页面实际是活动列表页(含多个 event),却只塞一个
Event对象——该用EventSeries或CollectionPage - 用了
Event但页面根本没展示活动信息(比如首页硬塞一个 event)——Google 会判定为误导性标记
常见报错“无法解析”其实和语法无关
Google Search Console 显示“无法解析结构化数据”,90% 不是逗号或引号问题,而是语义违规。
真正容易被忽略的点:Google 对 Event 的富摘要触发有冷启动期,即使标记完全合规,首次上线后也可能需 3–7 天才出现在富媒体结果中,期间别反复改代码刷验证。










