การแก้ปัญหาและคำถามที่พบบ่อยเกี่ยวกับ Firebase Cloud Messaging

Notifications Composer และ FCM แตกต่างกันอย่างไร

Firebase Cloud Messaging มีชุดความสามารถในการรับส่งข้อความที่สมบูรณ์ผ่าน SDK ของไคลเอ็นต์และโปรโตคอลเซิร์ฟเวอร์ HTTP สำหรับการติดตั้งใช้งานที่มีข้อกำหนดด้านการรับส่งข้อความที่ซับซ้อนมากขึ้น FCM คือตัวเลือกที่เหมาะสม

Notifications Composer เป็นโซลูชันการรับส่งข้อความแบบ Serverless ที่มีขนาดเล็กซึ่งสร้างขึ้นบน Firebase Cloud Messaging Notifications Composer มีคอนโซลแบบกราฟิกที่ใช้ง่ายและลดข้อกำหนดในการเขียนโค้ด จึงช่วยให้ผู้ใช้ส่งข้อความเพื่อดึงดูดและรักษาผู้ใช้ไว้ ส่งเสริมการเติบโตของแอป และสนับสนุนแคมเปญการตลาดได้

ฉันจำเป็นต้องใช้บริการอื่นๆ ของ Firebase เพื่อใช้ FCM ไหม

คุณสามารถใช้ Firebase Cloud Messaging เป็นคอมโพเนนต์แบบสแตนด์อโลนได้โดยไม่ต้องใช้บริการอื่นๆ ของ Firebase

เหตุใดอุปกรณ์เป้าหมายของฉันจึงไม่ได้รับข้อความ

เมื่อดูเหมือนว่าอุปกรณ์ไม่ได้รับข้อความ ให้ตรวจสอบสาเหตุที่เป็นไปได้ 2 ประการต่อไปนี้ก่อน

การจัดการข้อความที่ทำงานอยู่เบื้องหน้าสำหรับข้อความแจ้งเตือน แอปไคลเอ็นต์ต้องเพิ่มตรรกะการจัดการข้อความเพื่อจัดการข้อความแจ้งเตือนเมื่อแอปทำงานอยู่เบื้องหน้าในอุปกรณ์ ดูรายละเอียดสำหรับ iOS และ Android

ข้อจำกัดของไฟร์วอลล์เครือข่าย หากองค์กรของคุณมีไฟร์วอลล์ที่จำกัดการรับส่งข้อมูลไปยังหรือจากอินเทอร์เน็ต คุณต้องกำหนดค่าไฟร์วอลล์เพื่ออนุญาตการเชื่อมต่อกับ FCM เพื่อให้แอปไคลเอ็นต์ Firebase Cloud Messaging ของคุณรับข้อความได้ พอร์ตที่ต้องเปิดมีดังนี้

• 5228
• 5229
• 5230

โดยปกติแล้ว FCM จะใช้พอร์ต 5228 แต่บางครั้งก็ใช้พอร์ต 5229 และ 5230 FCM ไม่ได้ระบุ IP ที่เฉพาะเจาะจง ดังนั้นคุณควรอนุญาตให้ไฟร์วอลล์ยอมรับการเชื่อมต่อขาออกกับที่อยู่ IP ทั้งหมดในบล็อก IP ซึ่งแสดงใน ASN 15169 ของ Google

เหตุใดจึงไม่มีการเรียกใช้ onMessageReceived ในแอป Android ของฉัน

เมื่อแอปทำงานอยู่เบื้องหลัง ข้อความแจ้งเตือนจะแสดงในถาดระบบ และระบบจะไม่เรียกใช้ onMessageReceived สำหรับข้อความแจ้งเตือนที่มีเพย์โหลดข้อมูล ข้อความแจ้งเตือนจะแสดงในถาดระบบ และข้อมูลที่รวมอยู่ในข้อความแจ้งเตือนจะดึงมาจาก Intent ที่เปิดขึ้นเมื่อผู้ใช้แตะการแจ้งเตือน

ดูข้อมูลเพิ่มเติมได้ที่หัวข้อรับและจัดการข้อความ

เหตุใดฉันจึงได้รับข้อผิดพลาด 404 เมื่อส่งข้อความไปยังอินสแตนซ์แอปที่ใช้งานอยู่ซึ่งกู้คืนจากข้อมูลสำรอง

