التخصيص في الوقت الفعلي في Braze: ما الذي يتم حله ومتى

تعتمد التخصيصات اللحظية في Braze على توقيت وصول كل قيمة إلى الرسالة: حيث يتم معالجة Liquid عند إعداد الرسالة للتسليم، بينما تقوم Connected Content باستدعاء نقطة النهاية الخاصة بك في ذلك الوقت، ويتم تعيين متغيرات السياق عند دخول Canvas. يوضح هذا الدليل توقيت كل مصدر وكيفية التخطيط للقيم التي قد تصل متأخرة أو لا تصل على الإطلاق.

أبرز النقاط

• يقوم Braze بمعالجة Liquid عند إعداد الرسالة للتسليم، لذا يكون لكل قيمة عمرها الخاص بحلول ذلك الوقت.
• تتطلب Connected Content استجابة في غضون ثانيتين، ويتم تخزين استجابات GET مؤقتاً بشكل افتراضي لمدة تصل إلى خمس دقائق.
• تحتفظ متغيرات السياق بالبيانات لدخول واحد إلى Canvas ولا تستمر عبر مسارات Canvas الأخرى.
• إذا فشلت نقطة النهاية، يقوم Braze بإدراج سلسلة نصية فارغة، لذا تأكد من كتابة خيار بديل قبل طبقة التخصيص.
• لا يتم احتساب الرسائل التي تم إلغاؤها ضمن عدد الرسائل المرسلة، لذا يرجى مراجعة "مراقبة المراسلات" (Messaging Observability) بعد الإطلاق.
• لا توفر معاينة Composer قيم خصائص الحدث من حدث سابق، لذا قم بتشغيل الحدث أو استخدم إرسالاً تجريبياً مخصصاً.

ما المقصود فعلياً بالتخصيص اللحظي في Braze؟

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

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

ما هي مصادر التخصيص التي يتم حلها في أي لحظة؟

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

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

متى يقوم Braze بمعالجة Liquid في الرسالة؟

وفقاً لـوثائق التخزين المؤقت في Braze، يقوم عامل معالجة في الخلفية بمعالجة قالب Liquid عند إعداد الرسالة للتسليم. يتم تقييم وسوم Connected Content أثناء تلك المعالجة. بالنسبة للقنوات التي يتم تسليمها عبر SDK مثل بطاقات المحتوى، يمكن إنشاء المحتوى عند الانطباع الأول أو وقت العرض.

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

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

ما الذي يحد من مدى حداثة المحتوى المتصل (Connected Content)؟

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

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

يُعد التخزين المؤقت (Caching) حداً آخر. يتم تخزين طلبات GET مؤقتاً بشكل افتراضي، بينما لا يتم تخزين طلبات POST.

يصل عمر التخزين المؤقت إلى خمس دقائق افتراضياً. وتتراوح مدة التخزين المؤقت من خمس دقائق كحد أدنى إلى أربع ساعات كحد أقصى.

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

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

ما الفرق بين متغيرات السياق (context variables) والكتالوجات (catalogs) وبين الاستدعاء المباشر؟

متغيرات السياق هي أجزاء مؤقتة من البيانات تُستخدم ضمن رحلة المستخدم عبر Canvas واحد. يمكن ملؤها عند الدخول من الحدث أو مشغل API، أو تعريفها في خطوة سياق. وهي لا تستمر عبر مسارات Canvas مختلفة، ويحتفظ كل دخول بسياقه المستقل.

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

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

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

ما الذي يجب أن تفعله الرسالة عند فقدان البيانات المباشرة؟

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

يعد الإلغاء خياراً موثقاً، و وثائق الإلغاء تنص على أن السبب يجب أن يكون سلسلة نصية لا تحتوي على Liquid. تظهر الرسالة الملغاة في "مراقبة المراسلات" (Messaging Observability) بنتيجة "إلغاء Liquid". لا تحتسب Braze الرسائل الملغاة ضمن عدد الرسائل المرسلة في حساب Braze الخاص بك أو في Currents.

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

كيف يمكن لتطبيق تذاكر افتراضي اختيار مصادر بياناته؟

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

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

يحصل العميل الذي يدخل لفعاليتين على تذكيرين، يحدد كل منهما الحجز الصحيح.

