التعرّف على المستخدمين
افتراضيًا، يتعامل عنصر واجهة المستخدم مع الزوار على أنهم مجهولون. استدعِ uj.identify لربط الملاحظات والتصويتات والتعليقات والإشعارات والمحادثات بحساب العميل.
التعرّف الأساسي على الهوية
uj.identify({
user: {
id: 'user-123',
email: 'ada@example.com',
firstName: 'Ada',
lastName: 'Lovelace',
avatar: 'https://example.com/avatar.jpg'
}
});user.id مطلوب. استخدم معرّفًا ثابتًا من قاعدة بياناتك بدلًا من عنوان بريد إلكتروني أو اسم عرض قد يتغير. أما email فهو اختياري، لكن يُوصى به بشدة حتى يتمكن UserJot من مطابقة المستخدم عبر لوحات النقاش وإعادة توجيه البريد الإلكتروني والمحادثات. لا يؤدي تمرير email إلى ربط المستخدم إلا بحساب UserJot موجود سبق تأكيد عنوان بريده الإلكتروني.
متى تستدعي identify
استدعِ uj.identify بعد أن يعرف تطبيقك هوية المستخدم المسجّل. إذا استدعيت الدالة مرة أخرى بالبيانات نفسها تمامًا بينما لا تزال الجلسة نشطة، فلن يحدث أي شيء. بعد انتهاء صلاحية الجلسة، أو عند تغيّر أي حقل (بما في ذلك البريد الإلكتروني أو traits)، ترسل SDK طلبًا جديدًا. يؤدي تمرير مستخدم مختلف إلى تبديل الجلسة فورًا.
عندما يسجّل المستخدم الخروج من تطبيقك، استدعِ uj.logout():
if (user) {
uj.identify({
user: {
id: user.id,
email: user.email,
firstName: user.firstName,
lastName: user.lastName
}
});
} else {
uj.logout();
}إضافة السمات
السمات هي خصائص مخصصة مرتبطة بملف تعريف العضو، وتظهر بجانب طلباته ومحادثاته في لوحة التحكم.
uj.identify({
user: {
id: 'user-123',
email: 'ada@example.com',
traits: {
plan: 'pro',
seats: 12,
trialing: false
}
}
});يمكن أن تكون قيم السمات سلاسل نصية أو أرقامًا أو قيمًا منطقية أو null (monthlySpend، عند إرساله، يجب أن يكون رقمًا غير سالب). يتم تجاهل المفاتيح المحجوزة (مثل id أو email أو role أو companies) والإبلاغ عنها في result.warnings. اطّلع على القائمة الكاملة في مرجع SDK.
إضافة الشركات
بالنسبة إلى منتجات B2B، أرفق شركة واحدة أو أكثر بالمستخدم:
uj.identify({
user: { id: 'user-123', email: 'ada@example.com' },
companies: [
{
id: 'acme',
name: 'ACME Inc.',
domain: 'acme.com',
logo: 'https://acme.com/logo.png',
traits: { plan: 'enterprise', arr: 24000 }
}
]
});id مطلوب لكل شركة. أما name وdomain وlogo (رابط HTTPS) وtraits فهي اختيارية. إذا كان الخيار Require signed tokens مفعّلًا في الإعدادات → تسجيل الدخول، فسيتم تجاهل الشركات المُمرّرة خارج JWT موقّع، مع إصدار تحذير UNSIGNED_COMPANY_IGNORED.
ما الذي تُعيده identify
بعد تحميل نص SDK البرمجي، تُعيد uj.identify وعدًا:
const result = await uj.identify({
user: { id: 'user-123', email: 'ada@example.com' }
});
result.viewer; // the identified user, or null
result.identityTrust; // 'signed' or 'unsigned'
result.warnings; // fields the server ignored or adjustedحدود المعدل والأخطاء
حدود المعدل والتراجع من جهة العميل: تخضع طلبات Identify لحد أقصى قدره 30 طلبًا في الدقيقة و300 طلب في الساعة لكل عنوان IP ومساحة عمل. يؤدي تجاوز الحد الأقصى للساعة إلى حظر لمدة ساعة واحدة. بعد تلقي HTTP
429، يفرض SDK فترة انتظار محلية (مع مراعاةRetry-After، وتقييدها بين ثانية واحدة وساعة واحدة، والمدة الافتراضية 60 ثانية) حتى تفشل محاولات إعادة الإرسال محليًا من دون إغراق واجهة API بالطلبات.المكالمات المرفوضة: إذا رفض الخادم طلب التعرف على المستخدم (مثلًا، بسبب رمز غير صالح، أو تفعيل اشتراط الرموز الموقّعة دون رمز، أو تعارض في البريد الإلكتروني يعيد
409، أو عضو محذوف بموجب اللائحة العامة لحماية البيانات (GDPR) يعيد403/member_erased)، فسيُرفض الوعد معIDENTIFY_FAILEDوسيظل الزائر مجهولًا.
الهوية والمحادثات
عند تفعيل المحادثات:
يتجاوز المستخدمون الذين تم التعرف عليهم مطالبة إدخال بيانات الزائر، ويتلقون ردود الفريق على البريد الإلكتروني المرتبط بحسابهم.
يحصل الزوار المجهولون على محادثات ضيوف مرتبطة بالمتصفح، مع إمكانية جمع معلومات الاتصال وفقًا لإعدادات الأداة.
في عنصر واجهة المستخدم، يمكن للزوار المجهولين إرسال الملاحظات والتفاعل مع التحديثات، بينما يتطلب التصويت الإيجابي على الملاحظات والتعليق وفتح جرس الإشعارات استدعاء uj.identify. ويتطلب تعديل المنشورات والتعليقات الخاصة بالمستخدم أو حذفها في عنصر واجهة المستخدم استخدام هوية موقّعة.
إذا تم تفعيل اشتراط الرموز الموقّعة في الإعدادات → تسجيل الدخول، فسيتم رفض استدعاءات identify غير الموقّعة برمز HTTP 403 وسيظل الزائر مجهولًا. استخدم الهوية الموقّعة للتحقق من الحسابات على جانب الخادم.
ما طريقة المصادقة التي ينبغي استخدامها؟
الطريقة | أين تعمل | الأمان | الخطة | الدليل |
|---|---|---|---|---|
غير موقّعة ( | الأداة داخل التطبيق | يقدّمها المتصفح (يمكن انتحالها) | جميع الخطط | هذه المقالة |
الهوية الموقّعة (HS256 JWT) | الأداة داخل التطبيق (+ روابط إلى البوابة العامة عند تفعيل تسجيل الدخول التلقائي) | رمز JWT يتحقق منه الخادم | Starter وProfessional (للوضع الصارم) | |
تسجيل الدخول التلقائي | البوابة العامة والتضمينات المضمنة ( | رمز JWT بتوقيع HS256 يتحقق منه الخادم | Starter وProfessional | |
تسجيل الدخول الأحادي (SSO) | إعادة التوجيه إلى تسجيل الدخول في البوابة العامة | رمز JWT بتوقيع HS256 يتحقق منه الخادم | Professional | |
Swift SDK ( | تطبيقات iOS وmacOS | توقيع غير موقّع أو بتقنية HMAC-SHA256 | Starter وProfessional (يتطلب تسجيل الدخول التلقائي) |
الخطوة التالية
تحقّق من هويات المستخدمين من الواجهة الخلفية لديك باستخدام الهوية الموقّعة.