المستخدمون (معرفات المستخدمين)

معرف المستخدم (User ID) هو معرف فريد يتم تعيينه لكل مستخدم للحفاظ على بيانات مستخدم متسقة عبر جميع أجهزتهم. يتيح لك هذا توفير تجربة مستخدم سلسة لجمهورك عبر أجهزتهم.

كيف يرتبط المستخدمون بالأجهزة؟

يتم تعيين معرف فريد لكل مستخدم يسمى معرف المستخدم (User ID). يمكن ربط معرفات المستخدمين بأجهزة متعددة، مما يسمح للشركات بالبقاء على اتصال مع المستخدمين حتى عند تبديلهم للأجهزة. هذا يضمن وصول الرسائل المستهدفة إلى المستخدم المقصود على أي جهاز يستخدمونه.

المستخدم (User ID) ليس كيانًا قائمًا بذاته؛ فهو يعتمد على وجود أجهزة مرتبطة به. إذا تمت إزالة آخر جهاز مرتبط أو تم ربطه بمستخدم آخر، فسيتم حذف المستخدم تلقائيًا من النظام.

يعمل المستخدم (User ID) أيضًا ككيان يمكن تجميع عدة أجهزة تحته، لكل منها معرف جهاز فريد (Hardware ID أو HWID).

أنواع المستخدمين

هناك نوعان من المستخدمين: المستخدمون المجهولون والمستخدمون المعروفون. المستخدم المجهول يكون معرف المستخدم (User ID) الخاص به مساويًا لمعرف الجهاز (HWID)، والذي يمكن استبداله بمعرف المستخدم الفعلي لاحقًا.

المستخدم المعروف لديه معرف مستخدم (User ID) مميز. يمكنك تحديد معرف المستخدم عند تسجيل جهاز جديد من خلال استدعاء API /registerDevice.

الحصول على معرفات المستخدمين وإدارتها

يوفر Pushwoosh عدة طرق للوصول إلى المستخدمين وإدارتهم:

إنشاء المستخدمين

بشكل افتراضي، عند تشغيل تطبيق مدمج به Pushwoosh SDK لأول مرة، فإنه يعين معرف الجهاز (HWID) كمعرف للمستخدم (User ID). يمكنك استدعاء طريقة setUserID من Pushwoosh SDK عند تسجيل الدخول لتعيين أي قيمة مطلوبة لربط جهاز بمستخدم معين. عند تسجيل خروج المستخدم، يمكنك إعادة تعيين هذه القيمة إلى قيمة افتراضية من خلال استدعاء آخر لـ setUserID، على سبيل المثال، إلى قيمة HWID الأولية.

استيراد المستخدمين

يمكنك بسهولة استيراد معرفات المستخدمين (User IDs) من ملف CSV لشريحة مستخدمين معينة. يرجى الاطلاع على تعليماتنا المفصلة في دليل الشرائح.

تصدير المستخدمين

لتصدير معرفات المستخدمين (User IDs)، يمكنك استخدام طلب API /exportSegment، الذي يوفر خيار تصدير البيانات بتنسيق CSV أو JSON.

الوصول إلى معرفات المستخدمين من سجلات الأجهزة

يمكن أيضًا الوصول إلى معرفات المستخدمين (User IDs) مباشرة من سجلات الأجهزة. للحصول على إرشادات خطوة بخطوة، يرجى الرجوع إلى المقالة How to Obtain Console Logs and Device Tokens.

علامات المستخدم والجهاز

تمامًا مثل الأجهزة، يمكن للمستخدمين (User IDs) أن يكون لديهم مجموعاتهم الخاصة من العلامات (tags) التي تعمل كتصنيفات لتصنيف وتحديد المستخدمين أو الأجهزة بناءً على خصائصهم.

كيفية إنشاء علامات خاصة بالمستخدم

عندما تقوم بتعيين علامة خاصة بالمستخدم، فإنها تنطبق تلقائيًا على كل من المستخدمين وجميع أجهزتهم المرتبطة. هذا يعني أن العلامة سيتم ربطها بملف تعريف المستخدم وستنعكس على جميع أجهزتهم.

لإنشاء علامة خاصة بالمستخدم من لوحة تحكم Pushwoosh، حدد مربع الاختيار User-specific عند إضافة علامة جديدة. إذا لم تقم بتمييز العلامة بأنها خاصة بالمستخدم، فسيتم ربطها بالجهاز فقط.

