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

يمكنك إرسال رسائل الإشعارات باستخدام مؤلف الإشعارات في وحدة تحكم Firebase. وعلى الرغم من أنّ هذا لا يوفر المرونة أو قابلية التوسع نفسها التي يوفرها إرسال الرسائل باستخدام حزمة تطوير البرامج (SDK) للمشرف أو بروتوكول HTTP وXMPP، إلا أنّه يمكن أن يكون مفيدًا جدًا للاختبار أو للتسويق وتفاعل المستخدمين بشكل موجَّه للغاية. توفّر وحدة تحكُّم Firebase اختبار A/B مستند إلى الإحصاءات للمساعدة في تنقيح الرسائل التسويقية وتحسينها.

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

لمحة عامة

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

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

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

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

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

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

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

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