Skip to main content
如果您正在使用 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----- 行)。
妥善存储您的私钥文件。您需要在下一步中将其提供给 OneSignal。切勿公开分享您的私钥或将其提交到版本控制系统。

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.receivedmessage.push.sent)。

事件数据架构

对于用户生成的每个消息事件,以下元数据将附加到记录中。

注意事项

  • 保存/激活后的同步可能需要额外 15-30 分钟才能完成。
  • 停用后可能仍会进行最后一次同步。
  • 为确保高效的数据同步,我们的系统会自动创建和管理暂存数据集。这些数据集以 fivetran_{两个随机单词}_staging 的模式命名,在处理过程中临时存储数据,然后再集成到您的主架构中。这些暂存数据集对于维护流畅的工作流程至关重要,不应删除,因为它们会被自动重新创建。

从 Snowflake 导入事件

将行为事件数据从 Snowflake 发送到 OneSignal,以便:
  • 根据用户活动触发 Journey
  • 根据行为数据个性化消息
要求
  • 访问自定义事件(目前处于测试阶段)
  • 升级账户计划(免费应用不可用)。
  • 具有数据仓库访问权限的 Snowflake 账户
  • 存储在 Snowflake 表或视图中的事件数据
  • 从 OneSignal 到您的 Snowflake 实例的网络连接
  • 具有适当权限的用户凭证
设置步骤
1

为 OneSignal 创建专用角色

按照 Snowflake 最佳实践创建角色层次结构:
2

创建专用数据仓库

为 OneSignal 操作创建经济高效的数据仓库:
3

创建用户并授予权限

创建 OneSignal 用户并授予对事件数据的访问权限:
4

创建记账数据库(高级同步引擎)

为 OneSignal 的同步状态管理创建私有数据库:
如果使用基本同步引擎或只读模式,请跳过此步骤。
5

配置身份验证

设置密钥对身份验证(推荐)以增强安全性:
  1. 按照 Snowflake 文档生成公钥/私钥对
  2. 在 Snowflake 用户上配置公钥
  3. 在 OneSignal 的连接设置中使用私钥
或者,您可以使用密码身份验证(已弃用 - 将于 2025 年 11 月被阻止)。
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 秒)
  • 在非高峰时段安排同步
  • 使用每小时/每天同步而不是连续同步