如何配置Gmail线上活动Markup？VirtualLocation等参数配置报错求助

Gmail线上活动Markup配置说明 #

Gmail完全支持线上活动的Markup配置，你遇到的报错均为参数格式不符合Gmail的校验规则导致，正确配置方式如下：

常见错误原因 #

• 直接将location的@type设置为VirtualLocation：Gmail要求location必须是Place类型，VirtualLocation只能作为Place的嵌套字段存在
• 给PostalAddress传空字符串：该字段对于线上活动可以直接省略，不需要显式传空值
• 传入完整的eventAttendanceMode schema链接：Gmail仅支持直接传入枚举值，不需要前缀链接

正确配置示例 #

使用JSON-LD格式嵌入到邮件源码中即可，参考模板如下：

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EventReservation",
  "reservationNumber": "你的预约编号",
  "reservationStatus": "http://schema.org/ReservationConfirmed",
  "underName": {
    "@type": "Person",
    "name": "参会人姓名"
  },
  "reservationFor": {
    "@type": "Event",
    "name": "活动名称",
    "startDate": "活动开始时间，ISO格式 例：2024-06-01T19:00:00+08:00",
    "endDate": "活动结束时间，ISO格式",
    "eventAttendanceMode": "OnlineEventAttendanceMode",
    "location": {
      "@type": "Place",
      "name": "线上活动",
      "virtualLocation": {
        "@type": "VirtualLocation",
        "url": "你的活动参会链接",
        "accessCode": "可选参数，参会密码"
      }
    }
  }
}
</script>

生效注意事项 #

• 发件邮箱需要完成SPF、DKIM、DMARC三项发件人校验，否则Gmail会默认屏蔽标记渲染
• 无需填写任何PostalAddress相关字段，省略该字段即可通过地址校验

内容的提问来源于stack exchange，提问作者Dinesh Singh