تأهيل مستخدمي الجوال الجدد باستخدام Braze، بدءاً من الفتح الأول

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

أبرز النقاط

• يوجد ملف تعريف منذ التشغيل الأول، وهو مجهول ومرتبط بالجهاز، قبل أن يقوم أي شخص بالتسجيل.
• قم بتعيين external_id باستخدام changeUser بمجرد أن يصبح المستخدم قابلاً للتعريف، ولا تقم بذلك أبداً قبل أن تتمكن من تحديد هويته بشكل فريد.
• يحتفظ معرف external_id الجديد بالسجل المجهول، بينما يتم صياغة المعرف الموجود بشكل مختلف في صفحتين من صفحات Braze، لذا تأكد من اختباره.
• يؤدي إلغاء تثبيت التطبيق وإعادة تثبيته إلى إنشاء ملف تعريف مجهول جديد حتى يتم استدعاء changeUser مرة أخرى.
• قم بتشغيل Canvas القائم على الإجراءات بناءً على الإجراء وقم بالتصفية بناءً على شيء آخر، لتجنب حالة السباق (race condition).
• لا يمكن التراجع عن عمليات الدمج، ولا يتم تحديث علامة تبويب سجل المراسلات (Messaging History) بعد إتمام عملية الدمج.

كيف تبدأ عملية تهيئة مستخدمي الجوال الجدد عبر Braze قبل التسجيل؟

وفقاً لـ وثائق دورة حياة ملف تعريف مستخدم Braze، يُطلق على أي مستخدم ليس لديه external_id مخصص اسم مستخدم مجهول. ويشمل ذلك الأشخاص الذين قاموا بتنزيل تطبيق الجوال الخاص بك ولكنهم لم ينشئوا ملف تعريف. عندما يتعرف عليهم حزمة تطوير البرمجيات (SDK) لأول مرة، يقوم Braze بإنشاء ملف تعريف مجهول.

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

لا يزال بإمكانك الوصول إلى هذا الجمهور. تصف الوثائق استخدام عامل تصفية تجزئة "معرف المستخدم الخارجي فارغ" (External User ID is blank) لاستهداف المستخدمين المجهولين. كما تصف استخدام واجهة برمجة التطبيقات (API) لتسجيل الأحداث والسمات الخاصة بهم.

ما الذي يعرفه Braze عن المستخدم الجديد في الجلسة الأولى؟

يجمع Braze بيانات معينة تلقائياً عند تهيئة حزمة تطوير البرمجيات (SDK)، كما هو موضح في صفحة جمع بيانات حزمة تطوير البرمجيات (SDK) . بعض هذه البيانات مهم للتهيئة أكثر من غيرها، وهناك سمة واحدة تتطلب إذناً يجب أن يحصل عليه تطبيقك.

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

متى يجب عليك استدعاء changeUser أثناء عملية التهيئة؟

تشير الوثائق إلى ضرورة تعيين معرف خارجي (external_id) باستخدام طريقة changeUser بمجرد أن يصبح المستخدم قابلاً للتعريف في تطبيقك. كما تحذر من تعيينه قبل أن تتمكن من تحديد هوية المستخدم بشكل فريد. بمجرد تحديد هوية المستخدم، لا يمكنك إعادته إلى حالة "مجهول".

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

هناك تفصيلان يستحقان المعرفة قبل كتابة الاستدعاء البرمجي. يؤدي استدعاء changeUser بمعرف مستخدم مختلف إلى إنهاء الجلسة الحالية تلقائياً وبدء جلسة جديدة. كما توصي Braze باستخدام معرفات مبنية وفقاً لمعيار المعرف الفريد عالمياً (UUID)، كما توضح صفحة إعداد معرفات المستخدمين ، وتنصح بتجنب القيم التي يمكن تخمينها والأرقام المتسلسلة.

ما الذي يحدث للملف الشخصي المجهول عندما يقوم المستخدم بالتسجيل؟

هناك نتيجتان موصوفتان، وتعتمدان على ما إذا كان المعرف الخارجي (external_id) موجوداً بالفعل في Braze أم لا.

في الحالة الثانية، تسرد صفحة دورة حياة المستخدم البيانات التي يتم نقلها. يتم نقل رموز الإشعارات (Push tokens) وسجل التفاعل مع الرسائل. أما السمات المخصصة والأحداث المخصصة وسجل الشراء، فلا يتم دمجها إلا إذا كانت تلك الحقول غير موجودة بالفعل في الملف الشخصي المُعرَّف.

عند وجود تعارض في البيانات، يتم الاحتفاظ بقيم المستخدم المُعرَّف. المستخدمون المعزولون غير مؤهلين لتلقي الرسائل.

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

تعتمد علامة تبويب "سجل المراسلات" (Messaging History) على مستودع بيانات ولا يتم تحديثها بعد الدمج. لن تظهر الأحداث التي سبقت الدمج هناك، لذا خطط لتقارير الإعداد (onboarding) بناءً على ذلك.

كيف ينبغي بناء جمهور الدخول لحملة "Canvas" الخاصة بإعداد المستخدمين الجدد؟

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

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

اقتراحنا هو استخدام الإجراء كمشغل والفلترة بناءً على شيء آخر، مثل نافذة الاستخدام الأول. ثم قم بتعيين معايير الخروج التي تتوافق مع التحويل (conversion) الخاص بك، لأن المستخدم الذي يقوم بحدث الاستثناء يتوقف عن تلقي الرسائل. أضف مجموعة ضابطة (control group)، حيث تتعقب Braze التحويلات للمستخدمين الموجودين فيها على الرغم من عدم تلقيهم لأي رسائل.

