アカウント連携は、TRACIO のデバイス単位の識別を、御社が持つ「ユーザー」の概念と結び付けます。社内のアカウント ID を linkedId として渡すことで、どの visitor ID が同一の認証済みユーザーに属するかを TRACIO に伝えられます。ブラウザ、デバイス、セッションをまたいで機能します。
TRACIO が認識するすべての訪問者には、デバイス単位の識別子が割り当てられます(識別を参照)。この識別子だけでは御社のユーザーについては何も分からず、再訪したデバイスを認識するだけです。
linkedId はこのギャップを埋めます。これは現在認証されているユーザーの accountId で、通常の識別リクエストと併せて送信します。2 つ以上の visitor ID が同じ linkedId を共有すると、TRACIO はそれらを 1 つのアカウントに連携します。これがダッシュボードの Connections ページ、クロスデバイス ID、アカウント乗っ取り(ATO)のドリフト検知を支えています。利用できるようになる機能をご覧ください。
linkedId がなければ、TRACIO には匿名のデバイスしか見えず、アカウント単位でグループ化する手段がありません。
アカウント連携は、既存の実装に追加するパラメータです。バックエンドの実装は不要です。
既存の script タグに、パブリックキーと並べて lid を追加します。
<!-- 変更前 --><script src="https://edge.tracio.ai/s.js?k=PUBLIC_KEY" async></script>
<!-- 変更後(ユーザーが認証済みの場合のみ) --><script src="https://edge.tracio.ai/s.js?k=PUBLIC_KEY&lid=ACCOUNT_ID" async></script>@tracio/sdk をご利用の場合は、設定で linkedId を渡します。
import { Tracio } from "@tracio/sdk"
const tracio = Tracio.init({ publicKey: "5ca175fc...", linkedId: user.id,})linkedId はエージェントの読み込み時に一度だけ読み取られます。script タグや Tracio.init() の呼び出しがログイン前に実行される場合は、認証状態が判明した時点で linkedId が含まれるようにしてください。
lid=ACCOUNT_ID を付けてタグを挿入し直す(またはページを再読み込みする)。publicKey で Tracio.init() を再度呼び出しても、既存のインスタンスが返され新しい設定は無視されます。linkedId は 反映されません。まず tracio.destroy() を呼び出し、その後 Tracio.init({ publicKey, linkedId: user.id }) を実行してください。あるいは、ユーザーの認証状態が判明するまで最初の Tracio.init() を遅らせる方法もあります。linkedId は実際のログイン後にのみ送信してください。ゲストや匿名の訪問者に対しては決して送らず、"guest" や "anonymous" のようなプレースホルダーで代用しないでください。共通のプレースホルダー値は、無関係な人物を同一アカウントに統合してしまいます。linkedId は 256 バイトで切り詰められます。通常の ID は十分に収まります。大きなトークン(完全な JWT など)は渡さないでください。linkedId はワークスペースの他のイベントデータと共に保存され、ダッシュボードの Connections ページでアカウント識別子として表示されます。アカウントを識別する必要があるため、表示時にハッシュ化や匿名化は行いません。
一方、内部処理における TRACIO のクロスデバイス照合(ファンアウト検知、ATO の行動ベースライン)では、linkedId から環境ごとに算出した別個の一方向ハッシュのみを使用し、生の値は使いません。したがって照合ロジックが平文の値に依存することはなく、御社自身のダッシュボードと Webhook を超えて値が露出することもありません。
そのため linkedId は、メールアドレスや氏名ではなく不透明な内部 ID にすべきです(ルールを参照)。この値はアカウント識別子として御社に表示されるため、すでにお持ちの情報以上の個人情報を含めるべきではありません。
s.js へのリクエスト(またはエージェントの識別リクエスト)に k= と lid= の両方のパラメータが含まれていることを確認します。linkedId が未実装のうちはセットアップの案内が表示され、lid= を含む最初のリクエストから数分以内に消えます。linkedId が届くようになると、TRACIO では次の機能が有効になります。