LAMPData 360連携(オプション)Data 360に入るデータを確認したい

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 MemberLAMP が把握したグループのメンバー。表示名、参加状態、友だちへの参照 など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」)
isAiAutoReplyAI が自動で返信した行は 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 キー
  • 連携を設定する前の会話(「過去の会話を送る」で送れます)