این صفحه راهنمایی عیب‌یابی و پاسخ به سؤالات متداول درباره Cloud Messaging را ارائه می‌دهد.
Firebase Cloud Messaging مجموعه کاملی از قابلیت های پیام رسانی را از طریق SDK های مشتری و پروتکل سرور HTTP خود ارائه می دهد. برای استقرار با الزامات پیام رسانی پیچیده تر، FCM انتخاب مناسبی است.
Notifications composer یک راه حل پیام رسانی سبک و بدون سرور است که بر روی Firebase Cloud Messaging ساخته شده است. با یک کنسول گرافیکی کاربرپسند و نیازهای کمتر کدنویسی، Notifications composer به کاربران اجازه می‌دهد پیام‌هایی را برای جذب مجدد و حفظ کاربران، رشد برنامه‌ها و حمایت از کمپین‌های بازاریابی ارسال کنند.
| قابلیت ها | آهنگساز اعلان ها | Cloud Messaging | |
|---|---|---|---|
| هدف | تک دستگاه | ||
| مشتریان مشترک در موضوعات (به عنوان مثال آب و هوا) | |||
| مشتریان در بخش کاربر از پیش تعریف شده (برنامه، نسخه، زبان) | |||
| مشتریان در مخاطبان تجزیه و تحلیل مشخص | |||
| مشتریان در گروه های دستگاه | |||
| بالادست از کلاینت به سرور | |||
| نوع پیام | اعلان ها تا 2 کیلوبایت | ||
| پیام های داده تا 4 کیلوبایت | |||
| تحویل | فوری | ||
| دستگاه مشتری آینده به وقت محلی | |||
| تجزیه و تحلیل | مجموعه تحلیل داخلی Notifications و تجزیه و تحلیل قیف |
شما می توانید از 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 فراخوانی نمی‌شود. برای پیام‌های اعلان با محموله داده، پیام اعلان در سینی سیستم نمایش داده می‌شود و داده‌هایی که با پیام اعلان ارائه شده‌اند را می‌توان از هدف راه‌اندازی شده با ضربه زدن کاربر بر روی اعلان بازیابی کرد.
برای اطلاعات بیشتر، به دریافت و مدیریت پیام ها مراجعه کنید.
FID (شناسه نصب Firebase) شناسه یک نمونه برنامه است. اگر داده‌های نصب یک نمونه برنامه از یک نسخه پشتیبان بازیابی شود، FCM این خطا را برمی‌گرداند تا نشان دهد که FID قبلاً توسط یک نمونه برنامه دیگر اشغال شده است، بنابراین نمونه برنامه فعلی نمی‌تواند از FID برای ثبت در FCM استفاده کند.
ما به توسعه دهندگان توصیه می کنیم در برنامه خود کارهای زیر را انجام دهند:
- داده‌های نصب Firebase را در پشتیبان‌گیری حذف کنید . اطلاعات نصب Firebase در فایل
PersistedInstallation....jsonذخیره می شود. نام فایل برای یک برنامه ثابت است. به عنوان مثال،<exclude domain="file" path="PersistedInstallation....json" /> - فایل
PersistedInstallation....jsonدر دریافت خطاهای "آگومان نامعتبر برای fid داده شده" حذف کنید. دفعه بعد که برنامه شما در FCM ثبت نام می کند، یک FID جدید ایجاد می شود.
خیر. Firebase Cloud Messaging در سال 2017 به پروتکل APN مبتنی بر HTTP/2 تغییر مکان داد. اگر از FCM برای ارسال اعلان‌ها به دستگاه‌های iOS استفاده می‌کنید، نباید اقدامی از جانب شما انجام شود.
سهمیه ها و محدودیت های FCM
این مورد استفاده قابل پشتیبانی نیست. شما باید ترافیک خود را بیش از 5 دقیقه پخش کنید.
متأسفانه به همین دلیل نمی توانیم افزایش سهمیه بدهیم. شما باید ترافیک خود را بیش از 5 دقیقه پخش کنید تا از ترافیک شدید جلوگیری کنید .
توصیه می کنیم حداقل 5 دقیقه قبل از رویداد شروع به ارسال اعلان ها کنید. از طرف دیگر، پیام‌های داده ارسال کنید و آنالوگ پلتفرم خود را از onMessageReceived اجرا کنید تا اعلان‌های محلی را زودتر از موعد برنامه‌ریزی کنید.
راهنمای Google Cloud در مورد نحوه نمودار و نظارت بر معیارهای سهمیه را ببینید.
در حالی که ما می دانیم که محدودیت های سهمیه می تواند چالش برانگیز باشد، سهمیه ها برای قابل اعتماد نگه داشتن خدمات حیاتی هستند و ما نمی توانیم معافیت هایی اعطا کنیم. برای مدیریت صحیح خطاهای 429 از تلاش های مجدد استفاده کنید.
درخواست افزایش سهمیه شما بستگی به استفاده شما از FCM دارد. در هر صورت، می توانید در چند روز کاری منتظر پاسخ باشید. در برخی موارد، ممکن است مواردی در مورد استفاده شما از FCM و شرایط مختلف وجود داشته باشد که می تواند روند را طولانی کند. اگر همه الزامات برآورده شوند، اکثر درخواست‌ها ظرف 2 هفته رسیدگی می‌شوند.
می‌توانید برای حمایت از رویدادی که حداکثر ۱ ماه طول می‌کشد، سهمیه اضافی درخواست کنید. درخواست را حداقل 1 ماه قبل از رویداد و با جزئیات روشن در مورد زمان شروع و پایان رویداد ثبت کنید و FCM تمام تلاش عملی خود را برای انجام این درخواست انجام خواهد داد. اگر اعطا شود، این افزایش سهمیه پس از تاریخ پایان رویداد برگردانده خواهد شد.
در حالی که گوگل این کار را ساده انجام نمی دهد، ممکن است سهمیه ها در صورت لزوم برای محافظت از یکپارچگی سیستم تغییر کنند. در صورت امکان، Google از قبل شما را از چنین تغییراتی مطلع خواهد کرد. برای افزایش شانس دریافت اطلاعیه های خدمات، مخاطبین Cloud MSA خود را به روز نگه دارید.