FID (รหัสการติดตั้ง Firebase) คือตัวระบุอินสแตนซ์ของแอป โดยค่าเริ่มต้น ระบบจะสำรองและกู้คืนข้อมูลการติดตั้ง Firebase ดังนั้นในกรณีการกู้คืน อินสแตนซ์แอปที่กู้คืนและอินสแตนซ์แอปเดิมจะใช้ FID เดียวกัน เนื่องจาก FCM จัดเก็บโทเค็นเพียงรายการเดียวต่อ FID หากมีการใช้งานทั้งอินสแตนซ์แอปเดิมและอินสแตนซ์แอปที่กู้คืน เมื่ออินสแตนซ์แอปหนึ่งลงทะเบียนกับ FCM ระบบจะนำโทเค็นของอินสแตนซ์แอปอีกรายการออก ซึ่งทำให้เกิดข้อผิดพลาด 404

เราขอแนะนำให้นักพัฒนาแอปดำเนินการต่อไปนี้ในแอป

• ยกเว้นข้อมูลการติดตั้ง Firebase ในข้อมูลสำรอง ระบบจะจัดเก็บข้อมูลการติดตั้ง Firebase ไว้ในไฟล์ PersistedInstallation....json ชื่อไฟล์เป็นค่าคงที่สำหรับแอป เช่น <exclude domain="file" path="PersistedInstallation.W0R...GQ.json" />

Apple ประกาศว่าจะเลิกใช้งานโปรโตคอลไบนารีเดิมสำหรับ APNs ฉันต้องทำอะไรไหม

ไม่ Firebase Cloud Messaging เปลี่ยนไปใช้โปรโตคอล APN ที่ใช้ HTTP/2 ในปี 2017 หากคุณใช้ FCM เพื่อส่งการแจ้งเตือนไปยังอุปกรณ์ iOS คุณก็ไม่จำเป็นต้องดำเนินการใดๆ

ฉันจะแจ้งเตือนฐานลูกค้าขนาดใหญ่ภายใน 2 นาทีได้อย่างไร

ระบบไม่รองรับกรณีการใช้งานนี้ คุณต้องกระจายการเข้าชมเป็นเวลา 5 นาที

แอปของฉันแจ้งเตือนผู้ใช้เกี่ยวกับเหตุการณ์ต่างๆ และต้องส่งข้อความเหล่านี้ทันทีเพื่อรองรับโมเดลธุรกิจของฉัน ฉันจะขอโควต้าเพิ่มได้ไหม

ขออภัย เราไม่สามารถเพิ่มโควต้าให้ได้เนื่องจากเหตุผลนี้ คุณต้องกระจายการเข้าชมออกไปเป็นเวลา 5 นาทีเพื่อหลีกเลี่ยงการเข้าชมที่พุ่งสูงขึ้นอย่างรวดเร็ว

ข้อความของฉันเกี่ยวกับกิจกรรมที่กำหนดเวลาไว้ ฉันจะส่งการเข้าชมทั้งหมดในช่วงต้นชั่วโมงได้อย่างไร

เราขอแนะนำให้คุณเริ่มส่งการแจ้งเตือนอย่างน้อย 5 นาทีก่อนเริ่มกิจกรรม หรือส่งข้อความข้อมูลและใช้แอนะล็อกของแฮนเดิล onMessageReceived ของแพลตฟอร์มเพื่อกำหนดเวลาการแจ้งเตือนในเครื่องล่วงหน้า

ฉันจะตรวจสอบการใช้โควต้าได้อย่างไร

ดูคำแนะนำของ Google Cloud เกี่ยวกับวิธีสร้างแผนภูมิและตรวจสอบเมตริกโควต้า

ข้อผิดพลาด 429 เป็นเรื่องยาก ที่ฉันและธุรกิจของฉันจะจัดการได้ ฉันจะขอรับการยกเว้นหรือโควต้าเพิ่มเติมเพื่อหลีกเลี่ยงการได้รับข้อผิดพลาด 429 ได้ไหม

