如果您正在使用 OneSignal 的旧版 Snowflake 集成,请参阅 Snowflake 旧版集成指南。

OneSignal Snowflake 集成概述
概述
OneSignal + Snowflake 集成支持两种强大的数据管道:- 导出:自动将 OneSignal 的消息事件数据(推送、电子邮件、短信、应用内消息)发送到 Snowflake 进行分析和报告。
- 导入:将 Snowflake 数据集中的自定义用户事件同步到 OneSignal,以触发自动化 Journey 和个性化消息。
将 OneSignal 事件导出到 Snowflake
将消息性能和参与度事件(例如发送、打开、点击)发送到 Snowflake,以便:- 构建自定义仪表板和报告
- 跟踪跨渠道的投递和参与度趋势
- 将 OneSignal 数据与其他业务数据结合进行分析
- OneSignal 专业版计划(免费应用不可用)
- Snowflake 账户
- Snowflake 中的 SECURITYADMIN 或 ACCOUNTADMIN 角色(用于设置)
1. 收集 Snowflake 账户详细信息
在配置集成之前,请从 Snowflake 账户收集以下信息:- Snowflake 主机:格式为
<account_identifier>.snowflakecomputing.com的账户 URL - 数据库名称:OneSignal 将写入事件数据的数据库
- 架构名称:数据库中 OneSignal 表的架构(将由 OneSignal 自动创建)
- 数据仓库名称:用于数据加载操作的数据仓库

Snowflake 账户标识符位置
2. 在 Snowflake 中运行设置脚本
在 Snowflake 数据仓库中执行以下 SQL 脚本,为 OneSignal 创建必要的角色、用户、数据仓库和数据库:您可以自定义脚本顶部的变量值以匹配您的命名约定。如果您使用现有的数据仓库或数据库,请相应地修改脚本。
3. 生成密钥对进行身份验证
OneSignal 需要密钥对身份验证才能安全访问您的 Snowflake 账户。按照以下步骤生成和配置密钥:1
生成私钥
运行以下命令之一以生成私钥:未加密的私钥(更简单,但安全性较低):加密的私钥(推荐用于生产环境):如果使用加密密钥,系统将提示您创建密码短语。请妥善保存此密码短语——在配置 OneSignal 时您将需要它。
2
生成公钥
从私钥生成公钥:
3
将公钥分配给 Snowflake 用户
复制公钥文件的内容(不包括页眉和页脚行),然后在 Snowflake 中运行此 SQL 命令:将
<YOUR_PUBLIC_KEY_CONTENT> 替换为密钥内容(不包括 -----BEGIN PUBLIC KEY----- 和 -----END PUBLIC KEY----- 行)。4. 连接 OneSignal
1
激活集成
在 OneSignal 中,导航至数据 > 集成 > Snowflake。
2
输入详细信息
- 主机:
<your_account>.snowflakecomputing.com - 数据库:例如
ONESIGNAL - 架构
- 表:例如
message_events - 用户:
ONESIGNAL_USER(或您创建的用户名) - 私钥:粘贴私钥文件的内容(
rsa_key.p8) - 私钥密码短语(可选,仅当私钥已加密时)
3
配置集成
- 同步频率: 最频繁可为每 15 分钟一次
- 架构/表名称: 预设为
onesignal_events_<app-id>和message_events(可编辑) - 事件类型: 选择要同步的事件——全选或仅选择您需要的
4
选择事件
选择您想在 Snowflake 数据仓库中接收的事件。
5
完成设置
点击保存并等待成功确认
初始数据同步可能需要 15-30 分钟才能在 Snowflake 中显示。在等待期间,通过推送、电子邮件、应用内消息或短信发送消息以触发所选事件。
5. 在 Snowflake 中查看数据
初始同步完成后,查询您的 OneSignal 事件数据:如果您遇到缺少架构、权限错误或格式错误的事件等问题,请联系
support@onesignal.com。消息事件和属性
消息事件类型
属性:event_kind
类型: String
消息和事件的类型(例如 message.push.received、message.push.sent)。
事件数据架构
对于用户生成的每个消息事件,以下元数据将附加到记录中。注意事项
- 保存/激活后的同步可能需要额外 15-30 分钟才能完成。
- 停用后可能仍会进行最后一次同步。
- 为确保高效的数据同步,我们的系统会自动创建和管理暂存数据集。这些数据集以
fivetran_{两个随机单词}_staging的模式命名,在处理过程中临时存储数据,然后再集成到您的主架构中。这些暂存数据集对于维护流畅的工作流程至关重要,不应删除,因为它们会被自动重新创建。
从 Snowflake 导入事件
将行为事件数据从 Snowflake 发送到 OneSignal,以便:- 根据用户活动触发 Journey
- 根据行为数据个性化消息
- 访问自定义事件(目前处于测试阶段)
- 升级账户计划(免费应用不可用)。
- 具有数据仓库访问权限的 Snowflake 账户
- 存储在 Snowflake 表或视图中的事件数据
- 从 OneSignal 到您的 Snowflake 实例的网络连接
- 具有适当权限的用户凭证
1
为 OneSignal 创建专用角色
按照 Snowflake 最佳实践创建角色层次结构:
2
创建专用数据仓库
为 OneSignal 操作创建经济高效的数据仓库:
3
创建用户并授予权限
创建 OneSignal 用户并授予对事件数据的访问权限:
4
创建记账数据库(高级同步引擎)
为 OneSignal 的同步状态管理创建私有数据库:
5
配置身份验证
设置密钥对身份验证(推荐)以增强安全性:
- 按照 Snowflake 文档生成公钥/私钥对
- 在 Snowflake 用户上配置公钥
- 在 OneSignal 的连接设置中使用私钥
6
连接到 OneSignal
在 OneSignal 中,前往 数据 > 集成,然后点击 添加集成。选择 Snowflake 并提供以下连接详细信息:
- 账户名称: 您的 Snowflake 账户标识符(例如
abc123.us-east-1) - 数据仓库:
CENSUS_WAREHOUSE - 用户:
CENSUS - 数据库: 您的事件数据数据库名称
- 架构: 您的事件数据架构名称
- 身份验证: 密钥对(提供私钥和可选密码短语)
事件数据映射
将您的 映射到 OneSignal 的自定义事件格式:示例事件表架构
SQL 查询模式
编写自定义 SQL 查询以转换您的事件数据:高级配置
管理数据仓库成本
- 使用 X-Small 数据仓库大小以优化成本
- 配置自动挂起(60 秒)和自动恢复
- 在非高峰时段安排同步
- 考虑与其他批处理系统共享数据仓库
实时同步支持
要进行实时事件处理,请在事件表上启用变更跟踪:网络安全
如果使用 Snowflake 的允许 IP 网络策略,请将 OneSignal 的 IP 地址添加到您的允许列表。请联系 OneSignal 支持以获取当前的 IP 范围。限制
- 复杂的分析查询可能会影响数据仓库性能和成本
- 用户/密码身份验证将于 2025 年 11 月弃用
- CENSUS 数据库仅保留用于 OneSignal 操作
常见问题
我应该使用哪种身份验证方法?
使用密钥对身份验证(推荐)。从 2025 年 11 月开始,Snowflake 将阻止用户/密码身份验证。我可以使用现有的数据仓库吗?
可以,您可以与其他批处理系统(如 dbt 或 Fivetran)共享数据仓库以优化成本。确保数据仓库具有足够的容量来满足您的事件处理需求。如何优化成本?
- 使用 X-Small 数据仓库大小
- 配置激进的自动挂起(60 秒)
- 在非高峰时段安排同步
- 使用每小时/每天同步而不是连续同步