تحديد المشاكل وحلّها والأسئلة الشائعة حول "المراسلة عبر السحابة الإلكترونية من 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 واستعادتها. لذلك، في حالة الاستعادة، يتشارك مثيل التطبيق المستعاد ومثيل التطبيق الأصلي معرّف FID نفسه. بما أنّ خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" تخزِّن رمزًا مميزًا واحدًا فقط لكل معرّف مثيل Firebase، إذا كان كل من مثيل التطبيق الأصلي ومثيل التطبيق الذي تم استعادته قيد الاستخدام، وعندما يسجّل أحد مثيلَي التطبيق في خدمة "المراسلة عبر السحابة الإلكترونية من Firebase"، تتم إزالة الرمز المميز لمثيل التطبيق الآخر، ما يؤدي إلى حدوث أخطاء 404.

ننصح المطوّرين باتّخاذ الإجراءات التالية في تطبيقاتهم:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

هل حصتي الحالية عرضة للتغيير؟

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