このドキュメントでは、チャネルトークSDK(以下 SDK)のイベントについて説明します。
イベント(Event)とは、Webサイトやアプリケーション内で発生するユーザーの行動を指し、ビジネスに関連するあらゆるイベントを定義できます。
SDKはデフォルトで以下のイベントを提供します。
PageView: 顧客が特定のページを閲覧した際のイベントUserChatOpen: 顧客が接客チャットを新規に開いた際のイベントMarketingView: 顧客がマーケティングメッセージを閲覧した際のイベントMarketingClick: 顧客がマーケティングメッセージ内に含まれるURLリンクをクリックした際に発生するイベントMarketingGoal: マーケティングメッセージにおいて目標として設定したイベント値が発生した際のイベント
プロパティ(Property)は、イベントを説明する詳細情報です。プロパティデータに基づいて、イベントをより詳細に把握し、適切な意思決定を行うのに役立ちます。
配列またはオブジェクト値を含むイベントプロパティの最大サイズは4KBです。
認識可能な英数字値(alphanumeric)であり、以下のような例があります。
name = "Get Up",type = "EP"
最大長:属性ごとに512バイトに制限されます。
文字エンコーディングによって、各文字に必要なバイト数が異なる場合があります。
他の定義済みデータ型に一致しない属性値はすべて文字列として扱われます。
数値(整数または小数)を表します。例は以下の通りです。
revenue = 15.00,quantity = 5.
true/falseを明示的に使用して表現します。例は以下の通りです。Favorite = true,Bookmarked = false.
現在ブール値でない値はブール値に変換できません。
日付(Date):時刻情報を含まないカレンダー日付(YYYY-MM-DD)を表します。許可される形式は以下の通りです。
ISO Date 文字列(例:「2025-06-17」)
日付時刻(DateTime):日付、時刻、タイムゾーンを含む特定の時点を表します。値は比較のためにUTCに正規化されます。許可される形式は以下の通りです。
ISO 8604文字列(例:「2025-06-17T14:30:00Z」)
ミリ秒単位のUnixタイムスタンプ
文字列または数値を含むJSON配列。例:
Favorite Genres =
["Folk", "Alternative"]Favorite Numbers =
[1, 5, 10.0]
文字列と数値タイプのみサポートされます。
同一のキー値(key-value)構造を持つ、1段階ネストされたJSONオブジェクトの配列。例:
Cart =
[{"Brand":"Puma","Category":"Jacket","Price":30}, {"Brand":"Adidas","Category":"Hats","Price":15}]
各リストの最初の5つのオブジェクトのみがサポートされます。
チャネルトークでは、ネストされたオブジェクトは最大1階層まで認識します。
各SDKの使用例は以下の通りです。
基本で提供される5つのイベントと、コマース連携を通じて受け取ったイベントは翻訳を提供しています。以下はコマース連携イベントが詳細に説明されているページです。