{{ }} 中以在事件流正文中包含它。查看示例。
event 属性
每个事件都包含以下核心字段。event.data.* 下的渠道特定字段仅在适用时包含 — 请参见渠道特定字段。
事件类型，结合渠道和操作（例如
message.push.clicked、message.email.bounced）。请参阅下面事件类型参考中的完整值列表。Liquid： {{ event.kind }}OneSignal 为每个独立事件生成的唯一标识符，采用 UUID v4 格式。使用此 ID 进行幂等投递跟踪。如需消息或模板标识符，请使用
message.id 或 message.template_id。Liquid： {{ event.id }}事件的 UNIX 时间戳。Liquid：
{{ event.timestamp }}事件在 UTC 时间的人类可读时间，格式为 ISO 8601 字符串（例如 “2024-02-21T23:45:15.228Z”）。Liquid：
{{ event.datetime }}订阅类型（例如
iOS、Android、Chrome、Email、SMS）。Liquid： {{ event.subscription_device_type }}渠道特定字段
这些event.data.* 字段仅存在于某些事件类型中。
应用内消息事件
包含于message.iam.* 事件。详情请参见应用内消息事件流。
显示的应用内消息页面或卡片的名称。Liquid：
{{ event.data.page_name }}显示的应用内消息页面或卡片的唯一标识符。Liquid：
{{ event.data.page_id }}被点击的按钮或图像块元素的唯一标识符。Liquid：
{{ event.data.target_id }}Live Activity 事件
包含于message.live_activity.* 事件。
特定 Live Activity 的唯一标识符（例如 “Knicks vs Cavs - Oct 22 7PM”）。Liquid：
{{ event.data.live_activity_id }}Live Activity 类别的分组标签（例如 “Knicks_games”）。Liquid：
{{ event.data.live_activity_type }}失败事件
包含于message.push.failed 和 message.email.failed 事件。
事件类型参考
每个指标的详细定义，请参见指标词汇表。示例事件对象
将此 Liquid 模板复制到您的事件流正文中以捕获所有事件字段：JSON
示例渲染输出
示例渲染输出
推送点击事件经过 Liquid 渲染后的样子：
JSON
event.data.page_name 等渠道特定字段对于不包含它们的事件类型为空。message 属性
message 对象描述发送给最终用户的消息，包括其 ID、模板、内容和 URL。
OneSignal 生成的消息 ID。Liquid：
{{ message.id }}在控制台中设置或使用 API
name 属性设置的消息名称。Liquid： {{ message.name }}推送消息标题或电子邮件主题。对于推送，返回类似
{'en':'Your title'} 的本地化对象。对于电子邮件，返回纯字符串形式的主题行。通过控制台或 API headings / email_subject 属性设置。Liquid： {{ message.title }}推送或短信消息内容（截取为 50 个字符）。不提供电子邮件内容（
email_body）。通过控制台或 API contents 属性设置。Liquid： {{ message.contents }}通过 Journeys 或 API
template_id 属性发送的消息的模板 ID。Liquid： {{ message.template_id }}使用与 Web 和应用无关的单个 URL 时的消息启动 URL。详情请参见 URL、链接和深度链接。Liquid：
{{ message.url }}使用独立的 Web 和应用 URL 时的应用专用启动 URL。详情请参见 URL、链接和深度链接。Liquid：
{{ message.app_url }}使用独立的 Web 和应用 URL 时的 Web 专用启动 URL。详情请参见 URL、链接和深度链接。Liquid：
{{ message.web_url }}Live Activity 操作类型：
start、update 或 end。仅存在于 message.live_activity.* 事件中。Liquid： {{ message.live_activity_event_kind }}示例消息对象
将此 Liquid 模板复制到您的事件流正文中以捕获所有消息字段：JSON
示例渲染输出
示例渲染输出
推送通知消息：电子邮件消息 —
JSON
message.title 为纯字符串形式的主题行，message.contents 为空，因为电子邮件正文内容不包含在事件流数据中：JSON
user 属性
user 对象包含接收消息的用户的个人资料级数据。
用户的 OneSignal ID。Liquid：
{{ user.onesignal_id }}用户的外部 ID。Liquid：
{{ user.external_id }}用户的标签。使用
{{ user.tags }} 访问完整对象，或使用 {{ user.tags.your_tag }} 访问特定标签。使用默认值处理缺失标签：{{ user.tags.your_tag | default: '' }}。用户的语言代码。Liquid：
{{ user.language }}subscription 属性
这些属性描述接收消息的订阅。
订阅的 OneSignal ID。Liquid：
{{ user.subscription.id }}OneSignal 应用 ID。Liquid：
{{ user.subscription.app_id }}订阅的平台特定令牌。对于电子邮件，这是电子邮件地址。对于短信，是 E.164 格式的电话号码。对于推送，是推送令牌。Liquid：
{{ user.subscription.subscription_token }}此订阅记录的会话总数。Liquid：
{{ user.subscription.session_count }}订阅上设置的语言代码。Liquid：
{{ user.subscription.language }}订阅报告的应用或游戏版本。Liquid：
{{ user.subscription.game_version }}订阅最近一次会话的 UNIX 时间戳。Liquid：
{{ user.subscription.last_active }}此订阅记录的总游戏时间（秒）。Liquid：
{{ user.subscription.play_time }}此订阅记录的应用内购买总额。Liquid：
{{ user.subscription.amount_spent }}订阅创建时的 UNIX 时间戳。Liquid：
{{ user.subscription.created_at }}订阅当前是否已选择加入。Liquid：
{{ user.subscription.subscribed }}订阅设备上的 OneSignal SDK 版本。Liquid：
{{ user.subscription.sdk }}设备硬件型号（例如 “iPhone14,2”、“Pixel 7”）。Liquid：
{{ user.subscription.device_model }}设备操作系统和版本（例如 “iOS 17.2”、“Android 14”）。Liquid：
{{ user.subscription.device_os }}相关页面
Event Streams
设置和配置 Event Streams，包括设置、正文模板和调试。
使用 Liquid 语法
用于个性化事件流正文的 Liquid 语法参考。
应用内消息事件流
应用内消息事件数据和轮播跟踪的详情。
指标词汇表
各渠道所有消息事件指标的定义。
常见问题
为什么某些事件数据缺失或为空？
Journeys 和 API 发送的消息数据保留 30 天。如果用户在消息发送 30 天后进行交互（点击、打开、取消订阅），相关消息属性可能为空。解决方法是将交互事件中的message.id 与原始 sent 事件关联，原始事件包含完整的消息数据。
event.id 和 message.id 有什么区别？
event.id 是单个事件的唯一标识符（例如一次特定点击）。message.id 是已发送消息的标识符——多个事件可以共享相同的 message.id（例如，同一推送通知的 sent 事件和 clicked 事件）。
推送和电子邮件的 message.title 格式是什么？
对于推送通知，message.title 返回类似 {'en':'Your title'} 的本地化对象。对于电子邮件，返回纯字符串形式的主题行。格式取决于渠道。
事件流中是否包含自定义事件？
不包含。事件流包含消息事件（已发送、点击、打开、退回等）——而非自定义事件。自定义事件是您发送_到_ OneSignal 的用户操作。事件流将消息投递和参与数据从 OneSignal 导出。如何在事件流正文中引用特定标签？
使用带有精确标签键的{{ user.tags.your_tag_key }}。为避免标签未设置时出错，添加默认值：{{ user.tags.your_tag_key | default: '' }}。详情请参见使用 Liquid 语法。