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

يمكنك إرسال رسائل الإشعارات باستخدام أداة إنشاء الإشعارات في Firebase console. على الرغم من أنّ هذه الطريقة لا توفّر المرونة أو قابلية التوسّع نفسها التي يوفّرها إرسال الرسائل باستخدام Firebase Admin SDK أو الـ HTTP v1 API، يمكن أن تكون مفيدة جدًا للاختبار أو للتسويق واستهداف المستخدمين بشكلٍ دقيق. يوفر Firebase console اختبار A/B استنادًا إلى الإحصاءات للمساعدة في تحسين الرسائل التسويقية.

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

لمحة عامة

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

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

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

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

المفاتيح التي يرسلها Firebase console إلى العملاء هي:

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

تشمل المفاتيح التي تؤثر في سلوك تسليم الرسائل ما يلي:

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