FCMv1 전환 가이드

Article Summary

Share feedback

Thanks for sharing your feedback!

전환 배경

Firebase에서 GCM/FCM type의 API가 2024년 6월 20일부로 서비스가 종료됩니다.
기존의 GCM/FCM을 사용하여 Android 모바일 Push를 사용하시던 고객께서는 2024년 6월 19일 18시(KST) 이전까지 FCMv1 type의 API로 전환해야 합니다.
네이버 클라우드 플랫폼의 SENS 서비스에서는 2024년 3월 7일 20시부터 FCMv1 type 기능을 제공합니다.

전환하려는 프로젝트에 FCMv1 type의 Certificate를 등록합니다. (Firebase console 바로가기)
디바이스 토큰 등록 API에서 deviceType을 fcmv1으로 지정하여 토큰을 등록합니다.
- AS-IS: deviceType: GCM
- TO-BE: deviceType: FCMv1
메시지 발송 API에서 target.deviceType을 FCMv1으로 지정하여 메시지를 발송합니다.
- target.deviceType: FCMv1 인 경우, FCMv1 type으로 등록된 디바이스 토큰을 가진 User에게 메시지를 발송
- target.deviceType: GCM 인 경우, GCM type으로 등록된 디바이스 토큰을 가진 User에게 메시지를 발송
- target.deviceType: ALL 또는 지정하지 않는 경우, 모든 type의(APNS, GCM, FCMv1) 등록된 디바이스 토큰을 가진 User에게 메시지를 발송
- 단, 2024년 6월 20일 이후에는 GCM으로의 발송 기능은 중단됩니다.
메시지 발송 API에서 message.fcmv1을 사용할 수 있습니다.
- message.fcmv1 구성하여 요청하면, FCMv1 type으로 등록된 디바이스 토큰을 가진 User에게 보내는 메시지를 별도로 제어할 수 있습니다.
- message.fcmv1을 따로 구성하지 않았다면, message.gcm > message.default의 우선순위로 FCMv1 type으로 발송하는 메시지를 사용합니다.

네이버 클라우드 플랫폼의 SENS 서비스에서 FCMv1 type 관련 기능은 2024년 3월 7일 20시(KST) 이후 제공됩니다.
FCMv1 type 기능을 사용하기 위해서는 Certificate를 먼저 등록해야 합니다.
동일한 디바이스의 토큰이 GCM, FCMv1 모두 등록된 경우에는 target.deviceType: ALL 또는 지정하지 않고 메시지를 발송하는 경우, 중복 수신될 수 있습니다.
GCM -> FCMv1으로의 디바이스 토큰 마이그레이션은 별도로 지원하지 않으나, 디바이스 토큰 조회 API를 활용하여 기존 GCM으로 등록된 디바이스 토큰을 조회할 수 있습니다.
메시지 발송 시 message.fcmv1을 별도로 구성하지 않으면, message.gcm > message.default의 우선순위로 메시지를 사용하고 이 때 FCMv1에서 변경되는 부분에 따라 메시지 발송에 영향을 줄 수 있습니다. 반드시 3. FCMv1에서 변경되는 부분을 확인해 주십시오.

delay_while_idle 옵션이 삭제됩니다.
time_to_live 옵션명이 ttl로 변경됩니다.
payload의 data.KEY 지원 타입이 변경됩니다.
- string:string 형태만 지원합니다. Firebase 가이드를 참조해 주십시오.
- 메시지 발송 API에서 custom 필드 사용 시, 변경되는 형식에 맞춰 string:string만 사용할 수 있습니다.
  - ex. custom.KEY(string) : VALUE(string)

이 문서가 도움이 되었습니까?