كيف يمكن لتطبيق افتراضي لتعلم اللغات إعداد مستخدم جديد؟

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

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

يتم تسجيل كل ما يقوم به المستخدم ضمن الملف التعريفي المجهول. عند الوصول إلى شاشة التسجيل، يستدعي التطبيق changeUser باستخدام مُعرّف تم إنشاؤه حديثاً وغير موجود في Braze بعد. وبذلك، يتحول الملف التعريفي المجهول إلى ملف تعريفي مُعرّف مع الاحتفاظ بسجله كاملاً.

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

لاحقاً، يقوم مستخدم عائد بتسجيل الدخول من جهاز ثانٍ باستخدام مُعرّف موجود مسبقاً. لقد اختبر الفريق هذه الحالة بالفعل، لذا فهم يعرفون ما الذي سيتم نقله.

ما الذي يجب عليك التحقق منه قبل إطلاق رحلة تهيئة المستخدم؟

اتبع نفس الإجراء في كل مرة، باستخدام ملفات تعريف اختبارية داخلية قبل الإطلاق:

1. قم بتثبيت التطبيق بشكل نظيف على جهاز اختبار وتأكد من إنشاء ملف تعريفي مجهول الهوية مع معرف braze_id خاص به.
2. استدعِ changeUser باستخدام مُعرّف جديد وتأكد من انتقال السمات والسجل بالكامل.
3. كرر العملية باستخدام مُعرّف موجود مسبقاً، وسجل بدقة ما الذي يتم نقله وما الذي لا يتم نقله.
4. قم بإلغاء التثبيت وإعادة التثبيت، وتأكد من أن الجهاز يظهر كملف تعريفي مجهول جديد.
5. قم بتجربة رحلة المستخدم من البداية إلى النهاية، وتأكد من أن مشغل الرحلة (trigger) ليس هو نفسه فلتر الجمهور.

تعتبر الخطوة الرابعة مهمة لأن إلغاء تثبيت التطبيق وإعادة تثبيته يؤدي إلى إنشاء معرف braze_id مجهول جديد. وإلى أن يتم استدعاء changeUser مرة أخرى، يُعتبر ذلك الشخص مستخدماً مجهولاً جديداً، وستتعامل معه رحلة Canvas الخاصة بك على هذا الأساس.

ما هي أخطاء الهوية التي قد تؤدي إلى فشل رحلة تهيئة المستخدم؟

غالباً ما تنبع الإخفاقات من بعض الخيارات التي يتم اتخاذها في الإصدار الأول. إن استخدام مُعرّف افتراضي مشترك، أو استدعاء changeUser عند تسجيل خروج المستخدم، هي أنماط يجب تجنبها. توثق Braze كلاً منهما كأفعال لا ينبغي القيام بها.

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

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

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

كيف يرتبط هذا ببقية البرنامج؟

تُعد الهوية حجر الأساس لكل ما يلي الجلسة الأولى. بالنسبة لخطوة الإشعارات الفورية، راجع إشعارات Braze الفورية لإتمام عملية الإعداد. وللاطلاع على الرحلة نفسها، اقرأ كيفية أتمتة رحلة الإعداد الخاصة بك باستخدام Braze Canvas.

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

لمعرفة سبب توقف مستخدم جديد عن المتابعة، اقرأ استخدام استطلاعات الرأي في Braze لتحسين عملية الإعداد. إن دراسة الحالة الخاصة بنا حول دمج ملفات تعريف العملاء المشتتة في ملف تعريف واحد موحد تغطي الجانب المتعلق بالبيانات لنفس مشكلة الهوية.

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

الأسئلة الشائعة
‍

1. هل ينشئ Braze ملف تعريف قبل تسجيل المستخدم؟

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

2. هل يمكنني جعل المستخدم الذي تم تحديد هويته مجهولاً مرة أخرى؟

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

3. هل يؤدي استدعاء changeUser إلى إنهاء الجلسة؟

نعم، يمكن ذلك. فاستدعاؤها باستخدام معرف مستخدم مختلف يؤدي تلقائياً إلى إنهاء الجلسة الحالية وبدء جلسة جديدة.

4. هل يمكنني مراسلة أشخاص لم يسجلوا في الخدمة؟

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

5. ما نوع معرف المستخدم الذي ينبغي عليّ استخدامه؟

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

المصادر

• Braze،دورة حياة ملف تعريف المستخدم. تم الاسترجاع في 19 أكتوبر 2026.
• Braze،تعيين معرفات المستخدمين. تم الاسترجاع في 19 أكتوبر 2026.
• Braze،إنشاء Canvasتم الاسترجاع في 19 أكتوبر 2026.
• Braze،جمع بيانات حزمة تطوير البرمجيات (SDK)تم الاسترجاع في 19 أكتوبر 2026.
• Braze،أفضل ممارسات الجمعتم الاسترجاع في 19 أكتوبر 2026.
• تستند هذه المقالة إلى وثائق Braze فقط. تم الاطلاع على السلوكيات من الصفحات المذكورة أعلاه بتاريخ 19 أكتوبر 2026، لذا يرجى التحقق من الصفحات الحالية قبل الاعتماد عليها.
• بقلم CustomerIK، شريك تنفيذ معتمد لـ Braze.

CustomerIK هي شريك تنفيذ لـ Braze، وتعمل في مجالات الإعداد، والتكامل التقني، وعمليات التسويق، وإدارة بيانات العملاء.

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