
每周报告:家庭总计、您自己的一周和排行榜。
每个家庭一个请求,按人个性化 \
函数为每个家庭只发送一个请求。它通过custom_data 传递所有数据,其中包括一个以 External ID 为键的 users 对象。模板随后会为当前渲染的收件人挑选出对应的条目。
supabase/functions/weekly-report/index.ts
email-templates/weekly-report.html
user 保存此人的数据,而直接从 message.custom_data 读取的内容由整个家庭共享。
email-templates/weekly-report.html
第二个 Liquid 示例是从模板简化而来的,只展示逻辑,省略了表格标记。
控制在大小限制内 \
邮件的custom_data 限制为 10 KB。成员较多的家庭可能会超出限制,因此函数会测量负载大小,并在必要时裁剪排行榜。
supabase/functions/weekly-report/index.ts
计划和偏好 \
每周计划任务会在每个星期日 09:00 UTC 调用该函数,使用与推送提醒相同的pg_cron 模式,表达式为 0 9 * * 0。只有开启了 Weekly Email Summary 的用户才会被包含在内。
仪表板设置。 在 Messages > Templates 中创建邮件模板,粘贴 HTML,并将模板 ID 复制到后端的密钥中。custom_data 只能与模板配合使用,因此 template_id 是必需的。
替代方案:Data Feeds \
还有第二种方式可以把按人区分的数据放进邮件,Clean Beans 选择了不使用它。这种方式值得了解,因为对于某些应用来说它更合适。 使用custom_data 时,后端在发送时把数据推送给 OneSignal。使用 Data Feed 时,OneSignal 会在发送每封邮件的那一刻从您的 API 拉取数据。发送本身由 Journey 而不是后端发起。
本小节中的示例仅用于说明。它们展示了如果用 Data Feed 构建每周报告会是什么样子,并非取自该应用。
1
提供一个返回某个人一周数据的端点
一个后端函数接收用户 ID,并以 JSON 形式返回该用户的数据及其家庭的排行榜。
Response from your API
2
在仪表板中创建 Data Feed
在 Settings > Data feeds 中为该 feed 设置别名,并将其指向该端点。URL 和请求头支持 Liquid,因此可以传入收件人的 External ID。
Data Feed configuration
3
将 feed 关联到邮件模板并从中读取
在模板中,值来自
data_feed,后接别名。Email template
4
从循环 Journey 发送
一个以星期日上午时间窗口为第一步、并设置了重新进入规则的 Journey,每周发送该模板。后端中没有任何计划或发送代码。
选择哪一种 \
当后端已经是决定发送的一方时,选择
custom_data。 每周报告正是这种情况。后端按计划运行,知道哪些家庭选择了接收,手上也有所有数据,因此顺带传递数据没有额外成本。一个请求就能覆盖整个家庭,没有需要保护的端点,失败也会显示在您自己的日志中。代价是时机和受众写在代码里,而且负载有固定的大小限制。
当发送属于某个 Journey 时,选择 Data Feed。 Journey 会自行决定何时给某人发消息,例如在某个事件发生几天后或满足等待条件时,而此时后端并不在场提供数据。Data Feed 弥补了这一空缺,也让负责消息的团队无需部署即可更改计划、添加分支或测试变体。代价是每个收件人都会调用一次您的 API,响应时间应在约四分之一秒内,每个模板只能使用一个 feed,并且调用失败意味着此人什么也收不到,也不会有任何提示。
对 Clean Beans 来说,决定因素很简单。后端已经拥有数据和计划,排行榜由整个家庭共享,因此一个请求远比每人一次调用便宜,而且偏好存储在应用的数据库中,后端可以直接检查。
使用 custom_data 进行个性化
大小限制和 Liquid 访问方式。
Data feeds
将实时数据引入 Journey 邮件和短信。
使用 Liquid 语法
过滤器、循环和条件。