แม้เราจะเข้าใจว่าขีดจำกัดโควต้าอาจเป็นเรื่องที่ท้าทาย แต่โควต้าก็มีความสำคัญต่อการรักษาความน่าเชื่อถือของบริการ และเราไม่สามารถให้การยกเว้นได้ ใช้การลองใหม่เพื่อจัดการข้อผิดพลาด 429 อย่างเหมาะสม

คำขอเพิ่มโควต้าจะใช้เวลานานเท่าใดจึงจะได้รับการดำเนินการ

คำขอเพิ่มโควต้าจะขึ้นอยู่กับการใช้งาน FCM ของคุณ ไม่ว่าในกรณีใด คุณจะได้รับคำตอบภายใน 2-3 วันทำการ ในบางกรณี อาจมีการโต้ตอบไปมาเกี่ยวกับการใช้งาน FCM และสถานการณ์ต่างๆ ซึ่งอาจทำให้กระบวนการยืดเยื้อ หากมีคุณสมบัติตรงตามข้อกำหนดทั้งหมด คำขอส่วนใหญ่จะได้รับการจัดการภายใน 2 สัปดาห์

ฉันจะขอโควต้าเพิ่มสำหรับกิจกรรมชั่วคราวได้ไหม

คุณสามารถขอโควต้าเพิ่มเติมเพื่อรองรับกิจกรรมที่ใช้เวลานานสูงสุด 1 เดือน ยื่นคำขอล่วงหน้าอย่างน้อย 1 เดือนก่อนถึงวันจัดกิจกรรม พร้อมระบุรายละเอียดที่ชัดเจนเกี่ยวกับเวลาเริ่มต้นและสิ้นสุดของกิจกรรม แล้ว FCM จะพยายามอย่างเต็มที่เพื่อดำเนินการตามคำขอ หากได้รับอนุมัติ การเพิ่มโควต้าเหล่านี้จะถูกยกเลิกหลังจากวันที่สิ้นสุดกิจกรรม

โควต้าปัจจุบันของฉันอาจมีการเปลี่ยนแปลงไหม

แม้ว่า Google จะไม่ดำเนินการดังกล่าวโดยไม่จำเป็น แต่โควต้าอาจมีการเปลี่ยนแปลงตามความจำเป็นเพื่อรักษาความสมบูรณ์ของระบบ Google จะแจ้งให้คุณทราบล่วงหน้าเกี่ยวกับการเปลี่ยนแปลงดังกล่าวเมื่อเป็นไปได้ อัปเดตรายชื่อติดต่อ Cloud MSA อยู่เสมอเพื่อเพิ่มโอกาสในการรับประกาศเกี่ยวกับการให้บริการ

API และฟีเจอร์ใดบ้างที่เลิกใช้งานแล้วและจะหยุดให้บริการ ฉันควรทำอย่างไรหากใช้ API เหล่านี้อยู่

เราเลิกใช้งานเซิร์ฟเวอร์ API ของ InstanceId และฟีเจอร์กลุ่มอุปกรณ์ทั้งหมดแล้ว และจะเลิกให้บริการในวันที่ 29 กันยายน 2027 ตารางต่อไปนี้แสดงรายละเอียดเพิ่มเติมเกี่ยวกับ API/ฟีเจอร์ที่เลิกใช้งานและขอให้ดำเนินการ

หากฉันใช้ Firebase Admin SDK เพื่อจัดการการสมัครใช้บริการหัวข้อ ฉันจะได้รับผลกระทบจากการเลิกใช้งานหรือไม่ ควรทำอย่างไร

หากคุณใช้ Firebase Admin SDK เวอร์ชันก่อนหน้าเพื่อจัดการการสมัครใช้บริการหัวข้อ คุณจะได้รับผลกระทบจากการเลิกใช้งาน คุณจะต้องอัปเกรด Firebase Admin SDK เป็นเวอร์ชันต่อไปนี้

ฉันจะเห็นการดาวน์เกรดบริการก่อนวันที่ 29 กันยายน 2027 ไหม

ไม่ คุณมีเวลา 12 เดือนในการย้ายข้อมูลจาก API ที่เลิกใช้งานแล้วไปยัง API ทางเลือกโดยไม่มีการดาวน์เกรดบริการ เราขอแนะนำอย่างยิ่งให้คุณวางแผนการย้ายข้อมูลโดยเร็วที่สุดเพื่อไม่ให้ได้รับผลกระทบจากการเลิกใช้งาน

