خصائص الملفات الشخصية والجلسات
ما هو
الخصائص هي حقول البيانات الفردية التي تُشكّل ملفات العملاء الشخصية والجلسات في BotBat CDP. تعمل كأساسات بنائية للتجزئة والتخصيص والتحليلات والأتمتة عبر المنصة بأكملها. كل معلومة تجمعها عن عميل، من اسمه وبريده الإلكتروني إلى سمات الأعمال المخصصة مثل مستوى الاشتراك أو القيمة الدائمة، تُخزَّن كخاصية.
خصائص الملف الشخصي هي سمات دائمة للعميل تبقى مرتبطة بسجله عبر جميع التفاعلات. تشمل الأمثلة الاسم والبريد الإلكتروني ورقم الهاتف وخطة الاشتراك والقيمة الدائمة. خصائص الجلسة، على النقيض، تلتقط سياق فترة تفاعل محددة، مثل نوع الجهاز والمتصفح والموقع الجغرافي وعنوان URL المُحيل. تُعاد تعيين خصائص الجلسة مع كل زيارة جديدة وتوفر نظرة ثاقبة حول كيفية تفاعل العملاء بدلاً من هويتهم.
يأتي BotBat بمجموعة شاملة من الخصائص المدمجة ويمنحك تحكمًا كاملاً لتعريف خصائص مخصصة بأنواع بيانات محددة وقواعد تحقق وإعدادات عرض. تظهر هذه الخصائص عبر المنصة: في مُنشئ استعلام الشرائح كشروط قابلة للتصفية، وفي قوالب الرسائل كعناصر نائبة ديناميكية، وفي معالجات الاستيراد كأهداف ربط، وفي عروض تفاصيل الملف الشخصي كحقول قابلة للقراءة.
متى تستخدم
| السيناريو | الوصف |
|---|---|
| توسيع نموذج البيانات | حقول الملف الشخصي المدمجة لا تغطي احتياجات عملك وتريد إضافة خصائص مخصصة مثل "company_name" أو "subscription_tier" أو "preferred_language" أو "lead_score". |
| ضمان جودة البيانات | تحتاج إلى فرض أنواع البيانات (نص، رقم، منطقي، تاريخ، مصفوفة) وقواعد التحقق (مطلوب، نمط regex، قيم دنيا/قصوى) للحفاظ على بيانات نظيفة ومتسقة. |
| ربط البيانات المستوردة | أنت تستورد جهات اتصال من ملف CSV أو نظام خارجي وتحتاج إلى ربط أعمدة المصدر بخصائص ملف BotBat الشخصي، بما في ذلك الحقول المخصصة المُنشأة فوريًا. |
| بناء شروط الشرائح | تنشئ شروط شرائح بناءً على خصائص الملف الشخصي (مثل "country = US AND subscription_tier = premium") وتحتاج إلى فهم الخصائص المتاحة وأنواع بياناتها. |
| تخصيص الرسائل | تدرج محتوى ديناميكيًا في رسائل الحملات باستخدام عناصر نائبة للخصائص (مثل Hello {{firstName}}) وتحتاج إلى معرفة أسماء الخصائص الدقيقة والقيم المتوقعة. |
| تحليل سياق الجلسة | تريد التجزئة أو إعداد التقارير بناءً على سياق التفاعل مثل الجوال مقابل سطح المكتب، أو الزيارات المباشرة مقابل الإحالة، أو المنطقة الجغرافية. |
الخطوات
الخطوة 1: الانتقال إلى الخصائص
انقر على "العملاء" في الشريط الجانبي الرئيسي، ثم حدد علامة تبويب "الخصائص". يُنظم العرض في قسمين: خصائص الملف الشخصي وخصائص الجلسة. تُعرض كل خاصية باسمها ونوع بياناتها ونطاقها وما إذا كانت مدمجة أو مخصصة.
الخطوة 2: مراجعة خصائص الملف الشخصي المدمجة
تصفح خصائص الملف الشخصي المدمجة المتوفرة افتراضيًا. لا يمكن حذف هذه الخصائص ولكن يمكن تعديل أسماء العرض ومستوى الظهور.
| الخاصية | نوع البيانات | الوصف |
|---|---|---|
firstName / lastName | نص | الاسم الأول واسم العائلة للعميل. |
email | نص (صيغة بريد إلكتروني) | عنوان البريد الإلكتروني الأساسي المُستخدم لحملات البريد الإلكتروني ومطابقة الهوية. |
phoneNumber | نص (صيغة E.164) | رقم الهاتف الأساسي المُستخدم لـ WhatsApp و SMS ومطابقة الهوية. |
channel | نص | القناة التي أُنشئ من خلالها الملف الشخصي (WhatsApp، SMS، بريد إلكتروني، ويب). |
createdAt | تاريخ | الطابع الزمني لوقت إنشاء الملف الشخصي لأول مرة. |
lastSeen | تاريخ | الطابع الزمني لأحدث حدث مُسجل لهذا الملف الشخصي. |
city / country | نص | معلومات جغرافية مُستمدة من تحديد الموقع الجغرافي بـ IP أو مُقدمة صراحة. |
الخطوة 3: إنشاء خاصية مخصصة
انقر على "خاصية جديدة" وكوّن الحقول التالية. انتبه عند اختيار نوع البيانات، حيث لا يمكن تغييره بعد الإنشاء.
| الحقل | مطلوب | الوصف |
|---|---|---|
| الاسم | نعم | المعرّف الداخلي بصيغة camelCase بدون مسافات (مثل "subscriptionTier"). |
| اسم العرض | نعم | التسمية المقروءة المعروضة في واجهة المستخدم (مثل "مستوى الاشتراك"). |
| نوع البيانات | نعم | اختر من: نص، رقم، منطقي، تاريخ، مصفوفة (متعددة القيم)، أو كائن (JSON). |
| التحقق | لا | قيود اختيارية: علامة مطلوب، قيمة افتراضية، حد أدنى/أقصى للأرقام، نمط regex للنصوص، قيم مسموحة (enum). |
| النطاق | نعم | ملف شخصي (دائم عبر الجلسات) أو جلسة (لكل جلسة فقط). |
| الظهور | لا | ما إذا كانت الخاصية تظهر في عروض تفاصيل الملف الشخصي ومتاحة في متغيرات القالب. |
الخطوة 4: تعديل خاصية موجودة
انقر على أي خاصية لتعديل اسم العرض أو قواعد التحقق أو إعدادات الظهور. لا يمكن تغيير الاسم الداخلي ونوع البيانات بعد الإنشاء لمنع تلف البيانات. إذا كنت بحاجة إلى نوع بيانات مختلف، أنشئ خاصية جديدة وقم بترحيل البيانات.
الخطوة 5: مراجعة خصائص الجلسة
انتقل إلى قسم خصائص الجلسة لعرض الخصائص التي تصف سياق التفاعل. تُملأ هذه تلقائيًا عند بدء جلسة.
| الخاصية | نوع البيانات | الوصف |
|---|---|---|
deviceType | نص | سطح مكتب، جوال، أو جهاز لوحي. |
browser | نص | اسم المتصفح وإصداره. |
operatingSystem | نص | اسم نظام التشغيل وإصداره. |
location | كائن | بيانات الموقع الجغرافي بما في ذلك المدينة والمنطقة والبلد والإحداثيات. |
referrer | نص | عنوان URL المُحيل أو مصدر الزيارات. |
sessionDuration | رقم | مدة الجلسة بالثواني. |
الخطوة 6: ربط الخصائص أثناء الاستيراد
عند استيراد جهات الاتصال، استخدم واجهة ربط الأعمدة لمطابقة أعمدة CSV بخصائص الملف الشخصي. إذا كان الاستيراد يحتوي على حقول غير موجودة بعد في مخططك، يمكنك إنشاء خصائص مخصصة جديدة مباشرة من واجهة الربط دون مغادرة معالج الاستيراد.
الخطوة 7: استخدام الخصائص في الشرائح
في مُنشئ استعلام الشرائح، تظهر شروط الخصائص مع عوامل تشغيل مناسبة للنوع. النصوص تدعم "يساوي" و"يحتوي" و"يبدأ بـ". الأرقام تدعم "أكبر من" و"أقل من" و"بين". التواريخ تدعم "قبل" و"بعد" و"في آخر N يوم". الحقول المنطقية تقدم مفاتيح تبديل بسيطة صحيح/خطأ.
الخطوة 8: استخدام الخصائص في قوالب الرسائل
أدرج عناصر نائبة للخصائص في رسائل الحملات باستخدام صيغة الأقواس المزدوجة: {{propertyName}}. للخصائص الاختيارية التي قد لا تحتوي على قيمة، استخدم قيمة احتياطية: {{city|"منطقتك"}}. يوفر محرر القوالب أداة اختيار متغيرات تسرد جميع الخصائص المتاحة مع أنواع بياناتها.
الأخطاء الشائعة
| الخطأ | أهميته | كيفية تجنبه |
|---|---|---|
| اصطلاحات تسمية غير متسقة | خلط camelCase و snake_case والمسافات يجعل الخصائص صعبة الاستخدام في القوالب والشرائح. | ضع اصطلاح تسمية وطبّقه قبل إنشاء أي خصائص. |
| اختيار نوع بيانات خاطئ | أنواع البيانات دائمة. تخزين أرقام الهواتف كرقم أو التواريخ كنص يحد من التصفية والتحقق. | خطط لمخططك بعناية واختر نوع البيانات الصحيح من الإنشاء الأول. |
| الإفراط في إنشاء خصائص مخصصة | كل خاصية مخصصة تضيف تعقيدًا لنموذج البيانات وواجهة المستخدم. | تحقق مما إذا كانت خاصية موجودة أو تصنيف يخدم الغرض قبل إنشاء خاصية جديدة. |
| تجاهل قواعد التحقق | بدون تحقق، تحتوي الحقول على بيانات غير متسقة (مثل "USA" و"US" و"United States"). | استخدم القيم المسموحة (enum) للحقول ذات مجموعة معروفة من الخيارات. |
| الخلط بين نطاق الملف الشخصي والجلسة | خصائص نطاق الجلسة تُعاد تعيينها مع كل زيارة ولا يمكن استخدامها للتجزئة طويلة المدى. | استخدم نطاق الملف الشخصي لأي سمة عميل دائمة. |
أنشئ مستند "قاموس الخصائص" لفريقك يسرد كل خاصية مخصصة ونوع بياناتها والقيم المسموحة وحالة الاستخدام المقصودة. هذا يمنع الخصائص المكررة ويضمن أن الجميع يستخدم نفس الحقول بشكل متسق عبر الحملات والشرائح والقوالب.
- قائمة الخصائص
- إنشاء خاصية
- تعديل خاصية
- خصائص الجلسة
- ربط الاستيراد
- منشئ الشرائح
- متغيرات القوالب