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

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

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

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

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

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

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

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

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

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

• 5228
• 5229
• 5230

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

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

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

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

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

رقم تعريف عملية تثبيت Firebase (FID) هو معرّف نسخة التطبيق. يتم تلقائيًا الاحتفاظ بنسخة احتياطية من بيانات عملية تثبيت Firebase واستعادتها. في حالة الاستعادة، تشارك نسخة التطبيق المستعادة ونسخة التطبيق الأصلية رقم تعريف عملية تثبيت Firebase نفسه. بما أنّ خدمة FCM تخزّن رمزًا واحدًا فقط لكل رقم تعريف عملية تثبيت Firebase، إذا كانت نسخة التطبيق الأصلية ونسخة التطبيق المستعادة قيد الاستخدام، فعندما تسجّل إحدى نسختَي التطبيق في خدمة FCM، تتم إزالة رمز نسخة التطبيق الأخرى، ما يؤدي إلى ظهور أخطاء 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 إشعارًا مسبقًا بهذه التغييرات متى أمكن ذلك. يُرجى إبقاء جهات اتصال اتفاقية خدمات Google Cloud الرئيسية محدّثة لزيادة فرص تلقّي إعلانات الخدمة.