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

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

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

لمحة عامة

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

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

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

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

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

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

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

المفتاح تصنيف حقل وحدة التحكّم الوصف
sound الصوت

يشير إلى صوت يتم تشغيله عندما يتلقّى الجهاز إشعارًا.

time_to_live تاريخ انتهاء الصلاحية

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