التعرّف على المستخدمين

Shayan Taslimتم التحديث

افتراضيًا، يتعامل عنصر واجهة المستخدم مع الزوار على أنهم مجهولون. استدعِ uj.identify لربط الملاحظات والتصويتات والتعليقات والإشعارات والمحادثات بحساب العميل.

التعرّف الأساسي على الهوية

JavaScript
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():

JavaScript
if (user) {
  uj.identify({
    user: {
      id: user.id,
      email: user.email,
      firstName: user.firstName,
      lastName: user.lastName
    }
  });
} else {
  uj.logout();
}

إضافة السمات

السمات هي خصائص مخصصة مرتبطة بملف تعريف العضو، وتظهر بجانب طلباته ومحادثاته في لوحة التحكم.

JavaScript
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، أرفق شركة واحدة أو أكثر بالمستخدم:

JavaScript
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 وعدًا:

JavaScript
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 وسيظل الزائر مجهولًا. استخدم الهوية الموقّعة للتحقق من الحسابات على جانب الخادم.

ما طريقة المصادقة التي ينبغي استخدامها؟

الطريقة

أين تعمل

الأمان

الخطة

الدليل

غير موقّعة (uj.identify)

الأداة داخل التطبيق

يقدّمها المتصفح (يمكن انتحالها)

جميع الخطط

هذه المقالة

الهوية الموقّعة (HS256 JWT)

الأداة داخل التطبيق (+ روابط إلى البوابة العامة عند تفعيل تسجيل الدخول التلقائي)

رمز JWT يتحقق منه الخادم

Starter وProfessional (للوضع الصارم)

الهوية الموقّعة

تسجيل الدخول التلقائي

البوابة العامة والتضمينات المضمنة (?token=...)

رمز JWT بتوقيع HS256 يتحقق منه الخادم

Starter وProfessional

تسجيل الدخول التلقائي

تسجيل الدخول الأحادي (SSO)

إعادة التوجيه إلى تسجيل الدخول في البوابة العامة

رمز JWT بتوقيع HS256 يتحقق منه الخادم

Professional

تسجيل الدخول الأحادي

Swift SDK (identify)

تطبيقات iOS وmacOS

توقيع غير موقّع أو بتقنية HMAC-SHA256

Starter وProfessional (يتطلب تسجيل الدخول التلقائي)

مصادقة Swift SDK

الخطوة التالية

تحقّق من هويات المستخدمين من الواجهة الخلفية لديك باستخدام الهوية الموقّعة.

هل أجاب هذا عن سؤالك؟