跳转到主要内容
将 OneSignal 连接到您的内部系统(如数据仓库、CRM 或数据管理平台 (DMP))可解锁实时、个性化和可扩展消息传递的强大功能。无论您使用的是 Salesforce、自定义用户系统还是其他平台,集成都能让您:
  • 使用实时数据发送个性化、时间敏感的消息
  • 在系统之间同步用户属性和消息数据
  • 使用您的内部系统作为真实来源,同时利用 OneSignal 的消息传递基础设施
本指南介绍了常见用例、集成方法和设置最佳实践。

数据库集成


数据库集成的优势

大规模个性化消息传递 使用来自您内部系统的数据实时个性化消息
  • 添加标签以在 OneSignal 中存储用户属性,用于分段或内容个性化。
  • Create message API 中传递 custom_data 以实现个性化而无需永久存储数据。
触发时间敏感消息 当系统中发生关键事件时立即发送消息,例如:
  • 下订单
  • 订阅续订或到期
  • 里程碑成就
  • 使用以下方式触发:
使用外部 ID 和别名统一用户身份 OneSignal 支持 external_id 作为稳定的跨平台用户 ID,每个用户最多可有 10 个自定义别名(例如,crm_idfacebook_id)。

数据流

用户身份结构

使用 external_id 作为跨系统的主要用户标识符。您可以附加其他别名或标识符以获得灵活性。如果不存在全局用户 ID,可以使用 OneSignal/订阅 ID,但需要额外处理,因为它们在链接之前是匿名的。 有关更多信息,请参阅用户订阅

向 OneSignal 发送用户数据

使用我们的 REST API 实时创建和更新用户。我们还支持CSV 导入进行批量入库或更新。

从 OneSignal 导出数据

要从 OneSignal 检索数据:

向 OneSignal 发送自定义事件

通过直接从您的数据仓库同步数据到 OneSignal,发送自定义事件来触发 Journeys
测试版功能。请发送电子邮件至 integrations@onesignal.com 申请访问权限。
支持的集成 OneSignal 与许多数据源集成以同步自定义事件。请参阅自定义事件以获取支持的集成列表。 入门
  1. 在您的 OneSignal 控制台中导航至数据 > 集成
  2. 查找 从您喜欢的数据仓库同步数据横幅。
  3. 点击同步数据以访问数据摄取配置。

从您的数据仓库同步数据

1. 连接您的数据源

如果您没有看到列出的数据仓库,或者如果您对如何设置集成有疑问 - 请通过电子邮件 integrations@onesignal.com 告知我们。我们目前正在接受扩展我们集成产品的请求。

2. 创建您的同步

  • 点击 添加同步
  • 选择 任何仓库表
  • 选择您连接的数据源
  • 选择您的架构和表
    • 对于 Google Sheets:使用表下拉菜单选择文档中的特定工作表。

3. Configure your destination

  • Select OneSignal as connection
  • Choose Custom Event as object type
  • Keep Create Only as sync behavior
  • Map your identifier column to OneSignal External IDs

4. Choose Your Data Fields

  • Select which columns to sync to OneSignal:
    • Supported types: Text, numbers, booleans, dates, times
    • Usage: These fields become available for journey segmentation
    • Recommendation: Sync only the fields you’ll use for targeting

5. Test and Deploy

  • Test your sync to verify data flows correctly
  • Add a descriptive label (can’t be changed later)
  • Set your trigger: Manual, scheduled, or sequential. We recommend selecting sequential for ingesting custom events.
接下来会发生什么?您的自定义事件将出现在 OneSignal 的事件索引中,准备在基于用户行为和仓库数据的旅程中使用。 每个同步选项都有连接到您账户所需的特定详细信息 - 如有关于个人设置的任何问题,请通过 integrations@onesignal.com 联系我们。

数据应该存储在哪里:OneSignal 还是您的数据库?

根据数据的用途决定:

在 OneSignal 中存储什么

存储直接用于消息传递的数据:
  • external_id 和别名
  • 电子邮件(用于电子邮件消息传递)
  • 电话号码(用于短信)
  • 轻量级用户属性作为标签
对于更丰富的个性化,避免存储完整档案——在发送时使用 custom_data 注入动态字段。

在您自己的系统中保留什么

在您自己的系统中保留与消息传递无关的数据(例如,完整的用户档案、交易日志),以获得性能、隐私和控制。从 OneSignal 归档消息历史记录以进行长期分析或合规。

从您的数据库触发消息

您可以使用两种方法触发消息——根据您的用例选择一种或两种。
  • API
  • 标签和 Journeys
  • 自定义事件和 Journeys
使用 Create message API 进行即时的事务性消息传递。通过以下方式定位用户:
  • external_id
  • 别名(例如,crm_id
  • 电子邮件或电话号码
最适合:
  • 事务性消息(例如,收据、警报)
  • 时间敏感或个性化通知
  • 定位个人或群体(每次调用最多 20,000 个用户)
您还可以使用 send_after 参数安排消息。

I