تأتي تفاصيل المكان من الكتالوج، لأنها مشتركة بين جميع الحاضرين في تلك الفعالية.

تتغير توفر ترقيات المقاعد بسرعة. يأتي هذا السطر من نقطة نهاية التطبيق الخاصة عبر "المحتوى المتصل" (Connected Content) وقت الإرسال، ويقبل الفريق حقيقة أنها قد تكون قديمة بقدر ما يسمح به التخزين المؤقت.

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

كيف تختبر التخصيص الذي يعتمد على بيانات حية؟

استخدم نفس الإجراء لكل رسالة تعتمد على بيانات حية، بالاستعانة بـ وثائق المعاينة في Braze:

1. قم بالمعاينة كمستخدم مخصص لكل فرع، بما في ذلك مستخدم بقيم فارغة.
2. قم بتفعيل الحدث أو استخدم إرسالاً تجريبياً مخصصاً لتخصيص خصائص الحدث، لأن معاينة المُنشئ لا توفر تلقائياً قيم خصائص الحدث من حدث سابق.
3. أضف قيماً افتراضية قبل تشغيل Inbox Vision، لأن Braze تنشئ نموذجاً لمستخدم فارغ عند تشغيله.
4. قم بإجراء معاينة لمسار Canvas باستخدام مستخدم فعلي يشبه السيناريو الخاص بك، حيث إن خيار المستخدم المخصص غير متاح لمعاينة مسار Canvas.
5. أرسل اختباراً إلى جهاز حقيقي، فمعاينة المُنشئ هي مجرد خطوة واحدة ضمن سير عمل ضمان الجودة، وليست الفحص الوحيد.

هناك سلوكان للمعاينة يسهل التغاضي عنهما.

قد يتم تقييم لغة Liquid القائمة على الوقت بناءً على الوقت الحالي في المعاينة، وليس الوقت الذي سيصل فيه المستخدم إلى تلك الخطوة في بيئة الإنتاج. كما يتم تنفيذ المحتوى المتصل (Connected Content) أثناء معاينات مسار Canvas، لذا فإن الاستدعاءات التي تُحدّث الأنظمة الخارجية أو بيانات المستخدم قد يكون لها آثار جانبية خارج نطاق الاختبار.

ما هي الأخطاء التي تقوض التخصيص في الوقت الفعلي؟

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

الخطأ الثاني يتعلق بما يتم تضمينه في رابط URL الخاص بالطلب.

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

الخطأ الثالث هو استدعاء نقطة نهاية تُغير البيانات أثناء معاينة Canvas. قم بإزالة أو حماية المحتوى المتصل الذي يغير بيانات الإنتاج قبل إجراء المعاينة.

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

يحتوي المحتوى المتصل على عدة أجزاء مترابطة، لذا ابدأ بـ استخدام المحتوى المتصل من Braze للحملات المخصصة. بالنسبة لجانب Liquid، اقرأ كيفية تعزيز التخصيص باستخدام وسوم Liquid في Braze. للحصول على نظرة أوسع حول ما يمكن أن تحققه الرسائل المخصصة، راجع كيفية تفعيل التخصيص الفائق في حملات Braze.

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

إندراسة حالة حول ترحيل منصة مكافآت تغطي هذه الدراسة طرح أتمتة التسويق التي تضمنت محتوى متصلاً (Connected Content) مباشراً. وبصفتها شريكاً في تنفيذ Braze، توصي CustomerIK بتدوين مصدر كل قيمة مخصصة، وميزانية التحديث، والمحتوى البديل قبل البدء بكتابة النصوص.

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

1. هل تقوم Braze بمعالجة التخصيص عند إرسال الرسالة؟

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

2. ما مدى حداثة المحتوى المتصل (Connected Content)؟

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

3. ماذا يحدث إذا فشلت نقطة نهاية المحتوى المتصل (Connected Content) الخاصة بي؟

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

4. هل تستمر متغيرات السياق (Context variables) بعد انتهاء الـ Canvas؟

لا، فهي موجودة فقط ضمن جلسة الـ Canvas ولا تستمر عبر الـ Canvases المختلفة أو خارج نطاق الجلسة.

5. هل يمكنني اختبار تخصيص خصائص الحدث (event-property) في معاينة المُنشئ (composer preview)؟

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

المصادر

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

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

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