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

تقدّم هذه الصفحة مساعدة في تحديد المشاكل وحلّها، كما تقدّم إجابات عن الأسئلة الشائعة حول Cloud Messaging.

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

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

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

الإمكانات		منشئ الإشعارات	Cloud Messaging
الهدف	جهاز واحد
	العملاء المشتركون في مواضيع (مثل الطقس)
	العملاء في شريحة المستخدمين المحدّدة مسبقًا (التطبيق والإصدار واللغة)
	العملاء في شرائح جمهور محدّدة في "إحصاءات Google"
	العملاء في مجموعات الأجهزة
	التحميل من العميل إلى الخادم
نوع الرسالة	الإشعارات التي يصل حجمها إلى 2 كيلوبايت
	رسائل البيانات التي تصل إلى 4 كيلوبايت
التسليم	فوري
	التوقيت المحلي لجهاز العميل المستقبلي
الإحصاءات	جمع إحصاءات "الإشعارات المضمّنة" وتحليل مسار الإحالة الناجحة

هل يجب استخدام خدمات 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. بالنسبة إلى رسائل الإشعارات التي تتضمّن حمولة بيانات، يتم عرض رسالة الإشعار في علبة النظام، ويمكن استرداد البيانات المضمّنة في رسالة الإشعار من الغرض الذي يتم تشغيله عندما ينقر المستخدم على الإشعار.

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

لماذا يتلقّى تطبيقي رسالة الخطأ "Invalid argument for the given fid" عند التسجيل باستخدام FCM؟

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

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

• استبعاد بيانات تثبيت Firebase من النسخة الاحتياطية يتم تخزين بيانات تثبيت Firebase في ملف PersistedInstallation....json. اسم الملف هو قيمة ثابتة لأحد التطبيقات، مثل <exclude domain="file" path="PersistedInstallation....json" />
• احذف الملف PersistedInstallation....json عند تلقّي الخطأ "Invalid argument for the given fid". في المرة التالية التي يسجّل فيها تطبيقك الدخول باستخدام FCM، سيتم إنشاء معرّف جديد لجهاز التثبيت.

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

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

حصص وحدود FCM

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

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

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

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

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

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

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

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

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

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

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

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

هل يمكنني الحصول على حصة إضافية لحدث مؤقت؟

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

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

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