إرسال الرسائل باستخدام "وحدة تحكُّم Firebase"

يمكنك إرسال رسائل إشعارات باستخدام أداة إنشاء الإشعارات في وحدة تحكّم Firebase. على الرغم من أنّ هذا الإجراء لا يقدّم المستوى نفسه من المرونة أو قابلية التوسّع مثل إرسال الرسائل باستخدام Admin SDK أو بروتوكول HTTP‏ 1.1، إلا أنّه يمكن أن يكون مفيدًا جدًا للاختبار أو للتسويق المستهدف للغاية وتفاعل المستخدمين. توفّر وحدة تحكّم Firebase اختبار أ/ب بالاستناد إلى الإحصاءات للمساعدة في تحسين الرسائل التسويقية و تحسينها.

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

لمحة عامة

عند إرسال رسالة إشعار من أداة إنشاء الإشعارات، تستخدم Google القيم التي تُدخلها في حقول النموذج بالطُرق التالية:

• تحدِّد حقول مثل شريحة المستخدمين وتاريخ انتهاء الصلاحية استهداف الرسالة وخيارات إرسالها.
• يتم إرسال حقول مثل نص الإشعار والبيانات المخصّصة إلى العميل في حمولة تتألف من أزواج مفاتيح/قيم.

يتم ربط هذه الحقول بالمفاتيح المتاحة من خلال عنصر Message. على سبيل المثال، يتم التعامل مع أزواج المفاتيح/القِيم التي يتم إدخالها في حقل البيانات المخصّصة في أداة إنشاء الرسائل على أنّها حمولة data للإشعار. يتمّ ربط الحقول الأخرى مباشرةً بالمفاتيح في كائن notification أو في إعدادات الإشعارات الخاصة بالمنصة.

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

مفاتيح وحدة تحكّم Firebase التي يتم إرسالها إلى العملاء هي:

المفتاح	تصنيف حقل وحدة التحكّم	الوصف
notification.title	عنوان الإشعار	يشير إلى عنوان الإشعار.
notification.body	نص الإشعار	يشير إلى نص الإشعار.
data	البيانات المخصّصة	أزواج المفتاح/القيمة التي تحدّدها ويتم إرسالها كحمولة بيانات ليعالجها التطبيق.

تشمل المفاتيح التي تحدّد تسليم الرسائل ما يلي:

المفتاح	تصنيف حقل وحدة التحكّم	الوصف
sound	الصوت	يشير إلى صوت يتم تشغيله عندما يتلقّى الجهاز إشعارًا.
time_to_live	تاريخ انتهاء الصلاحية	تحدِّد هذه المَعلمة المدة (بالثواني) التي يجب الاحتفاظ فيها بالرسالة في مساحة تخزين FCM إذا كان الجهاز غير متصل بالإنترنت. لمزيد من المعلومات، يُرجى الاطّلاع على ضبط مدة صلاحية الرسالة.