通过导出 CRM 事件写入的 FlareLane CRM 事件的 schema。
| 列 | 类型 | 类别 | 说明 |
|---|
| id | string | 通用 | 事件唯一标识符 (ULID) |
| type | string | 通用 | 事件类型。例:push.sent |
| channel | string | 通用 | 渠道判别符。push / sms / kakaoalimtalk / kakaobrandmessage / email / iam |
| time | string | 通用 | 事件发生时刻 (RFC 3339, UTC) |
| deviceid | string | 通用 | FlareLane 设备标识符 |
| userid | string | 通用 | FlareLane 用户标识符(未识别用户时为 null) |
| campaign_id | string | 共享 | 营销活动标识符 |
| campaign_name | string | 共享 | 营销活动名称 |
| trigger_type | string | 共享 | 发送触发器。api / console / test / journey / recurring / system |
| journey_id | string | 共享 | 自动化标识符 |
| journey_name | string | 共享 | 自动化名称 |
| journey_step_id | string | 共享 | 自动化动作标识符 |
| journey_enrollment_id | string | 共享 | 自动化执行标识符 |
| recurring_message_id | string | 共享 | 重复发送消息标识符 |
| sender | string | 共享 | 发件方。SMS=发送号码,Email=发件邮箱 |
| recipient | string | 共享 | 收件方。SMS/Kakao=接收号码,Email=收件邮箱 |
| subject | string | 共享 | 标题。push/sms/email=标题,通知消息=强调标记型标题,品牌消息=页眉 |
| body | string | 共享 | 正文(interpolation 之前的原文)。Email 不包含 |
| template_id | string | 共享 | 模板标识符 (push / kakaoalimtalk / email) |
| template_name | string | 共享 | 模板名称 (push / kakaoalimtalk / email) |
| provider | string | 共享 | 推送提供商。fcm / apns / webpush(仅限 Push) |
| provider_message_id | string | 共享 | 提供商侧消息 ID(仅限 Push) |
| provider_error | string | 共享 | 提供商侧错误消息(仅限 Push) |
| error | string | 共享 | 错误/失败原因(failed·undelivered·aborted 时) |
| platform | string | 共享 | 终端平台。android / ios / webDesktop / webMobile |
| message_type | string | 共享 | 消息类型。SMS=SMS/LMS/MMS,Kakao=消息类型 |
| is_advertisement | boolean | 共享 | 是否为广告(SMS / 品牌消息) |
| kakaoalimtalk_template_code | string | 渠道专有 | Kakao 审核模板代码(仅限通知消息) |
| kakao_sender_key | string | 渠道专有 | Kakao 发送配置文件(渠道)密钥(仅限品牌消息) |
| iam_group | string | 渠道专有 | 应用内分组/分类(仅限 InAppMessage) |
| iam_clickable_id | string | 渠道专有 | CTA 按钮标识符(仅限 iam.clicked) |
| iam_dont_show_minutes | int | 渠道专有 | "不再显示"的分钟数值(仅限 iam.closed)。为 0/null 时表示单纯关闭,为正数时表示 N 分钟内不显示 |
| projectid | string | 分区 | FlareLane 项目标识符 |
| date | string | 分区 | 从 time 派生的 YYYY-MM-DD (UTC) |
channel 值为 push / sms / kakaoalimtalk / kakaobrandmessage / email / iam 之一。
*.created:发送请求已创建*.sent:Provider 正常受理*.aborted:因频率限制 / 拒收 / Liquid 中断等策略·条件原因而未发送。原因记录在 error 中*.failed:因 Provider 错误而发送失败*.delivered/*.undelivered:接收终端送达成功/失败
| type | 说明 |
|---|
| push.created | 推送发送请求已创建(PNS 调用前) |
| push.sent | 推送发送成功(PNS 正常响应) |
| push.aborted | 推送发送中止(频率限制/拒收/Liquid 等) |
| push.failed | 推送发送失败(provider/技术错误) |
| push.clicked | 用户点击了推送 |
| type | 说明 |
|---|
| sms.created | SMS 发送请求已创建(Provider 调用前) |
| sms.sent | 已被 Provider 正常受理 |
| sms.aborted | 发送中止(频率限制/拒收/Liquid 等) |
| sms.failed | Provider 受理失败 |
| sms.delivered | 已送达至接收终端(基于 Provider 回调) |
| sms.undelivered | 接收终端送达失败(基于 Provider 回调) |
| type | 说明 |
|---|
| kakaoalimtalk.created | 通知消息发送请求已创建(Provider 调用前) |
| kakaoalimtalk.sent | 已被 Provider 正常受理 |
| kakaoalimtalk.aborted | 发送中止(频率限制/拒收/Liquid 等) |
| kakaoalimtalk.failed | Provider 受理失败 |
| kakaoalimtalk.delivered | 已送达至接收终端(基于 Provider 回调) |
| kakaoalimtalk.undelivered | 接收终端送达失败(基于 Provider 回调) |
| type | 说明 |
|---|
| kakaobrandmessage.created | 品牌消息发送请求已创建(Provider 调用前) |
| kakaobrandmessage.sent | 已被 Provider 正常受理 |
| kakaobrandmessage.aborted | 发送中止(频率限制/拒收/Liquid 等) |
| kakaobrandmessage.failed | Provider 受理失败 |
| kakaobrandmessage.delivered | 已送达至接收终端(基于 Provider 回调) |
| kakaobrandmessage.undelivered | 接收终端送达失败(基于 Provider 回调) |
| type | 说明 |
|---|
| email.created | 邮件发送请求已创建 |
| email.sent | Provider 受理完成 |
| email.delivered | 已送达至接收邮件服务器 |
| email.failed | Provider 受理失败 |
| email.aborted | 发送中止(频率限制/拒收/Liquid 等) |
| email.complaint | 发生垃圾邮件举报 |
| email.opened | 收件人打开了邮件 |
| email.clicked | 收件人点击了邮件内的链接 |
| type | 说明 |
|---|
| iam.created | 应用内消息展示请求已创建(服务器侧) |
| iam.displayed | 应用内消息在用户终端上展示(SDK 事件) |
| iam.clicked | 用户点击了应用内 CTA 按钮(SDK 事件) |
| iam.closed | 用户关闭了应用内消息(SDK 事件) |
各渠道填充的列及其含义。表中未列出的列在该渠道中始终为 null。
| 列 | 必填 | 说明 |
|---|
| campaign_id | required | 营销活动标识符 |
| campaign_name | optional | 营销活动名称 |
| template_id | optional | 模板标识符 |
| template_name | optional | 模板名称 |
| subject | optional | 推送标题(interpolation 之前的原文) |
| body | optional | 推送正文(interpolation 之前的原文) |
| trigger_type | optional | api / console / test / journey 等 |
| journey_* | optional | 自动化上下文 |
| recurring_message_id | optional | 重复发送消息标识符 |
| platform | required | 终端平台 |
| provider | optional | 推送提供商 (fcm / apns / webpush) |
| provider_message_id | optional | 提供商侧消息 ID |
| provider_error | optional | 提供商侧错误消息 |
| error | optional | 错误/失败原因 |
| 列 | 必填 | 说明 |
|---|
| campaign_id | required | 营销活动标识符 |
| campaign_name | optional | 营销活动名称 |
| message_type | required | 消息类型。SMS / LMS / MMS |
| subject | optional | LMS/MMS 标题 |
| body | required | 正文(interpolation 之前的原文) |
| sender | required | 发送号码 |
| recipient | optional | 接收号码 |
| is_advertisement | required | 是否为广告 |
| trigger_type | optional | 发送触发器 |
| journey_* | optional | 自动化上下文 |
| recurring_message_id | optional | 重复发送消息标识符 |
| platform | optional | 终端/发送平台 |
| error | optional | 错误/失败原因 |
| 列 | 必填 | 说明 |
|---|
| campaign_id | required | 营销活动标识符 |
| campaign_name | optional | 营销活动名称 |
| template_id | required | FlareLane 内部模板标识符 |
| kakaoalimtalk_template_code | required | Kakao 审核模板代码 |
| template_name | optional | 模板名称 |
| subject | optional | 强调标记型标题 |
| body | required | 正文(interpolation 之前的原文) |
| recipient | required | 接收号码 |
| message_type | required | 消息类型 |
| trigger_type | optional | 发送触发器 |
| journey_* | optional | 自动化上下文 |
| recurring_message_id | optional | 重复发送消息标识符 |
| platform | optional | 终端/发送平台 |
| error | optional | 错误/失败原因 |
| 列 | 必填 | 说明 |
|---|
| campaign_id | required | 营销活动标识符 |
| campaign_name | optional | 营销活动名称 |
| kakao_sender_key | optional | Kakao 发送配置文件(渠道)密钥 |
| body | required | 正文(interpolation 之前的原文) |
| subject | optional | 消息页眉 |
| recipient | required | 接收号码 |
| message_type | required | 消息类型 |
| is_advertisement | optional | 是否为广告 |
| trigger_type | optional | 发送触发器 |
| journey_* | optional | 自动化上下文 |
| recurring_message_id | optional | 重复发送消息标识符 |
| platform | optional | 终端/发送平台 |
| error | optional | 错误/失败原因 |
| 列 | 必填 | 说明 |
|---|
| campaign_id | required | 营销活动标识符 |
| campaign_name | optional | 营销活动名称 |
| template_id | required | 模板标识符 |
| template_name | optional | 模板名称 |
| subject | optional | 邮件标题 |
| sender | required | 发件邮箱地址 |
| recipient | optional | 收件邮箱地址 |
| trigger_type | optional | 发送触发器 |
| journey_* | optional | 自动化上下文 |
| recurring_message_id | optional | 重复发送消息标识符 |
| platform | optional | 终端/发送平台 |
| error | optional | 错误/失败原因 |
| 列 | 必填 | 说明 |
|---|
| campaign_id | required | 营销活动标识符 |
| campaign_name | optional | 营销活动名称 |
| iam_group | required | 应用内分组/分类 |
| trigger_type | optional | console / journey(应用内仅使用这两种) |
| journey_* | optional | 自动化上下文 |
| platform | optional | 终端平台。仅在 SDK 事件时填充(iam.created 中为 null) |
| iam_clickable_id | optional | CTA 按钮标识符。仅限 iam.clicked |
| iam_dont_show_minutes | optional | "不再显示"的分钟数值。仅限 iam.closed。为 0/null 时表示单纯关闭,为正数时表示 N 分钟内不显示 |
客户事件(自定义跟踪事件)具有无 schema 的 data 属性,并与 crm_events 采用独立管道写入。
| 字段 | 类型 | 必填 | 说明 |
|---|
| id | string | required | 事件唯一标识符 (ULID) |
| type | string | required | 事件类型 |
| time | string | required | 事件发生时刻 (RFC 3339, UTC) |
| projectid | string | required | FlareLane 项目标识符 |
| userid | string | optional | FlareLane 用户标识符(未识别用户时为 null) |
| deviceid | string | optional | FlareLane 设备标识符 |
| data | string | optional | 事件发布时一并传入的自定义属性对象。键·值·类型可自由定义的无 schema 值,经序列化(stringify)后存储为单个 string 列。 |
| platform | string | optional | 终端平台。android / ios / webDesktop / webMobile |