إدارة انتقالات المستخدم

داخل Pushwoosh، تتضمن إدارة انتقالات المستخدم سيناريوهين أساسيين:

الانتقال من مستخدم مجهول إلى مستخدم معروف

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

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

الانتقال من مستخدم معروف إلى آخر

إذا تم تغيير المستخدم المرتبط بجهاز باستخدام setUserID من Pushwoosh SDK، فسيتم ربط الجهاز بملف تعريف المستخدم الجديد.

تعرف على المزيد حول تعيين معرفات المستخدمين لـ Android و iOS.

يمكنك أيضًا استخدام استدعاء API /registerUser.

تمامًا كما في السيناريو السابق، تظل سمات الجهاز كما هي، مما يضمن انتقالًا سلسًا. ومع ذلك، سيتم الآن تعيين العلامات الخاصة بالمستخدم إلى قيم المستخدم الجديد. هذا لضمان أن علامات المستخدم تعكس ملف تعريف المستخدم الجديد بدقة.

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

طرق API لإدارة المستخدمين

يوفر Pushwoosh العديد من طرق API لإدارة المستخدمين داخل تطبيقك. يعد فهم هذه الطرق أمرًا بالغ الأهمية لإدارة بيانات المستخدم واستهدافها بشكل فعال. فيما يلي الطرق الأربع الرئيسية التي تغير حالة المستخدم أو سماته:

1. /applicationOpen

• ينشئ جهازًا بدون رمز دفع (push token) ومستخدم مجهول إذا لم يكونا موجودين.
• يعين علامات خاصة بالجهاز على الجهاز.
• لا يتعامل مع التغييرات المتعلقة بالمستخدم.

2. /registerDevice

• ينشئ جهازًا برمز دفع ومستخدم إذا لم يكونا موجودين.
• يربط جهازًا بالمستخدم من طلب API (مستخدم مجهول خلاف ذلك).
• يعين جميع العلامات المحددة لكل من الجهاز والمستخدم المرتبط به.

تنبيه

للحماية من حالات التسابق المحتملة (حيث تحاول عمليات متعددة تعديل البيانات المشتركة في وقت واحد)، امتنع عن استخدام /registerDevice بالتزامن مع /registerUser.

3. /registerUser

• ينشئ جهازًا بدون رمز دفع ومستخدم إذا لم يكن موجودًا.
• ينقل جهازًا بين المستخدمين مع الاحتفاظ بعلامات الجهاز.

4. /setTags

• ينشئ جهازًا بدون رمز دفع ومستخدم مجهول إذا لم يكن موجودًا.
• يعين علامات الجهاز للجهاز.
• يعين علامات المستخدم للمستخدم المقدم في الطلب (إذا كان هذا المستخدم موجودًا).
• لا تنقل هذه الطريقة الجهاز، ونتيجة لذلك، لا يمكنها إنشاء مستخدم معروف جديد (يمكنك استخدام طريقة /registerUser لإنشاء مستخدم معروف جديد).

إذا كان المستخدم مرتبطًا بأجهزة متعددة، فأي جهاز سيتلقى الرسالة أثناء رحلة العميل (Customer Journey)؟

عندما يكون لدى المستخدم أجهزة متعددة مرتبطة بحسابه، فإن كيفية تسليم الرسائل عبرها تعتمد على نوع الرحلة:

رحلات الدخول المستندة إلى الجمهور والدخول المستند إلى الويب هوك

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

رحلات الدخول المستندة إلى المشغلات

بشكل افتراضي، يتم إرسال الرسالة إلى الجهاز الذي تم فيه إطلاق الإجراء المشغل آخر مرة. هذا يحافظ على السياق والملاءمة من خلال تسليم الرسالة على الجهاز الذي حدث فيه نشاط المستخدم ذي الصلة.

التسليم لجميع الأجهزة

ومع ذلك، يمكنك اختيار تجاوز هذه الإعدادات الافتراضية وإرسال الرسالة إلى جميع الأجهزة المرتبطة بمعرف المستخدم (User ID) في وقت واحد. للقيام بذلك، في إعدادات الرسالة، قم بالتمرير لأسفل إلى Options، وقم بتشغيل خيار Send to all user devices.

قد يكون هذا الخيار مفيدًا للبث أو الإشعارات العاجلة التي تحتاج إلى الوصول إلى المستخدم بغض النظر عن الجهاز الذي يستخدمه حاليًا.