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

استدعِ datacub.identify(userId) بعد تسجيل الدخول، و datacub.reset() عند تسجيل الخروج. ونشاط المستخدم اللي قبل على نفس المتصفح أو الجوال ينربط فيه.

بعد تسجيل الدخول أو التسجيل

async function login(email: string, password: string) {
  const user = await api.login(email, password)
  datacub.identify(user.id, { email: user.email, name: user.name })
  return user
}

استخدم معرّف المستخدم الداخلي الثابت عندك: اللي في قاعدة بياناتك وما يتغيّر أبد. واستدعِ identify مرة ثانية مع كل تحميل صفحة أو فتح للتطبيق طول ما المستخدم مسجّل دخول؛ بنفس المعرّف وبدون صفات ما يرسل شيء جديد.

الاسم والبريد الإلكتروني ورقم الجوال

مرّرهم كصفات (traits)، عشان صفحة المستخدمون تعرض مين هو المستخدم المسجّل، وتقدر تدوّر عليه بالإيميل أو رقم الجوال:

datacub.identify('user_8f3a2c', {
  email: 'sara@example.sa',
  name: 'Sara Alqahtani',
  phone: '0551234567',
  plan: 'growth', // any other trait, under the same rules as event properties
})
  • مرّر الصفات عند تسجيل الدخول ولما تتغيّر (تعديل الملف الشخصي)، مو مع كل تحميل صفحة: كل استدعاء فيه صفات يرسلها من جديد.
  • datacub يرتّبها على السيرفر: الإيميل ينشال منه الفراغ ويصير بحروف صغيرة، ورقم الجوال يصير بالصيغة الدولية (جوال سعودي يبدأ بـ 05 يصير +9665...؛ والدول الثانية تحتاج رمزها بعد +). والقيمة اللي ما تنفهم تنشال، وما تنحفظ زي ما انكتبت.
  • هذي الصفات توصف المستخدم، وما تعرّفه أبد. مستخدمين عندهم نفس الإيميل أو نفس الرقم يبقون مستخدمين اثنين.
  • بس هذي المفاتيح الثلاثة يحق لها تحمل بيانات تواصل. الإيميل في أي صفة ثانية أو في خاصية track() ينحجب برضو.

عند تسجيل الخروج

async function logout() {
  await api.logout()
  datacub.reset()
}

reset() يبدأ معرّف زائر وجلسة جديدة. بدونه، الشخص اللي بعده على نفس الجوال أو الكمبيوتر ينحسب على المستخدم اللي قبله.

الشركات والفرق

إذا مستخدمينك تابعين لشركة أو فريق أو مساحة عمل، مرّر معرّفها برضو. ينحفظ مع كل حدث، فتقدر تحسب الشركات النشطة مو بس الأشخاص.

datacub.identify(user.id, { account: workspace.id })

المعرّفات اللي يرفضها datacub

عشان ما تصير أي بيانات شخصية مفتاح تعريف، identify يرفض معرّفات المستخدم اللي تشبه إيميل، أو هوية وطنية أو إقامة سعودية، أو جوال سعودي، أو رقم جوال بالصيغة الدولية، أو رقم بطاقة، أو JWT، والقيم الوهمية مثل null و undefined و anonymous و guest و 0. ونفس القواعد على account. الاستدعاء المرفوض ما يسوي شيء؛ وعلى localhost يقول لك الـ SDK السبب في الكونسول.

إذا معرّفات مستخدمينك هي إيميلات أو أرقام جوالات، أرسل معرّف ثابت ثاني من قاعدة بياناتك، ومرّر الإيميل أو الرقم كصفة.

كيف يصير الربط

  • قبل identify المستخدم زائر: معرّف عشوائي محفوظ في كوكي من نفس موقعك (الويب) أو في تخزين التطبيق (الجوال).
  • identify يربط نشاط الزائر اللي قبل بالمستخدم، ويصير مسجّل.
  • نفس المستخدم على اللابتوب والجوال: كل جهاز ينربط لما يسجّل دخول فيه بنفس المعرّف.
  • مستخدم ثاني سجّل دخول على نفس الجهاز: الـ SDK يسوي reset أول، فما ينربط شخصين ببعض أبد.
  • datacub ما يطابق المستخدمين أبد بعنوان IP، ولا بصفات الجهاز، ولا بالإيميل أو الجوال.

التفاصيل في الزوار والمسجّلون.

إذا تطلب الموافقة أولًا

مع تفعيل الموافقة أولًا، identify قبل datacub.consent.grant() ينحفظ في الذاكرة وينفّذ عند الموافقة. وما ينحفظ ولا ينرسل شيء قبلها.

في React Native

نفس الاستدعاءات:

import datacub from '@datacub/react-native'

datacub.identify('user_8f3a2c', { account: 'ws_51', email: 'sara@example.sa' })
// at logout
datacub.reset()