概览
OneSignal + MotherDuck 集成可以自动将您的 MotherDuck 数据库中的自定义事件同步到 OneSignal,以基于用户行为触发自动化消息活动和 Journey。 MotherDuck 是一个 DuckDB 云服务,提供快速的 OLAP(在线分析处理)功能,具有 SQL 的简单性。要求
- 访问自定义事件(目前处于测试阶段)
- 升级账户计划(免费应用不可用)。
MotherDuck 要求
- 具有数据库访问权限的 MotherDuck 账户
- 用于身份验证的 服务令牌
- 包含事件数据的 数据库
- 具有结构化事件信息的 表或视图
设置
1
创建 MotherDuck 服务令牌
生成一个供 OneSignal 连接到 MotherDuck 的访问令牌:
- 在
app.motherduck.com
登录 MotherDuck Web UI - 点击左上角的个人资料
- 导航到 设置 > 常规 > 访问令牌
- 点击 创建令牌
- 设置过期日期(或保持无限制)
- 复制生成的服务令牌
2
准备您的事件数据
确保您的 MotherDuck 数据库包含正确结构的事件表:
3
连接到 OneSignal
在 OneSignal 中,前往 数据 > 集成,然后点击 添加集成。选择 MotherDuck 并提供:
- 服务令牌: 步骤 1 中的令牌
- 数据库名称: 您的 MotherDuck 数据库名称
- 连接字符串:
md:your_database_name
4
配置数据同步
选择表或编写自定义 SQL 查询来定义要同步的事件数据:
事件数据映射
将您的 映射到 OneSignal 的自定义事件格式:OneSignal 字段 | 描述 | 必需 | |
---|---|---|---|
name | event_name | 事件标识符 | 是 |
external_id | user_id | 用户标识符 | 是 |
timestamp | event_timestamp | 事件发生时间 | 否 |
properties | event_data | 否 |
事件查询示例
处理模式
表模式
直接从您的 MotherDuck 数据库同步整个表。OneSignal 将自动将列映射到事件字段。SQL 查询模式
编写自定义 DuckDB SQL 查询来转换和过滤您的事件数据:限制
- 查询复杂性影响同步性能
- 大型结果集可能影响同步速度
- JSON 解析需要正确的列类型