タグや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

    • jwt

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

  • 下記の条件に合致するフィールド値

    • null byteを含む

  • 下記に一致するフィールド値

    • null

    • undefined

定義済みイベント

KARTEでは、意味をあらかじめ定義されたイベント名が存在します。例えば、 viewbuy などがそれにあたり、該当のイベント名でイベントを送信すると、KARTEとしては閲覧購入として認識し集計や表示を行います。以下に、定義済みイベントを紹介します。

1. ユーザーの行動・属性を知るためのイベント

Event NameDisplay Name
view閲覧
reqreq
identifyユーザー情報
merge_userユーザーの統合
buy購入
signup会員登録
contact問い合わせ
cartカート
linkリンククリック
formサイト内のフォーム
enter_groupセグメントに入る
leave_groupセグメントから出る

2. 接客サービス関連の定義済みイベント

Event NameDisplay 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 NameDisplay NameCategoryDescription
talk_message_sendTalkメッセージ送信共通エンドユーザへのメッセージ送信
talk_message_openTalkメッセージ開封共通(既読が取れるもののみ)メッセージ開封
message_replyメッセージに返信共通エンドユーザからのメッセージ送信
talk_message_failTalkメッセージ送信失敗共通送信失敗
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-SendGridSendGrid側でメールを配信しなかった (Quotaを超えたなど)
sendgrid_spamreport-SendGrid受信者にスパム判定された
plugin_line_identify-LINELINEの許可または拒否を選択 (subscribe=true が許可、subscribe=false が拒否)
line_add_friendLINE友だち追加LINELINEで企業アカウントを友だち追加またはブロック解除
line_block_friendLINEブロックLINELINEで企業アカウントをブロック
line_messageLINEメッセージLINEエンドユーザーからLINEでメッセージが送信
line_id_connectedLINE ID連携完了LINEKARTEの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等)