CRMイベントのエクスポートで蓄積される FlareLane CRM イベントのスキーマです。
| カラム | 型 | 区分 | 説明 |
|---|
| 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(アプリ内メッセージはこの 2 つのみ使用) |
| 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 分間非表示 |
顧客イベント(カスタムトラッキングイベント)はスキーマレスな 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 | イベント発行時に併せて渡したカスタム属性オブジェクト。キー・値・型を自由に定義するスキーマレスな値で、シリアライズ(stringify)して単一の string カラムに保存。 |
| platform | string | optional | 端末プラットフォーム。android / ios / webDesktop / webMobile |