ربط الحسابات

يربط ربط الحسابات تعريفَ 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 عبر الأجهزة (اكتشاف التوزّع، وخطوط الأساس السلوكية لـ ATO) تجزئة أحادية الاتجاه منفصلة ومحصورة بالبيئة تُحسب من linkedId — وليس القيمة الخام أبدًا. وبذلك لا يعتمد منطق المطابقة على القيمة الصريحة ولا يكشفها خارج لوحتك وويب هوك الخاصة بك.

لهذا ينبغي أن يكون linkedId معرّفًا داخليًا غير مُفصِح، لا عنوان بريد إلكتروني أو اسمًا (راجع القواعد): فهو ظاهر لك بوصفه معرّف حسابك، ومن ثَم لا ينبغي أن يحمل معلومات شخصية أكثر مما لديك بالفعل.

التحقق من أنه يعمل

1. تبويب الشبكة. بعد تسجيل الدخول، افتح DevTools ← Network وتأكد من أن الطلب إلى s.js (أو طلب التعريف الصادر عن الوكيل) يتضمن المعاملين k= وlid= معًا.
2. لوحة التحكم. افتح صفحة Connections في مساحة عملك. وطالما لم يُدمَج linkedId، سيظهر إشعار إعداد؛ ويختفي هذا الإشعار خلال دقائق قليلة من أول طلب يحمل lid=.

ما الذي تحصل عليه

بمجرد أن يبدأ linkedId بالتدفق، تُفعِّل TRACIO ما يلي:

• صفحة Connections — الحسابات التي تتشارك جهازًا واحدًا أو أكثر، مع قوة الارتباط والمتصفحات والدول المشتركة، ومخطط تحقيق لفرز التداخلات المشبوهة.
• الهوية عبر الأجهزة — التعرّف على الشخص نفسه على هاتفه وحاسوبه المحمول ومتصفحاته المختلفة، دون الاعتماد على ملفات تعريف الارتباط وحدها.
• اكتشاف الانحراف عند الاستيلاء على الحساب (ATO) — خط أساس سلوكي لكل حساب، بحيث يمكن الإشارة إلى الجلسات التي تحيد عن أجهزة الحساب وأنماطه المعتادة حتى عندما تكون بيانات الاعتماد صحيحة.