تحديد المشاكل وحلّها والأسئلة الشائعة حول "المراسلة عبر السحابة الإلكترونية من Firebase"

ما الفرق بين أداة إنشاء الإشعارات وFCM؟

Firebase Cloud Messaging توفّر مجموعة كاملة من إمكانات المراسلة من خلال حِزم تطوير البرامج (SDK) للعميل وبروتوكول خادم HTTP. بالنسبة إلى عمليات النشر التي تتضمّن متطلبات مراسلة أكثر تعقيدًا، تُعدّ خدمة المراسلة عبر السحابة الإلكترونية من Firebase الخيار المناسب.

أداة إنشاء الإشعارات هي حلّ خفيف الوزن وبدون خادم للمراسلة يستند إلى Firebase Cloud Messaging. من خلال وحدة تحكّم رسومية سهلة الاستخدام ومتطلبات ترميز مخفّضة، تتيح أداة إنشاء الإشعارات للمستخدمين إرسال رسائل لإعادة جذب المستخدمين والاحتفاظ بهم وتعزيز نمو التطبيق ودعم الحملات التسويقية.

هل يجب استخدام خدمات Firebase الأخرى لاستخدام FCM؟

يمكنك استخدام Firebase Cloud Messaging كمكوّن مستقل بدون استخدام خدمات Firebase الأخرى.

لماذا يبدو أنّ الأجهزة المستهدَفة لا تتلقّى الرسائل؟

إذا بدا أنّ الأجهزة لم تتلقَّ الرسائل بنجاح، تحقَّق أولاً من هذَين السببَين المحتمَلَين:

معالجة الرسائل في المقدّمة لرسائل الإشعارات: على تطبيقات العميل إضافة منطق معالجة الرسائل لمعالجة رسائل الإشعارات عندما يكون التطبيق في المقدّمة على الجهاز. يمكنك الاطّلاع على التفاصيل الخاصة بأجهزة iOS وأجهزة Android.

القيود المفروضة على جدار حماية الشبكة: إذا كانت مؤسستك تستخدم جدار حماية يقيّد الزيارات من الإنترنت أو إليه، عليك ضبطه للسماح بالاتصال بخدمة FCM لكي تتلقّى تطبيقات العميل في Firebase Cloud Messaging الرسائل. المنافذ التي يجب فتحها هي:

• 5228
• 5229
• 5230

FCM تستخدم عادةً المنفذ 5228، ولكنها تستخدم أحيانًا المنفذَين 5229 و5230. لا توفّر خدمة المراسلة عبر السحابة الإلكترونية من Firebase عناوين IP محدّدة، لذا عليك السماح لجدار الحماية بقبول الاتصالات الصادرة لجميع عناوين IP المضمّنة في مجموعات عناوين IP الواردة في رقم النظام المستقل (ASN) 15169 الخاص بـ Google.FCM

لماذا لا يتم استدعاء onMessageReceived في تطبيق Android؟

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

لمزيد من المعلومات، يمكنك الاطّلاع على مقالة تلقّي الرسائل ومعالجتها.

لماذا أتلقّى الخطأ 404 عند إرسال رسائل إلى نسخة نشطة من التطبيق تم استعادتها من نسخة احتياطية؟

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

ننصح المطوّرين بتنفيذ ما يلي في تطبيقاتهم:

• استبعاد بيانات عملية تثبيت Firebase في النسخة الاحتياطية. يتم تخزين بيانات عملية تثبيت Firebase في ملف PersistedInstallation....json. اسم الملف هو قيمة ثابتة للتطبيق، على سبيل المثال، <exclude domain="file" path="PersistedInstallation.W0R...GQ.json" />

أعلنت Apple عن إيقاف بروتوكول التنسيق الثنائي القديم لخدمة APNs. هل يجب اتخاذ أي إجراء؟

لا، فقد انتقلت Firebase Cloud Messaging إلى بروتوكول APNs المستند إلى HTTP/2 في عام 2017. إذا كنت تستخدم FCM لإرسال إشعارات إلى أجهزة iOS، لن تحتاج إلى اتخاذ أي إجراء.

كيف يمكنني إرسال إشعارات إلى قاعدة عملاء كبيرة خلال دقيقتَين؟

لا يمكن تنفيذ حالة الاستخدام هذه. عليك توزيع الزيارات على مدار 5 دقائق.

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

لا يمكننا زيادة الحصة لهذا السبب. عليك توزيع الزيارات على مدار 5 دقائق لتجنُّب الزيارات المفاجئة.

تتعلّق رسائلي بالأحداث المجدولة. كيف يمكنني إرسال كل الزيارات في بداية الساعة؟

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

كيف يمكنني تتبُّع استخدامي للحصة؟

يمكنك الاطّلاع على إرشادات Google Cloud حول كيفية رسم مقاييس الحصة وتتبُّعها.

يصعب عليّ وعلى مؤسستي التعامل مع الأخطاء 429. هل يمكنني الحصول على إعفاء أو حصة أكبر لتجنُّب ظهور الأخطاء 429؟

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

كم من الوقت يستغرق تنفيذ طلب زيادة الحصة؟

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

هل يمكنني الحصول على حصة أكبر لحدث مؤقت؟

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

هل يمكن تغيير حصتي الحالية؟

لن تفعل Google ذلك إلا إذا لزم الأمر لحماية سلامة النظام، ولكن قد يتم تغيير الحصص حسب الحاجة. سترسل لك Google إشعارًا مسبقًا بهذه التغييرات متى أمكن ذلك. يُرجى إبقاء جهات اتصال اتفاقية خدمة رئيسية (MSA) في Google Cloud محدّثة لزيادة فرص تلقّي إشعارات عن الخدمة.