Firebase 콘솔에서 알림 작성기를 사용하여 알림 메시지를 보낼 수 있습니다. 이 방법은 Admin SDK 또는 v1 HTTP 프로토콜을 사용하여 메시지를 보내는 것보다 유연성이나 확장성은 떨어지지만 테스트 목적이나 더 정확하게 타겟팅된 마케팅 및 사용자 참여를 목적으로 할 때 매우 유용할 수 있습니다.
Firebase 콘솔은 애널리틱스 기반의 A/B 테스팅을 제공하여 마케팅 메시지를 수정하고 개선하는 데 도움이 됩니다.
앱에 메시지를 수신하는 로직을 개발한 후에는 기술 지식이 없는 사용자가 알림 작성기를 사용하여 메시지를 전송하도록 허용할 수 있습니다.
정보
알림 작성기에서 알림 메시지를 보낼 때 Google은 양식 필드에 입력한 값을 다음 방식으로 사용합니다.
사용자 세그먼트 및 만료와 같은 필드는 메시지 타겟과 전송 옵션을 지정합니다.
알림 텍스트 및 커스텀 데이터와 같은 필드는 키-값 쌍으로 구성된 페이로드에 포함되어 클라이언트에 전송됩니다.
이러한 필드는 Message 객체를 통해 사용 가능한 키에 매핑됩니다. 예를 들어 작성기의 커스텀 데이터 필드에 입력한 키-값 쌍은 알림의 data 페이로드로 처리됩니다. 다른 필드는 notification 객체나 플랫폼별 알림 구성의 키에 직접 매핑됩니다.
FCM API를 통해서는 알림 작성기의 일부 필드를 사용할 수 없습니다. 예를 들어 서버 API를 사용할 때는 불가능한 방법으로 앱 버전, 언어, 브라우저 유형과 버전 또는 사용자 속성을 기반으로 사용자 세그먼트를 타겟팅할 수 있습니다.
Firebase 콘솔에서 클라이언트로 전송하는 키는 다음과 같습니다.
키
콘솔 필드 라벨
설명
notification.title
알림 제목
알림 제목을 나타냅니다.
notification.body
알림 텍스트
알림 본문 텍스트를 나타냅니다.
data
커스텀 데이터
사용자가 정의하는 키-값 쌍입니다. 앱에서 처리할
데이터 페이로드로 전송됩니다.
메시지 전송을 지정하는 키의 예는 다음과 같습니다.
키
콘솔 필드 라벨
설명
sound
알림음
기기가 알림을 수신하면 재생할 알림음을 나타냅니다.
time_to_live
만료
이 매개변수는 기기가 오프라인 상태인 경우 FCM 스토리지에 메시지를 보관해야 하는 시간(초)을 지정합니다.
자세한 내용은 메시지 수명 설정을 참조하세요.
[null,null,["최종 업데이트: 2025-08-16(UTC)"],[],[],null,["You can send notification messages using\n[the Notifications composer](//console.firebase.google.com/project/_/notification) in the Firebase console. Though this does not\nprovide the same flexibility or scalability as sending messages with the\n[Admin SDK](/docs/cloud-messaging/admin) or the\n[v1 HTTP protocol](/docs/reference/fcm/rest), it can be\nvery useful for testing or for highly targeted marketing and user engagement.\nThe Firebase console provides analytics-based\n[A/B testing](/docs/ab-testing/abtest-with-console) to help refine and\nimprove marketing messages.\n\nAfter you have developed logic in your app to receive messages, you can allow\nnon-technical users to send messages with\n[the Notifications composer](//console.firebase.google.com/project/_/notification).\n\nAbout\n\nWhen you send a notification message from\n[the Notifications composer](//console.firebase.google.com/project/_/notification),\nGoogle uses the values you enter in the form fields in these ways:\n\n- Fields like **User segment** and **Expires** determine the message target and delivery options.\n- Fields like **Notification text** and **Custom data** are sent to the client in a payload comprised of key/value pairs.\n\nThese fields map to keys available through the\n[`Message`](/docs/reference/fcm/rest/v1/projects.messages#resource:-message)\nobject. For example, key/value pairs entered in the **Custom data**\nfield of the composer are handled as a\n[`data`](/docs/reference/fcm/rest/v1/projects.messages#Message.FIELDS.data)\npayload for the notification. Other fields map directly to keys in the\n[`notification`](/docs/reference/fcm/rest/v1/projects.messages#notification)\nobject or in the platform specific notification configuration.\n\nNote that some fields in\n[the Notifications composer](//console.firebase.google.com/project/_/notification) are *not* available through\nthe FCM API. For example, you can target user segments\nbased on app version, language, browser type and version, or user properties\nin ways that are not available using the server API.\n| **Caution:** In another important difference from programmatic messaging, the console lets you cancel any scheduled message that is not already in progress. **Once\n| a message fanout is actually in progress, it is fully committed and\n| cannot be canceled through the console nor by Firebase support.**\n\nThe keys that the Firebase console sends to clients are:\n\n| Key | Console field label | Description |\n|----------------------|---------------------|-----------------------------------------------------------------------------------------------|\n| `notification.title` | Notification title | Indicates notification title. |\n| `notification.body` | Notification text | Indicates notification body text. |\n| `data` | Custom data | Key/value pairs that you define. These are delivered as a data payload for the app to handle. |\n\nKeys that determine message delivery include:\n\n| Key | Console field label | Description |\n|----------------|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `sound` | Sound | Indicates a sound to play when the device receives a notification. |\n| `time_to_live` | Expires | This parameter specifies how long (in seconds) the message should be kept in FCM storage if the device is offline. For more information, see [Setting the lifespan of a message](/docs/cloud-messaging/concept-options#ttl). |"]]
