การเชื่อมโยงบัญชีเชื่อมการระบุตัวตนระดับอุปกรณ์ของ TRACIO เข้ากับแนวคิดเรื่องผู้ใช้ของคุณเอง เมื่อส่ง ID บัญชีภายในเป็น 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>หากคุณใช้ @tracio/sdk ให้ส่ง linkedId ในคอนฟิก:
import { Tracio } from "@tracio/sdk"
const tracio = Tracio.init({ publicKey: "5ca175fc...", linkedId: user.id,})linkedId ถูกอ่านเพียงครั้งเดียว ณ ตอนที่เอเจนต์โหลด หากแท็กสคริปต์หรือการเรียก Tracio.init() ทำงานก่อนเข้าสู่ระบบ คุณต้องแน่ใจว่า linkedId ถูกส่งไปทันทีที่ทราบสถานะการยืนยันตัวตน:
lid=ACCOUNT_IDTracio.init() ซ้ำด้วย publicKey เดิมจะคืนอินสแตนซ์ที่มีอยู่และเพิกเฉยต่อคอนฟิกใหม่ — มัน ไม่ รับค่า linkedId ให้เรียก tracio.destroy() ก่อน แล้วจึงเรียก Tracio.init({ publicKey, linkedId: user.id }) หรืออีกทางหนึ่ง ให้เลื่อนการเรียก Tracio.init() ครั้งแรกออกไปจนกว่าจะทราบสถานะการยืนยันตัวตนของผู้ใช้linkedId เฉพาะหลังการเข้าสู่ระบบจริงเท่านั้น อย่าส่งให้ผู้เยี่ยมชมทั่วไปหรือผู้ใช้นิรนามเด็ดขาด และอย่าใช้ค่าแทนอย่าง "guest" หรือ "anonymous" — ค่าแทนที่ใช้ร่วมกันจะรวมคนที่ไม่เกี่ยวข้องกันเข้าเป็นบัญชีเดียวlinkedId จะถูกตัดที่ 256 ไบต์ ID ทั่วไปสั้นกว่านั้นมาก อย่าส่งโทเคนขนาดใหญ่ (เช่น JWT แบบเต็ม)linkedId ถูกจัดเก็บพร้อมข้อมูลอีเวนต์อื่น ๆ ของเวิร์กสเปซ และแสดงกลับให้คุณในแดชบอร์ดในฐานะตัวระบุบัญชีบนหน้า Connections — ค่านี้ไม่ถูกแฮชหรือทำให้นิรนามตอนแสดงผล เพราะคุณจำเป็นต้องจดจำบัญชีนั้นได้
ส่วนภายในระบบ การจับคู่ข้ามอุปกรณ์ของ TRACIO (การตรวจจับ fanout, เส้นฐานพฤติกรรม ATO) ใช้แฮชทางเดียวแยกต่างหากที่จำกัดตามสภาพแวดล้อมซึ่งคำนวณจาก linkedId — ไม่เคยใช้ค่าดิบ ดังนั้นตรรกะการจับคู่จึงไม่ขึ้นกับค่าที่เป็นข้อความล้วน และไม่เปิดเผยค่านั้นออกไปนอกแดชบอร์ดและเว็บฮุกของคุณเอง
ด้วยเหตุนี้ linkedId จึงควรเป็น ID ภายในที่ไม่สื่อความหมาย ไม่ใช่อีเมลหรือชื่อ (ดู กฎ): ค่านี้ปรากฏต่อคุณในฐานะตัวระบุบัญชี จึงไม่ควรบรรจุข้อมูลส่วนบุคคลมากไปกว่าที่คุณมีอยู่แล้ว
s.js (หรือคำขอระบุตัวตนของเอเจนต์) มีทั้งพารามิเตอร์ k= และ lid=linkedId หน้าดังกล่าวจะแสดงประกาศการตั้งค่า ประกาศนี้จะหายไปภายในไม่กี่นาทีหลังคำขอแรกที่มี lid=เมื่อ linkedId เริ่มไหลเข้ามา TRACIO จะเปิดใช้: