Data 360に入るデータを確認したい
このガイドでは、以下をご紹介します
- 作られるデータモデルと、その結び付き
- 会話の項目と、行の種類
- グループトークの会話と、メッセージに紐づいたレコード
- ファイルの URL の扱いと、取り込まれないもの
データモデルと結び付き
| データモデル | 内容 | 取り込み方 |
|---|---|---|
| Igness LAMP Timeline | 会話。LAMP のタイムラインの1行が、1行になります | Igness のサーバーから送信 |
| Igness LAMP Friend | 友だち。表示名、ブロック、最終受信・最終送信日時、取引先責任者・リードへの参照 など | Salesforce の中で同期 |
| Igness LAMP Reply | 自動応答の設定 | Salesforce の中で同期 |
| Igness LAMP Broadcast | 配信 | Salesforce の中で同期 |
| Igness LAMP Group | グループ。グループ名、参加状態、人数、最終受信・最終送信日時 など | Salesforce の中で同期 |
| Igness LAMP Group Member | LAMP が把握したグループのメンバー。表示名、参加状態、友だちへの参照 など | Salesforce の中で同期 |
会話は、次の項目でほかのデータモデルに結び付きます(いずれも多対1)。
| 会話の項目 | 結び付く先 |
|---|---|
friendKey | 友だち。値は「公式アカウントのID:相手のID」です |
sourceReplyId | 自動応答 |
sourceBroadcastId | 配信 |
sourceUserId | ユーザー(Data 360 の標準の User)。ユーザーを取り込んでいる場合に有効になります |
groupId | グループ |
memberKey | グループメンバー。値は「グループのID:発言者のID」です |
友だちから先は、取引先責任者・リードへの参照をたどれます。グループメンバーも、その人が友だちであれば友だちに結び付きます。
会話の項目
| 項目 | 内容 |
|---|---|
eventId | 行の ID(主キー) |
occurredAt | 発生日時 |
lampId | 公式アカウントの ID(LAMP 上の ID) |
userId | 相手の ID(メッセージングアプリのユーザー ID。友だちの「UserId」と同じ値) |
friendKey | 友だちと結び付けるためのキー(lampId:userId) |
direction | 向き。inbound(受信)/outbound(送信) |
messageType | 行の種類(次の表) |
body | 読める本文。カード型のメッセージは、代替テキストが入ります |
messageData | メッセージの構造(JSON の文字列)。カードの中身、位置情報、クリックした URL など |
messageId | メッセージングアプリでのメッセージの ID。友だち追加などの出来事の行は、LAMP が付けた ID |
quotedMessageId | 引用して返信したメッセージの場合、引用元のメッセージの ID |
mediaUrl | 画像・動画・ファイルの参照(下の「ファイルの URL の扱い」) |
isDeleted | 送信を取り消したメッセージは true |
sourceType | 送信元の種別。user(担当者)、reply(自動応答)、broadcast(配信)、flow、template、richmenu、source。受信は friend、グループトークで受信した行は member |
sourceUserId / sourceReplyId / sourceBroadcastId | 送信元の Salesforce のレコード ID |
sourceTemplateId / sourceRichMenuId | 送信元のテンプレート・リッチメニューの Salesforce のレコード ID |
sourceFlowName | フローから送ったメッセージの、フローの名前(アクションの「Flow Name」) |
isAiAutoReply | AI が自動で返信した行は true。担当者が AI の下書きを使って送った行は false |
senderName | 送信元の表示名。LAMP の「送信元」を設定して送ったメッセージに、送信した時点の名前が入ります。設定していない場合は空 |
groupId | グループトークの会話は、グループの ID。1対1の会話は空 |
memberKey | グループメンバーと結び付けるためのキー(groupId:userId) |
recordId | メッセージに紐づいた Salesforce のレコード ID(18桁)。紐づいていなければ空 |
recordIdSource | レコードの決まり方。sent、quote、burst、inferred、manual(下の「メッセージに紐づいたレコード」) |
recordIdProbability | レコードを推定で決めたときの確からしさ(0〜1) |
editedAt | グループトークで発言が編集されたときの、編集の日時 |
計測リンクのクリックとコンバージョンの行には、次の項目も入ります。ほかの行では空です。
| 項目 | 内容 |
|---|---|
linkUrl | クリック・コンバージョンした URL |
clickId | クリックの ID。コンバージョンの行では、もとのクリックの ID |
conversionId | コンバージョンの ID(コンバージョンの行だけ) |
isRepeatConversion | 同じ人の2回目以降のコンバージョンは true |
linkChannel | クリックした計測リンクの種類。message(メッセージ内のリンク)、richmenu(リッチメニュー)、custom(計測URL) |
linkKey | クリックした計測リンクのキー |
isSuspiciousClick | 送信から数秒以内のクリック(プレビューによるものとみられる)は true。Salesforce のクリック数には数えません |
linkSendType / linkSendId | メッセージ内のリンクの場合、そのメッセージの送り方(broadcast:配信、reply:自動応答、push:個別の送信)と、配信・自動応答の ID。リッチメニューと計測URLのクリックでは空 |
行の種類(messageType)
メッセージだけでなく、友だち追加やリンクのクリックなどの出来事も、同じデータモデルに入ります。
| 種類 | 向き | 内容 |
|---|---|---|
MSG_TEXT MSG_IMAGE MSG_VIDEO MSG_AUDIO MSG_FILE MSG_STICKER MSG_LOCATION | 受信・送信 | メッセージ |
MSG_FLEX MSG_TEMPLATE MSG_IMAGEMAP | 送信 | カード型・ボタン型・画像マップ |
MSG_POSTBACK | 受信 | 相手がボタンやリッチメニューを押した |
ADD_FRIEND UNBLOCKED BLOCKED | 受信 | 友だち追加、ブロック解除、ブロック |
LOGIN | 受信 | 流入経路の URL を開いた(LINE ログイン) |
RICHMENU_CHANGED | 受信 | リッチメニューの切り替え |
LINK_CLICK | 受信 | 計測リンクのクリック。URL は linkUrl に入ります |
CONVERSION | 受信 | コンバージョン。URL は linkUrl、もとのクリックは clickId に入ります |
JOIN LEAVE MEMBERJOINED MEMBERLEFT | 受信 | グループトークで、公式アカウントがグループに参加・退出した、メンバーが参加・退出した |
グループトークの会話
グループトークの会話も、1対1の会話と同じデータモデルに入ります。グループの会話には groupId にグループの ID が入り、1対1の会話では空になるので、この項目でどちらの会話かを見分けられます。グループで受信した発言の userId は発言した人の ID で、sourceType は member になります。発言した人がその公式アカウントの友だちであれば、friendKey で友だちに結び付くので、友だちから取引先責任者・リードへたどって、その人がグループで話した内容も見ることができます。友だちではないメンバーの発言も入り、その場合は memberKey でグループメンバーにだけ結び付きます。
LAMP からグループへ送ったメッセージと、公式アカウントの参加・退出やメンバーの出入りの行には、発言した人がいないので userId は空です。メンバーが発言を編集すると、本文が編集後の内容に置き換わり、editedAt に編集の日時が入ります。
メッセージに紐づいたレコード
LAMP でメッセージをケースや商談などのレコードに紐づけている場合は、そのレコードの ID が recordId に入ります。レコードのページから送ったメッセージは、送ったときのレコードが入り、recordIdSource は sent です。お客様が引用して返信したときは引用元のレコードを引き継いで quote に、写真の連投のように直前のメッセージから引き継いだときは burst に、会話の内容から推定したときは inferred になり、推定の確からしさが recordIdProbability に入ります。担当者が紐づけを付け替えると manual になり、付け替えた内容は Data 360 にも反映されます。
紐づけ先のオブジェクトはお客様ごとに違うため、データキットには recordId からのリレーションを入れていません。ケースなどのデータモデルと結び付けて使いたい場合は、Data 360 で会話(Igness LAMP Timeline)の recordId から、そのオブジェクトのデータモデルへのリレーションを追加してください。
ファイルの URL の扱い
だれでも開ける URL は、Data 360 へ送りません。
| 場合 | Data 360 に入る値 |
|---|---|
| ファイルを非公開で保存している組織 | LAMP の非公開の参照(https://files.mylp.jp/…)。受信・送信とも |
| 上記以外の組織、非公開に切り替える前の会話 | 空。画像や動画があったことは messageType で分かります |
| カード型メッセージの中の画像、画像マップ、外部の画像 | 空。カードの構造・文言・ボタンは残ります |
| ボタンのリンク先、本文に書かれた URL、クリック・コンバージョンした URL | そのまま入ります |
非公開の参照は、Data 360 の画面からは開けません。ファイルを見るときは、友だちやグループのレコードから LAMP のチャット画面を開いてください。チャット画面は、その友だちやグループを見る権限のあるユーザーにだけ、ファイルを表示します。
取り込まれないもの
- 画像・動画・ファイルの原本
- 送信を取り消したメッセージの本文・構造・ファイルの参照(取り消した記録の行は残ります)
- 自動応答に設定した API キー
- 連携を設定する前の会話(「過去の会話を送る」で送れます)