คุณจะได้รับข้อผิดพลาดเมื่อเรียกใช้ API ที่เลิกใช้งานแล้วหลังจากวันที่ 29 กันยายน 2027

ผู้ใช้ใหม่สามารถเริ่มต้นใช้งาน API/ฟีเจอร์ที่เลิกใช้งานแล้วก่อนที่จะเลิกใช้งานได้ไหม

ผู้ใช้ใหม่สามารถเริ่มต้นใช้งาน API/ฟีเจอร์ที่เลิกใช้งานแล้วได้ก่อนวันที่ 1 มกราคม 2027 หลังจากวันที่ 1 มกราคม 2027 ผู้ใช้ใหม่จะใช้ API ที่เลิกใช้งานแล้วไม่ได้ ผู้ใช้ที่ใช้ API ที่เลิกใช้งานแล้วจะยังคงใช้ API ดังกล่าวต่อไปได้จนถึงวันที่ 29 กันยายน 2027

API ของ AndroidConfig (v1) เดิมจะได้รับการรองรับนานเท่าใด

FCM วางแผนที่จะรองรับเพย์โหลด v1 AndroidConfig ต่อไปอีกหลายปีหลังจากที่ AndroidConfigV2 เปิดตัวเวอร์ชันสำหรับผู้ใช้ทั่วไป (GA) แม้ว่าไทม์ไลน์การย้ายข้อมูลจะใช้เวลาหลายปี แต่ AndroidConfigV2 จะช่วยให้การส่งการแจ้งเตือนเป็นไปตามที่คาดการณ์ได้มากขึ้น และเราขอแนะนำให้คุณย้ายข้อมูลโดยเร็วที่สุด

AndroidConfigV2 รองรับระบบปฏิบัติการ Android เวอร์ชันใดบ้าง

AndroidConfigV2 จะรองรับใน Android ทุกเวอร์ชันที่ Google รองรับ ระบบจะรองรับอุปกรณ์ทั้งหมด ยกเว้นอุปกรณ์ที่มีอายุมากกว่า 10 ปี เมื่อเลิกใช้งาน API v1 เดิม

AndroidConfigV2 จะส่งเพย์โหลดไปยังอุปกรณ์ที่รองรับเฉพาะอินเทอร์เฟซ v1 เวอร์ชันเก่าหรือไม่ และฉันควรเปิดตัวการเปลี่ยนแปลงตามลำดับใด

ได้ เมื่อคุณส่งคำขอ AndroidConfigV2, FCM และ GMS Core จะแปลเพย์โหลดโดยอัตโนมัติสำหรับอุปกรณ์ที่ใช้ SDK ของไคลเอ็นต์เวอร์ชันเก่าหรือสำหรับแอปที่ยังไม่ได้ลบล้าง onNotificationReceived() หรือ onBackgroundSyncReceived() โดยจะส่งโดยใช้ onMessageReceived()

เหตุใด AndroidConfigV2 จึงกำหนดให้ต้องแสดงผลการแจ้งเตือนผ่าน FCM SDK แทนที่จะเรียกใช้ NotificationManager.notify() โดยตรง

โดยการส่งคืน NotificationResponse ไปยัง SDK FCM แบบโอเพนซอร์ส หรือใช้ FcmNotificationManager:

• แอปของคุณจะได้รับกรอบเวลาการดำเนินการที่ได้รับการปกป้องเพื่อถอดรหัสหรือปรับแต่งการแจ้งเตือน
• หากแอปหมดเวลา GMS Core จะช่วยให้มั่นใจได้ว่าการนำส่งจะทันเวลาโดยการโพสต์การแจ้งเตือนสำรองที่คุณกำหนดค่าไว้ใน remote_notification.notification

AndroidConfigV2 จัดการการแจ้งเตือนแตกต่างกันไหมเมื่อแอปอยู่เบื้องหน้าเทียบกับเบื้องหลัง

