タグやSDKなどから送信するイベントでは、KARTEの内部的な仕様などにより、下記に合致するイベント名、フィールド名、フィールド値は使用が非推奨となっています。

使用できないイベント名

  • 下記の文字以外の文字を使っているイベント名
    • 半角英字（小文字）、半角数字、_(アンダースコア)
  • KARTEで予約されたイベント名と一致するイベント名（同じイベントとして管理したい場合は使用可能）
  • 他のイベント（削除済みイベントを含む）と重複するイベント名

※大文字での入力は一部機能で意図しない動作になる可能性があり非推奨とさせていただいております

使用できないフィールド名

  • 下記の条件に合致するフィールド名
    • 日本語などのマルチバイト文字を含む
    • null, null byte, ., $を含む
  • 下記に一致するフィールド名
    • type
    • count
    • first
    • last
    • any
    • prev
    • o
    • f_t
    • l_t
    • v
    • min
    • max
    • sum
    • avg
    • span
    • count_sets
    • sets
    • lrus
    • size
    • keys
    • cache
    • date
    • _source
    • _system
    • access
    • session

使用できないフィールド値

  • 下記の条件に合致するフィールド値
    • null byteを含む
  • 下記に一致するフィールド値
    • null
    • undefined

定義済みイベント

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等)