קישור חשבונות

קישור חשבונות מחבר את הזיהוי ברמת המכשיר של TRACIO לתפיסת המשתמש שלכם. בהעברת מזהה החשבון הפנימי כ-linkedId אתם אומרים ל-TRACIO אילו visitor ID שייכים לאותו אדם מאומת — בין דפדפנים, מכשירים והפעלות.

מה זה

כל מבקר ש-TRACIO רואה מקבל מזהה ברמת המכשיר (ראו זיהוי). המזהה הזה כשלעצמו אינו יודע דבר על המשתמשים שלכם — הוא רק מזהה מכשירים שחוזרים.

linkedId סוגר את הפער: זהו ה-accountId של המשתמש המאומת כרגע, שנשלח לצד בקשת הזיהוי הרגילה. כששני visitor ID או יותר חולקים את אותו linkedId, TRACIO מקשר ביניהם לחשבון אחד, וזה מה שמפעיל את עמוד Connections בלוח, את הזהות חוצת המכשירים ואת זיהוי הסטייה בהשתלטות על חשבון (ATO) — ראו מה מקבלים.

בלי linkedId, TRACIO רואה רק מכשירים אנונימיים ואין לו דרך לקבץ אותם לפי חשבון.

הגדרה מהירה

קישור חשבונות הוא פרמטר נוסף על האינטגרציה שכבר יש לכם. אין צורך בקוד צד שרת.

תגית סקריפט

הוסיפו 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>

SDK

אם אתם משתמשים ב-@tracio/sdk, העבירו את linkedId בתצורה:

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({
  publicKey: "5ca175fc...",
  linkedId: user.id,
})

אפליקציות עמוד יחיד

linkedId נקרא פעם אחת בלבד, ברגע טעינת הסוכן. אם תגית הסקריפט או הקריאה ל-Tracio.init() רצה לפני ההתחברות, ודאו ש-linkedId נכלל ברגע שמצב האימות ידוע:

• תגית סקריפט: לאחר ההתחברות הכניסו את התגית מחדש (או רעננו את העמוד) עם lid=ACCOUNT_ID.
• SDK: קריאה נוספת ל-Tracio.init() עם אותו publicKey מחזירה את המופע הקיים ומתעלמת מהתצורה החדשה — היא אינה קולטת את linkedId. קראו תחילה ל-tracio.destroy() ואז ל-Tracio.init({ publicKey, linkedId: user.id }). לחלופין, דחו את הקריאה הראשונה ל-Tracio.init() עד שמצב האימות של המשתמש ידוע.

כללים

• משתמשים מאומתים בלבד. שלחו linkedId רק לאחר התחברות אמיתית. לעולם אל תשלחו אותו עבור אורחים או מבקרים אנונימיים, ולעולם אל תיפלו לערך ממלא מקום כמו "guest" או "anonymous" — ערך ממלא מקום משותף ממזג אנשים שאינם קשורים לאותו חשבון.
• השתמשו במזהה פנימי יציב. מזהה מספרי או UUID מטבלת המשתמשים שלכם הוא האידיאלי. אל תשתמשו בכתובת דוא"ל או בשם: מזהה פנימי אינו משתנה כשהמשתמש מעדכן את הדוא"ל שלו, וכך נמנע שליחת מידע מזהה שאינכם זקוקים לו.
• מגבלת 256 בתים. linkedId נחתך ב-256 בתים. מזהים רגילים נמוכים בהרבה מכך; אל תעבירו אסימונים גדולים (למשל JWT מלאים).

פרטיות

linkedId נשמר לצד שאר נתוני האירועים של סביבת העבודה שלכם ומוצג לכם חזרה בלוח כמזהה החשבון בעמוד Connections — הוא אינו עובר גיבוב או אנונימיזציה לצורך התצוגה, מכיוון שאתם צריכים לזהות את החשבון.

באופן פנימי, ההתאמה חוצת המכשירים של TRACIO (זיהוי fanout, קווי בסיס התנהגותיים ל-ATO) משתמשת בגיבוב חד-כיווני נפרד ומוגבל-סביבה של linkedId — לעולם לא בערך הגולמי. כך לוגיקת ההתאמה אינה תלויה בערך הגלוי ואינה חושפת אותו מעבר ללוח ולוובהוקים שלכם.

לכן linkedId צריך להיות מזהה פנימי אטום ולא כתובת דוא"ל או שם (ראו כללים): הוא גלוי לכם כמזהה החשבון שלכם, ולכן אין סיבה שיישא יותר מידע אישי ממה שכבר יש לכם.

בדיקה שזה עובד

1. לשונית Network. לאחר ההתחברות פתחו DevTools ← Network וּודאו שהבקשה אל s.js (או בקשת הזיהוי של הסוכן) כוללת גם את k= וגם את lid=.
2. לוח הבקרה. פתחו את עמוד Connections בסביבת העבודה שלכם. כל עוד linkedId אינו משולב, מוצגת שם הודעת הגדרה; ההודעה נעלמת בתוך דקות ספורות מהבקשה הראשונה שנושאת lid=.

מה מקבלים

ברגע ש-linkedId זורם, TRACIO פותח:

• עמוד Connections — חשבונות שחולקים מכשיר אחד או יותר, עם עוצמת הקישור, דפדפנים ומדינות משותפים וגרף חקירה למיון חפיפות חשודות.
• זהות חוצת מכשירים — אותו אדם מזוהה בטלפון, במחשב הנייד ובדפדפנים שונים, בלי להסתמך על עוגיות בלבד.
• זיהוי סטייה בהשתלטות על חשבון (ATO) — קו בסיס התנהגותי לכל חשבון, כך שהפעלות החורגות מהמכשירים והדפוסים המבוססים של החשבון יסומנו גם כשפרטי ההתחברות נכונים.