إعداد مشغلات التفاعل في Braze: دليل عملي

Hand marking one row on a printed one-page register on a desk, showing a Braze trigger, its audience filter and its re-eligibility rule reviewed together.

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

أبرز النقاط

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

ما الذي يُعد مشغل تفاعل في Braze؟

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

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

بعد وقوع الإجراء، يمكنك تحديد موعد إرسال الرسالة: فوراً، أو بعد فترة زمنية محددة، أو في وقت معين، أو في وقت مستقبلي.

كيف تختلف مشغلات التفاعل في Braze باختلاف نوع الدخول؟

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

نوع الدخول	ما الذي يبدأ الدخول	مكان العثور على الإعدادات
مجدول	جدول زمني، لمرة واحدة أو بشكل دوري (يومي، أسبوعي، شهري)	يمكن للتكرار السماح بما يصل إلى 30 دخولاً مخصصاً لكل مستخدم
قائم على الإجراء	إجراء المستخدم مثل بدء جلسة أو حدث مخصص	نافذة جمهور الدخول، مع خيارات إعادة الأهلية وتحديد تكرار الرسائل
مُشغل عبر API	استدعاء لواجهة برمجة تطبيقات Braze من خوادمك الخاصة	معرف الحملة (Campaign ID) أو معرف Canvas الذي توفره لك Braze

بالنسبة للتسليم عبر واجهة برمجة التطبيقات (API)، توفر لك Braze معرف حملة لاستخدامه مع /campaigns/trigger/send نقطة النهاية، أو معرف Canvas لـ /canvas/trigger/send نقطة النهاية. تظل نصوص الرسائل، واختبارات المتغيرات المتعددة، وقواعد إعادة الأهلية في لوحة تحكم Braze، مما يمنح المسوقين السيطرة على محتوى الرسالة بينما يتولى المهندسون إدارة المشغل.

ما هي الإعدادات القائمة على الإجراء التي تتطلب عناية خاصة؟

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

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

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

هناك حدّان إضافيان يجدر بك معرفتهما. مشغّل "التفاعل مع خطوة Canvas" متاح للحملات، ولكنه ليس متاحاً كمشغّل دخول قائم على الإجراء لـ Canvas. لبدء Canvas من آخر، استخدم مكوّن "الإرسال إلى Canvas الوجهة" أو خطاف ويب (webhook) من Braze إلى Braze يستدعي نقطة نهاية مشغّل Canvas.

كيف تغيّر إعادة الأهلية من أداء المشغّل؟

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

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

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

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

كيف يمكنك تفعيل حملة من أنظمتك الخاصة؟

يتيح لك التسليم المفعّل عبر واجهة برمجة التطبيقات (API) تحديد التوقيت من خوادمك. يمكن للطلب أيضاً حمل بيانات يقوم Braze بدمجها في قوالب الرسائل في الوقت الفعلي. يقدّم Braze نموذجاً لكائن المستلم لـ Canvas، يظهر أدناه كما هو موضح في صفحة "إنشاء Canvas".

{ "external_user_id": "user_123", "context": { "product_name": "shoes" }}

يعتمد المفتاح الذي يحمل بيانات الدخول على مساحة العمل الخاصة بك. إذا كانت لوحة التحكم تعرض "متغيرات السياق" (Context Variables)، فاستخدم الكائن context . وإذا كانت تعرض "خصائص دخول Canvas" (Canvas Entry Properties)، فاستخدم الكائن القديم canvas_entry_properties من نموذج لوحة التحكم.

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

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

تحقق من هذه الحدود مقابل الوثائق الحالية قبل الاعتماد عليها، نظراً لأن سلوكيات إعادة المحاولة والإعدادات الافتراضية قد تتغير.

كيف تتعامل حدود التكرار والأولويات مع الرسائل المُرسلة عبر المشغلات (Triggered Sends)؟

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

يمكن للحملات وCanvas القائمة على الإجراءات المشاركة في "أولوية الرسائل". أما الحملات وCanvas التي يتم تشغيلها عبر واجهة برمجة التطبيقات (API) فلا تشارك في ذلك. بالنسبة لحملات API التي يجب إرسالها دائماً، يمكنك ضبط override_frequency_capping على القيمة true في الطلب.

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

كيف ستؤثر هذه القرارات على تطبيق اشتراكات افتراضي؟

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

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

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

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

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

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

تندرج أنواع الدخول ضمن رحلات أوسع، والتي أتمتة حملات Canvas للهواتف المحمولةوسير عمل التسويق المؤتمت في Braze تصفها. تأتي عوامل تصفية الجمهور من تقسيم الجمهور، ويتم تناول المحتوى الذي يتغير وقت الإرسال في التخصيص في الوقت الفعلي.

ما الذي يجب عليك التحقق منه قبل إطلاق مشغل (Trigger)؟

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

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

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

1. ما الفرق بين الدخول القائم على الإجراء والدخول عبر واجهة برمجة التطبيقات (API)؟

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

2. هل يمكن للمشغل أن يعمل أكثر من مرة لنفس المستخدم؟

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

3. لماذا تم إرسال حملة Canvas القائمة على الإجراء الخاصة بي في وقت أبكر مما كان متوقعاً؟

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

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

تنصح Braze بعدم القيام بذلك. فقد تؤدي حالة السباق (Race condition) إلى خروج المستخدم من الجمهور عند تفعيل المشغل، مما يجعله يفوت الحملة أو Canvas.

5. هل تشارك الحملات التي يتم تشغيلها عبر واجهة برمجة التطبيقات (API) في ميزة تحديد أولويات الرسائل؟

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

المصادر

Braze،أنواع التسليم والدخولتم الاسترجاع في 21 أكتوبر 2026.
Braze،إنشاء Canvasتم الاسترجاع في 21 أكتوبر 2026.
Braze،إعادة التأهيل للحملات وCanvasتم الاسترجاع في 21 أكتوبر 2026.
Braze،التسليم عبر واجهة برمجة التطبيقات (API)تم الاسترجاع في 21 أكتوبر 2026.
Braze،تحديد معدل الإرسال وحدود التكرارتم الاسترجاع في 21 أكتوبر 2026.
Braze،تحديد أولويات الرسائلتم الاسترجاع في 21 أكتوبر 2026.
بقلم CustomerIK، شريك تنفيذ معتمد لـ Braze.

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

إذا كنت ترغب في مراجعة مشغلاتك، وفلاتر الجمهور، وقواعد إعادة التأهيل معاً قبل إطلاقها، دعنا نتحدث.