FCMv1 전환 가이드
- 인쇄
- PDF
FCMv1 전환 가이드
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
전환 배경
- 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
- AS-IS:
- 메시지 발송 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에서 변경되는 부분을 확인해 주십시오.
FAQ
1. GCM/FCM type 기능 종료 일정
- 2024년 6월 19일 18시(KST)에 기능이 종료됩니다.
- 해당 시간 이후에는 프로젝트에 등록된 GCM/FCM 인증서가 순차적으로 삭제됩니다.
2. FCMv1 type 기능 제공 일정
- 2024년 3월 7일 20시(KST)에 기능이 제공됩니다.
- 해당 시간 이후에는 상기 전환 가이드를 참고하시어 2024년 6월 19일 18시(KST) 이전까지 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)
4. FCMv1 type의 Private Key에 업로드할 JSON 파일은 어떻게 다운로드 하나요?
- Firebase 프로젝트 설정 > 클라우드 메시징 탭
- Firebase Cloud Messaging API(V1) 하위 서비스 계정 관리 클릭
- 프로젝트의 서비스 계정 생성 혹은 기존 계정에서 작업 > 키 관리 클릭
- 키 추가 > 새 키 만들기 (키 유형 JSON)
이 문서가 도움이 되었습니까?