タグやSDKなどから送信するイベントでは、KARTEの内部的な仕様などにより、下記に合致するイベント名、フィールド名、フィールド値は使用が非推奨となっています。
使用できないイベント名
- 下記の文字以外の文字を使っているイベント名
- 半角英字（小文字）、半角数字、
_(アンダースコア)
- 半角英字（小文字）、半角数字、
- KARTEで予約されたイベント名と一致するイベント名（同じイベントとして管理したい場合は使用可能）
_で始まるイベント名- その他、定義済みイベント
- 他のイベント（削除済みイベントを含む）と重複するイベント名
※大文字での入力は一部機能で意図しない動作になる可能性があり非推奨とさせていただいております
使用できないフィールド名
- 下記の条件に合致するフィールド名
- 日本語などのマルチバイト文字を含む
null,null byte,.,$を含む
- 下記に一致するフィールド名
typecountfirstlastanyprevof_tl_tvminmaxsumavgspancount_setssetslrussizekeyscachedate_source_systemaccesssession
使用できないフィールド値
- 下記の条件に合致するフィールド値
null byteを含む
- 下記に一致するフィールド値
nullundefined
定義済みイベント
KARTEでは、意味をあらかじめ定義されたイベント名が存在します。例えば、 view や buy などがそれにあたり、該当のイベント名でイベントを送信すると、KARTEとしては閲覧 や購入として認識し集計や表示を行います。以下に、定義済みイベントを紹介します。
1. ユーザーの行動・属性を知るためのイベント
| Event Name | Display Name |
|---|---|
| view | 閲覧 |
| req | req |
| identify | ユーザー情報 |
| merge_user | ユーザーの統合 |
| buy | 購入 |
| signup | 会員登録 |
| contact | 問い合わせ |
| cart | カート |
| link | リンククリック |
| form | サイト内のフォーム |
| enter_group | セグメントに入る |
| leave_group | セグメントから出る |
2. 接客サービス関連の定義済みイベント
| Event Name | Display Name |
|---|---|
| message_read | 接客サービスを表示準備 |
| message_open | 接客サービスを表示 |
| message_click | 接客サービスをクリック |
| message_link_click | メール上のリンククリックを計測 |
| message_close | 接客サービスを閉じる |
| message_suppressed | 接客サービスを表示抑制 |
| message_state_changed | 接客サービスの状態変化 |
| script_fired | スクリプト実行 |
| answer_question | アンケート回答 |
| cookie_data | クッキーデータ |
| recent_items | 直近閲覧アイテム |
| favorite_items | お気に入りアイテム |
| scroll | スクロール情報 |
3. KARTE Talk関連の定義済みイベント
| Event Name | Display Name | Category | Description |
|---|---|---|---|
| talk_message_send | Talkメッセージ送信 | 共通 | エンドユーザへのメッセージ送信 |
| talk_message_open | Talkメッセージ開封 | 共通(既読が取れるもののみ) | メッセージ開封 |
| message_reply | メッセージに返信 | 共通 | エンドユーザからのメッセージ送信 |
| talk_message_fail | Talkメッセージ送信失敗 | 共通 | 送信失敗 |
| webchat_read | チャット未読/既読 | チャット | チャット未読または既読 |
| chat_open | - | チャット | チャットのLauncher (アイコン)が表示された (chat.open APIが呼び出された) |
| chat_close | - | チャット | チャットのLauncher (アイコン)が非表示になった (chat.close API が呼び出された) |
| chat_activate | - | チャット | チャットのChatPanel (チャットウインドウ)が表示された (chat.activate APIが呼び出された) |
| chat_deactivate | - | チャット | チャットの ChatPanel (チャットウインドウ)が非表示になった (chat.deactivate API が呼び出された) |
| chat_message_reply_failed | - | チャット | エンドユーザーからのチャットメッセージ送信が失敗した |
| sendgrid_delivered | - | SendGrid | メールが正常に到達 |
| sendgrid_bounce | - | SendGrid | メールが正常に到達しなかった。type=bounce がハードバウンス、type=blocked がソフトバウンス |
| sendgrid_dropped | - | SendGrid | SendGrid側でメールを配信しなかった (Quotaを超えたなど) |
| sendgrid_spamreport | - | SendGrid | 受信者にスパム判定された |
| plugin_line_identify | - | LINE | LINEの許可または拒否を選択 (subscribe=true が許可、subscribe=false が拒否) |
| line_add_friend | LINE友だち追加 | LINE | LINEで企業アカウントを友だち追加またはブロック解除 |
| line_block_friend | LINEブロック | LINE | LINEで企業アカウントをブロック |
| line_message | LINEメッセージ | LINE | エンドユーザーからLINEでメッセージが送信 |
| line_id_connected | LINE ID連携完了 | LINE | KARTEのLINEログイン機能でLINEログイン |
| plugin_push_apps_identify | - | ウェブプッシュ通知 | ウェブプッシュ通知に関する情報の同期 (subscribe=true が通知希望、falseが拒否) |
| push_apps_subscribe | - | ウェブプッシュ通知 | ウェブプッシュ通知の受け取りを希望する操作が発生 |
| push_apps_unsubscribe | - | ウェブプッシュ通知 | ウェブプッシュ通知の受け取りを拒否する操作が発生 |
| plugin_native_app_identify | ネイティブアプリ・プッシュ通知情報 | アプリプッシュ通知 | アプリプッシュ通知の許可または拒否を選択 |
| note | ノート | 管理画面 | ノートの追加 |
| manual_label | 手動ユーザーラベル | 管理画面 | ユーザーラベルの変更 |
| manual_chat_label | 手動チャットラベル | 管理画面 | チャットラベルの変更 (labels, add_labels, remove_labels等) |