mailinapp
Documentation menu

活动场地模块

线下活动的位置信息:场地名称、地址、可选照片,以及一个会在 Google Maps 中打开该位置的"获取路线"按钮。它是会议链接模块的线下对应版本——在活动邮件中占据相同的位置,只是给的是一个实体地点,而不是一个加入链接。

工作原理

活动场地是纯内容模块,与图片或文本模块一样:没有任何内容需要回答。与会议链接或 RSVP 不同,它从不需要动态层级、实时预览分支或能力声明,也从不会出现在响应仪表盘或 CSV 导出中。唯一的互动元素是"获取路线"链接,它接入的是所有承载普通链接的模块(按钮、带链接的图片、社交图标)共用的同一个通用点击追踪接口。它依然会出现在模块级点击热力图中,只是不会作为独立的响应类型出现。

"获取路线"会打开 maps.google.com,不需要 API 密钥,也没有地图缩略图集成——该模块只是构建一个链接,从以下三个来源中选取最精确的一个来生成:

  1. Google Maps 链接(如已设置)——在手机或电脑上从 Google Maps 分享一个地点,并直接粘贴该 URL。短链接(maps.app.goo.gl/...)同样有效,因为它会被原样使用而不是被解析。
  2. 纬度/经度(如已设置,且两者均非零且在有效范围内)——通过 maps.google.com/?q=lat,lng 链接精确定位该点。
  3. 纯文本地址,作为最后的选择——由 Google Maps 自身的查询解析来完成地理编码,而不是 MailInApp 在服务器端做任何处理,对于一个新出现或含糊不清的地址,结果可能会有偏差。

如果三者都未设置,则完全不会渲染路线链接——该模块只会显示你实际填写过的场地名称和照片,而不是一个哪里都去不了的链接。地址留空但设置了地图链接或坐标,依然会生成一个可用的路线链接,只是不显示地址文字。

如果设置了照片,它会以全宽图片的形式渲染在名称和地址上方,与图片模块相同的普通 <img> 形式。它在所有地方(包括 Outlook)渲染效果完全一致;这里不涉及视频/音频模块所需要的那种特殊媒体处理。

可配置字段:

  • 场地名称——加粗文字,最先显示。
  • 地址——自由文本,若包含换行则按多行渲染。
  • Google Maps 链接(可选,最精确)——在生成路线链接时优先于坐标和地址。
  • 纬度/经度(可选)——仅在 Maps 链接留空时使用。
  • 照片 URL(可选)。
  • 路线按钮文案——默认为"Get Directions"。
  • 卡片的背景色、内边距、边框和圆角半径。
  • 场地名称与地址的颜色/字号,以及路线按钮的颜色/背景覆盖项。

示例

Subject

See you there: our fall meetup

一封线下会议邀请邮件可以把活动场地模块与添加到日历搭配使用,让与会者在同一封邮件中同时获得"在哪里"和"已加入我的日历"两项信息。"活动"项目用途在新建项目时就已经内置了这一组合;参见活动与网络研讨会。一支体育俱乐部发送比赛日邮件时,可以把活动场地设置为主场地址,每周原样复用,并搭配一张全新的积分榜——参见体育团队与俱乐部。对于混合形式的活动,可以在活动场地旁边放一个会议链接模块,让线下和远程与会者各自看到与自己相关的控件,而不必发送两封不同的邮件。

静态回退效果是什么样子

<div style="margin:12px 0;background-color:transparent">
  <img src="https://cdn.example.com/venue-photo.jpg" alt="Riverside Hall"
       style="width:100%;max-width:100%;border-radius:6px;display:block;margin-bottom:10px" />
  <p style="margin:0 0 4px;font-weight:600;font-size:16px;color:#111827">Riverside Hall</p>
  <p style="margin:0 0 10px;font-size:14px;color:#4b5563">400 Harbor Way, Portland, OR</p>
  <a href="https://maps.google.com/?q=400%20Harbor%20Way%2C%20Portland%2C%20OR"
     style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;
            border-radius:6px;text-decoration:none;font-size:14px;font-weight:600">
    Get Directions
  </a>
</div>

这就是该模块的完整渲染效果——不存在单独的降级层级,因为一张照片、一个名称、一个地址加上一个普通链接,本来就在每个邮件客户端中显示一致。

相关内容