跳转到主要内容
自定义事件目前处于早期访问阶段。 要申请访问权限，请联系support@onesignal.com并提供：
  • 您的公司名称
  • 您的OneSignal组织ID
  • 您想要启用的应用ID

​
概览

自定义事件让您能够跟踪来自应用、网站或外部系统的有意义用户操作——并实时对其做出反应。它们通过允许您发送OneSignal之外发生的行为事件，并使用它们提供更有针对性、相关性和时效性的消息传递，来补充OneSignal的内置消息事件。 您可以：
  • 使用OneSignal SDK直接从应用或网站发送事件
  • 从集成、CDP或数据仓库导入事件
  • 使用它们触发旅程、激活等待直到步骤，并根据实时行为细分用户（细分选项即将推出）
示例用例：
  • 用户注册 → 开始入门旅程
  • 用户放弃结账 → 发送提醒或优惠
  • 玩家达到新级别 → 发送应用内奖励
  • 用户尝试取消账户 → 触发挽回活动

​
什么是自定义事件？

自定义事件是任何对您的业务重要的被跟踪用户操作——或无操作。常见示例包括：
  • 进行购买
  • 完成游戏关卡
  • 开始锻炼
  • 取消订阅
每个事件都可以包含属性来提供额外的上下文。 自定义事件结构：
  • name（字符串，必需）— 事件名称，最大128个字符
  • payload（对象，可选）— JSON格式的上下文数据
  • 用户标识符（必需）— 要么是external_id要么是onesignal_id
示例： 
{
  "event": "purchase",
  "properties": {
    "item": "T恤",
    "size": "小号",
    "color": "蓝色",
    "price": 24.99
  }
}
自定义事件可以：
  • 从您的应用或站点实时产生（OneSignal移动/Web SDK）
  • 从Segment、Amplitude或Databricks等集成摄取（即将推出）
  • 从您的仓库或CDP导入（即将推出）

​
将自定义事件导入OneSignal

您可以直接生成事件或从其他系统摄取它们。

​
1. 在应用中生成

通过以下方式发送事件： 示例：通过API发送
curl
curl --request POST \
  --url https://api.onesignal.com/apps/{app_id}/integrations/custom_events \
  --header 'Content-Type: application/json' \
  --data '{
  "events": [
    {
      "name": "completed_onboarding",
      "external_id": "user_12345",
      "payload": {
        "plan": "专业版",
        "time_to_complete": 600
      }
    }
  ]
}'
​
name
string
required
事件的标识符或名称。最大128个字符。
​
external_id
string
required
事件目标用户的外部ID。需要用户的外部ID或OneSignal ID之一。
​
payload
object
关于事件的可选参数（例如，计划名称、产品ID、价格）。
此事件将立即将external_id为user_12345的用户添加到以completed_onboarding作为自定义事件入口规则触发器或等待直到操作的旅程中。

​
2. 摄取现有事件

如果事件已在其他地方跟踪，请通过支持的集成导入它们。
所有事件——无论是从SDK生成还是从数据仓库摄取——在计费方面都受到相同对待。

​
自定义事件支持的集成

更多详细信息请参阅我们的集成页面。
即将推出： Appsflyer、RevenueCat等。

Adobe Audience Manager

AlloyDB

Amazon Athena

Amazon Redshift

Amazon S3

Amplitude

Apache Kafka

Azure Synapse

ClickHouse

Confluent Cloud

Databricks

Elasticsearch

Google BigQuery

Google Cloud SQL for PostgreSQL

Google Sheets

Greenplum

Materialize

Microsoft Fabric

Mixpanel

MotherDuck

MySQL

Postgres

Pub/Sub

SingleStore

Snowflake

SQL Server

Starburst Enterprise

Starburst Galaxy

Trino

Twilio Segment

​
查看和验证事件

事件开始流入后，您可以通过OneSignal中的几个工具查看和排除故障。

​
事件索引

事件的高级仪表板，显示：
  • 摄取的事件总数
  • 最近摄取的事件
  • 源（SDK、API、集成）
  • 每种事件类型最后发生的时间

​
活动动态

实时显示您最近的事件（最多过去30天）。刷新页面以查看新到达的事件。

​
用户资料事件历史

查看特定用户的所有自定义事件——以及消息事件和其他OneSignal活动。

​
事件利用率 （即将推出）

专门的视图，查看您的事件在旅程、细分和其他功能中的使用情况。

​
在OneSignal中使用自定义事件

​
使用事件触发旅程

事件触发旅程让您基于实时活动立即向用户发送消息——无需等待细分更新。您可以在用户执行关键操作的瞬间开始旅程。

​
等待直到事件

使用等待直到步骤在旅程中暂停用户，直到发生特定自定义事件或其他操作。
您还可以定义过期时间窗口。如果用户没有及时满足条件，您可以继续沿着后备路径，发送替代消息，或退出旅程。

​
计划可用性和保留

自定义事件在付费计划中可用。
计划存储事件/月默认保留期保留期自定义
增长版1M30天否
专业版5M60天是
企业版10M90天是
保留详情：
  • 按事件类型计量
  • 专业版和企业版可以为每个事件设置自定义保留期
  • 根据每个计费周期结束时的存储事件计费
  • 删除事件或缩短保留期会减少应计费存储
⌘I