Firebase Cloud Messaging(FCM)은 다양한 메시징 옵션과 기능을 제공합니다. 이 페이지의 정보는 다양한 유형의 FCM 메시지에 관한 이해를 돕고 이를 사용해 구현할 수 있는 기능을 소개하기 위한 내용입니다.
선택사항인 데이터 페이로드가 포함된 알림 메시지
프로그래매틱 방식으로 또는 Firebase 콘솔을 통해 커스텀 키-값 쌍의 선택적 페이로드를 포함하는 알림 메시지를 보낼 수 있습니다. 알림 작성기에서 고급 옵션의 커스텀 데이터 필드를 사용하세요.
알림과 데이터 페이로드가 모두 포함된 메시지를 수신한 경우의 앱 동작은 앱이 백그라운드 상태인지 아니면 포그라운드 상태인지에 따라 다릅니다. 특히 수신 당시에 앱이 활성 상태였는지 여부에 따라 다릅니다.
- 백그라운드 상태인 경우 알림 페이로드가 앱의 알림 목록에 수신되며 사용자가 알림을 탭한 경우에만 앱에서 데이터 페이로드를 처리합니다.
- 포그라운드 상태인 경우 앱에서 페이로드가 둘 다 제공되는 메시지 객체를 수신합니다.
다음은 notification 키와 data 키가 둘 다 포함된 JSON 형식 메시지입니다.
{
"message":{
"token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
"notification":{
"title":"Portugal vs. Denmark",
"body":"great match!"
},
"data" : {
"Nick" : "Mario",
"Room" : "PortugalVSDenmark"
}
}
}전송 옵션
FCM은 Android 기기로 전송되는 메시지에 특정 전송 옵션 모음을 제공하며 Apple 플랫폼과 웹에도 비슷한 옵션을 허용합니다. 예를 들어 '축소형' 메시지 동작은 Android에서는 FCM의 collapse_key, Apple에서는 apns-collapse-id, 자바스크립트 및 웹에서는 Topic을 통해 지원됩니다. 자세한 내용은
이 섹션의 설명 및 관련 참조 문서를 확인하세요.
메시지 우선순위 설정
다운스트림 메시지의 전송 우선순위(보통 및 높은 우선순위)를 할당할 수 있는 옵션 두 개가 있습니다. 이 동작은 플랫폼에 따라 조금씩 다르지만, 보통 및 높은 우선순위 메시지 전송이 작동하는 방식은 다음과 같습니다.
보통 우선순위: 보통 우선순위 메시지는 앱이 포그라운드 상태이면 즉시 전송됩니다. 백그라운드 앱의 경우 전송이 지연될 수 있습니다. 새로운 이메일 알림, UI 동기화 유지, 백그라운드 앱 데이터 동기화와 같이 시간이 크게 중요하지 않은 메시지의 경우 보통 전송 우선순위를 선택하세요.
높은 우선순위: FCM이 기기가 잠자기 모드인 경우에도 높은 우선순위 메시지를 즉시 전송하려고 시도합니다. 높은 우선순위 메시지는 사용자에게 표시되는 시간에 민감한 콘텐츠를 위한 것입니다.
다음은 잡지 구독자에게 새 콘텐츠를 다운로드할 수 있다고 알리기 위해 FCM HTTP v1 프로토콜을 통해 보내는 보통 우선순위 메시지의 예시입니다.
{
"message":{
"topic":"subscriber-updates",
"notification":{
"body" : "This week's edition is now available.",
"title" : "NewsMagazine.com",
},
"data" : {
"volume" : "3.21.15",
"contents" : "http://www.news-magazine.com/world-week/21659772"
},
"android":{
"priority":"normal"
},
"apns":{
"headers":{
"apns-priority":"5"
}
},
"webpush": {
"headers": {
"Urgency": "high"
}
}
}
}메시지 우선순위 설정에 관한 플랫폼별 세부정보는 다음을 참조하세요.
- APN 문서
- 메시지 우선순위 설정 및 관리(Android)
- 웹 푸시 메시지 긴급성
생명에 중요한 사용 사례
FCM API는 긴급 재난 문자 또는 API 사용 또는 실패가 사망, 상해 또는 환경적 피해(예: 원자력 시설, 항공 교통 통제 또는 생명 유지 시스템)를 야기할 수 있는 기타 고위험 활동을 위해 고안되지 않았습니다. 이러한 사용은 서비스 약관 섹션 4. a. 7에서 명시적으로 금지하고 있습니다. 앱의 약관 준수를 관리하고 미준수로 인해 발생하는 피해에 대한 책임은 전적으로 귀하에게 있습니다. Google은 API를 '있는 그대로' 제공하며, 귀하 또는 귀하의 사용자에 대한 책임이나 기타 의무 없이 언제든지 어떤 이유로든 API 또는 그 일부나 기능 또는 이에 대한 액세스를 중단할 권리를 보유합니다.
메시지 수명 설정
메시지를 보내면 보통 FCM에서 바로 전송됩니다. 하지만 바로 전송하는 것이 불가능한 경우도 있습니다. 예를 들어 플랫폼이 Android인 경우 기기가 꺼져 있거나 오프라인이거나 기타 사용 불가능한 상태일 수 있습니다. 또는 FCM에서 앱이 과도한 리소스를 소비하여 배터리 수명이 부정적인 영향을 받지 않도록 의도적으로 메시지를 지연할 수 있습니다.
이러한 상황이 발생하면 FCM에서 메시지를 저장한 후 전송할 수 있게 되면 바로 전송합니다. 대부분의 경우 문제가 없지만 일부 앱은 지연된 메시지가 전혀 전송되지 않습니다. 예를 들어 메시지가 수신 전화나 영상 채팅 알림인 경우 호출이 종료되기 이전의 짧은 시간 동안만 메시지가 의미 있습니다. 또는 메시지가 이벤트 초대인 경우 이벤트가 종료된 후에 수신되면 의미가 없습니다.
Android, 웹, 자바스크립트에서는 메시지의 최대 수명을 지정할 수 있습니다. 값의 길이가 0초에서 2,419,200초(28일) 사이여야 하며 FCM이 메시지를 저장하여 전송 시도하는 최대 기간에 해당합니다. 이 필드가 포함되지 않은 요청은 최대 기간인 4주가 기본값입니다.
다음은 이 기능을 사용할 수 있는 몇 가지 예입니다.
- 영상 채팅 수신 전화
- 만료일이 있는 초대 이벤트
- 캘린더 일정
메시지 수명을 지정할 경우의 또 다른 장점은 FCM에서 TTL(수명) 값이 0초인 메시지에 축소형 메시지 제한을 적용하지 않는다는 점입니다.
FCM은 '지금 즉시 전성되거나 절대 전송되어서는 안 되는' 메시지 처리에 최선을 다합니다. time_to_live 값이 0이면 즉시 전송할 수 없는 메시지는 삭제된다는 점에 유의하세요. 그러나 이러한 메시지는 저장되지 않으므로 알림 메시지를 보낼 때 지연 시간이 최소화됩니다.
다음은 TTL이 포함된 요청의 예시입니다.
{
"message":{
"token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
"data":{
"Nick" : "Mario",
"body" : "great match!",
"Room" : "PortugalVSDenmark"
},
"apns":{
"headers":{
"apns-expiration":"1604750400"
}
},
"android":{
"ttl":"4500s"
},
"webpush":{
"headers":{
"TTL":"4500"
}
}
}
}메시지의 수명
앱 서버가 FCM에 메시지를 게시한 후 메시지 ID를 다시 수신했다고 해서 메시지가 이미 기기로 전송되었다는 의미는 아닙니다. 더 정확히 말하면 전송이 수락되었다는 의미입니다. 메시지가 수락된 후 수행되는 작업은 여러 요인에 따라 달라집니다.
최적의 상황에서는 기기가 FCM에 연결된 경우 화면이 켜져 있고 아무런 제한사항이 없으면 메시지가 즉시 전송됩니다.
기기가 연결되어 있지만 잠자기 상태인 경우 FCM은 기기에서 잠자기 상태가 해제될 때까지 우선순위가 낮은 메시지를 저장합니다. 또한 이 시점에서 collapse_key 플래그가 역할을 수행합니다. 축소 키와 등록 토큰이 동일한 메시지가 이미 저장되어 전송 대기 중이라면 이전 메시지가 삭제되고 새 메시지로 대체됩니다. 즉, 이전 메시지가 새 메시지에 의해 축소됩니다. 하지만 축소 키가 설정되어 있지 않으면 나중에 전송할 수 있도록 새 메시지와 이전 메시지 모두 저장됩니다.
기기가 FCM에 연결되어 있지 않으면 연결이 설정될 때까지 축소 키 규칙을
반영하여 메시지가 저장됩니다. 연결이
설정되면 FCM이 대기 중인 모든 메시지를 기기로
전송합니다. 예를 들어 기기가 공장 재설정 상태로 초기화되는 등의 사유로 다시 연결되지 않으면 결국 메시지 제한 시간이 초과되어 FCM 스토리지에서 삭제됩니다. time_to_live 플래그가 설정되지 않은 한 기본 제한 시간은 4주입니다.
메시지 전송에 대한 자세한 정보
Android 또는 Apple 플랫폼에서의 메시지 전송에 대한 자세한 정보는 Apple 및 Android 기기에서 열린 전송 메시지 수와 Android 앱의 '노출수'(사용자에게 표시된 알림) 데이터가 기록된 FCM 보고 대시보드를 확인합니다.
직접 채널 메시징이 사용하도록 설정된 Android 기기에서는 기기가 FCM에 연결되지 않은 시간이 1개월을 초과하면 FCM은 여전히 메시지를 수신하지만 메시지를 즉시 삭제합니다. 데이터 메시지를 마지막으로 보낸 지 4주가 지나기 전에 기기가 연결되면 클라이언트가 onDeletedMessages() 콜백을 수신합니다. 그러면 보통 앱에서 앱 서버에 전체 동기화를 요청하는 방식으로 상황을 올바르게 처리할 수 있습니다.
마지막으로 FCM에서 기기로 메시지를 전송하려고 했지만 앱이 제거된 경우 FCM이 메시지를 즉시 삭제하고 등록 토큰을 무효화합니다. 이후 이 기기로 메시지를 보내려고 시도하면 NotRegistered 오류가 발생합니다.
사용자 인증 정보
구현한 FCM 기능에 따라 다음과 같은 Firebase 프로젝트의 사용자 인증 정보가 필요할 수도 있습니다.
| 프로젝트 ID | Firebase 프로젝트의 고유 식별자로서 FCM v1 HTTP 엔드포인트에 관한 요청에 사용됩니다. 이 값은 Firebase Console 설정 창에서 확인할 수 있습니다. |
| 등록 토큰 | 각 클라이언트 앱 인스턴스를 식별하는 고유한 토큰 문자열입니다. 단일 기기 및 기기 그룹 메시징에 등록 토큰이 필요합니다. 등록 토큰은 비밀로 유지되어야 한다는 점에 유의하세요. |
| 발신자 ID | Firebase 프로젝트를 만들 때 생성되는 고유한 숫자 값으로서 Firebase 콘솔 설정 창의 Cloud Messaging 탭에서 확인할 수 있습니다. 발신자 ID는 클라이언트 앱에 메시지를 보낼 수 있는 각 발신자를 식별하는 데 사용됩니다. |
| 액세스 토큰 | HTTP v1 API에 대한 요청을 승인하는 단기 OAuth 2.0 토큰입니다. 이 토큰이 Firebase 프로젝트에 속한 서비스 계정에 연결됩니다. 액세스 토큰을 만들고 순환하려면 보내기 요청 승인에 설명된 단계를 따르세요. |