الأحداث المخصصة
تتبّع اللحظات المهمة في منتجك عن طريق datacub.track(name, properties).
datacub.track('signup_completed', { method: 'email' })
datacub.track('project_created', { template: 'blank', members: 3, trial: true })ونفس الاستدعاء يشتغل في React Native:
import datacub from '@datacub/react-native'
datacub.track('order_placed', { items: 2, total: 149.5, currency: 'SAR' })استدعه بعد ما ينجح الإجراء: لما يرد السيرفر، أو ينتأكد الدفع، أو ينحفظ الملف. مو عند الضغط على الزر. كيف تختار أحداثك.
الأسماء
- من 1 إلى 100 حرف. استخدم صيغة
object_actionبحروف صغيرة وشرطة سفلية:invite_sent،report_exported. - ما يبدأ بـ
$(هذي لأحداث datacub نفسه). - ينرفض إذا كان يشبه معرّف: 6 أرقام أو أكثر ورا بعض، أو 16 خانة hex أو أكثر، أو جزء من UUID، أو فيه
@. حط المعرّفات في الخصائص بدالها، أو خلّها برا.
الاستدعاء المرفوض ما يسوي شيء. وعلى localhost يطبع الـ SDK السبب في الكونسول.
الخصائص
القيم ممكن تكون نصوص، أو أرقام، أو true و false، أو null، أو تواريخ، أو مصفوفات، أو كائنات:
datacub.track('report_exported', {
format: 'csv',
rows: 1200,
scheduled: false,
range: { from: new Date('2026-10-01'), to: new Date('2026-10-31') },
columns: ['users', 'sessions'],
})| القاعدة | وش يصير |
|---|---|
| لين 200 مفتاح في الحدث | الباقي ينشال |
| نصوص قصيرة | النص اللي أطول من 256 حرف أو 12 كلمة يعتبر نص حر ويصير [redacted] |
| الكائنات لين 3 مستويات | اللي أعمق يصير [depth] |
| المصفوفات | أول 100 عنصر |
| التواريخ | تنرسل بصيغة ISO 8601 بتوقيت UTC |
الدوال و undefined وكائنات الكلاسات و NaN و Infinity | تنشال |
وش يشيل datacub بنفسه
المفاتيح اللي أسماؤها توحي بأسرار أو بيانات شخصية تنشال: كلمة المرور، رمز التحقق، PIN، CVV، رقم البطاقة، الآيبان، الإقامة، الهوية الوطنية، التوكن، السر، معرّف الجلسة، الكوكيز وغيرها، بالعربي والإنجليزي. والقيم اللي فيها إيميل، أو 9 أرقام أو أكثر (جوالات، هويات، بطاقات، آيبانات، بأي نوع أرقام)، أو توكنات bearer، أو نصوص طويلة تشبه المفاتيح، ينستبدل الجزء هذا بـ [redacted]. والسيرفر يعيد نفس الفحوصات.
هذي شبكة أمان، مو خطة. أرسل حقائق عن المنتج (plan، step، count، currency)، ولا ترسل مين هو المستخدم أو وش كتب.
الإرسال
الأحداث تنرسل على دفعات: بعد 5 ثواني من أول حدث، أو عند 20 حدث، أو لما تنخفى الصفحة أو تنقفل. والإرسال اللي يفشل يعيد المحاولة بفواصل متزايدة. وكل حدث له معرّف فريد، فإعادة المحاولة ما تنحفظ مرتين أبد.