ไม่ AndroidConfigV2 จะไม่แยกการกำหนดเส้นทางข้อความตามสถานะของแอปว่าอยู่เบื้องหน้าหรือเบื้องหลัง ซึ่งต่างจากข้อความแจ้งเตือน v1 เดิม เมื่อคุณส่ง RemoteNotification การแจ้งเตือนจะแสดงโดยอัตโนมัติในทั้ง 2 สถานะ เว้นแต่คุณจะตั้งค่า mutable_content: true และปิดเสียงอย่างชัดเจนใน onNotificationReceived() โดยใช้ NotificationResponse.createEmpty()

แอปของฉันมีเวลาเท่าใดในการจัดการ RemoteNotification ที่เปลี่ยนแปลงได้

เมื่อตั้งค่า mutable_content: true ใน RemoteNotification แอปของคุณจะมีเวลาสูงสุด 20 วินาทีใน onNotificationReceived() เพื่อถอดรหัสเพย์โหลด ดึงข้อมูลชิ้นงานขนาดเล็ก (เช่น อวาตาร์) หรือติดต่อเซิร์ฟเวอร์แอปก่อนที่จะแสดงผล NotificationResponse หาก Callback ใช้เวลานานกว่า 20 วินาที ระบบจะยกเลิกการดำเนินการและ GMS Core จะโพสต์การแจ้งเตือนสำรองโดยอัตโนมัติตามเพย์โหลด remote_notification.notification

การบังคับใช้การระงับการแจ้งเตือนทำงานอย่างไรสำหรับ RemoteNotification ที่เปลี่ยนแปลงได้

แอปสามารถระงับ RemoteNotification ได้โดยแสดงผล NotificationResponse.suppress() จาก onNotificationReceived() เช่น เมื่อปิดเสียงแชท บล็อกผู้ส่ง หรือเพย์โหลดที่เข้ารหัสจากต้นทางถึงปลายทางไม่ผ่านการตรวจสอบความถูกต้อง

• ในเบื้องหลัง: แอปของคุณสามารถระงับข้อความ RemoteNotification ที่ได้รับได้สูงสุด 25% ในกรอบเวลาแบบต่อเนื่อง หากอัตราการระงับในเบื้องหลังของแอปเกิน 25% GMS Core จะแสดงผลและโพสต์การแจ้งเตือนสำรองจากเพย์โหลด remote_notification.notification โดยอัตโนมัติ
• ในเบื้องหน้า: คุณสามารถระงับการแจ้งเตือนระยะไกลทั้งหมดได้ขณะที่ทำงานอยู่ในเบื้องหน้า เช่น เพื่อแสดงข้อความโทสต์ในแอปหรืออัปเดตหน้าจอแชทที่เปิดอยู่แทนการโพสต์การแจ้งเตือนของระบบ

แอปของฉันสามารถโพสต์การแจ้งเตือนหลายรายการหรือยกเลิกการแจ้งเตือนที่มีอยู่จาก RemoteNotification รายการเดียวได้ไหม

ได้ ใช้ตัวเลือกต่อไปนี้เพื่อยกเลิกหรือโพสต์การแจ้งเตือนหลายรายการ

• ยกเลิกการแจ้งเตือนรายการเดียว: Return NotificationResponse.createCancel(tag, id) จาก onNotificationReceived() เพื่อปิดการแจ้งเตือนที่โพสต์ไว้ก่อนหน้านี้
• โพสต์การแจ้งเตือนหลายรายการหรือรวมการยกเลิกและโพสต์: เรียกใช้ getFcmNotificationManager(message) ภายใน onNotificationReceived() เพื่อเรียกใช้ postNow(tag, id, notification) และ cancelNow(tag, id) หลายครั้ง แล้วแสดงผล manager.finished() เมื่อเสร็จสมบูรณ์

RemoteViews ที่กำหนดเองจะทำงานร่วมกับ AndroidConfigV2 ได้ไหม

ใช่ RemoteViews ที่กำหนดเองจะทำงานร่วมกับ AndroidConfigV2 ได้ onNotificationReceived() แสดงผลออบเจ็กต์ Notification มาตรฐานของ Android โดย API การแจ้งเตือนมาตรฐานทั้งหมดของ Android เช่น setCustomContentView() ยังคงได้รับการรองรับ โปรดทราบว่า RemoteViews และ View อยู่ในโหมดการบำรุงรักษา และเราขอแนะนำให้ย้ายข้อมูลไปยัง Compose