Cloud Messaging

Click the Notifications tab to compose messages.

With the Notifications composer, you can send targeted messages to re-engage and retain your user base, foster app growth, and support marketing campaigns. To learn how to use the SDK in your app, refer to the Firebase Developer documentation.

In this article:

Compose a message

The Messages tab lists your completed and scheduled messages, and lets you compose a new message.

To compose a message:

  1. In the Notifications tab, select New notification.

  2. Enter the Message text, and optionally enter a Message title and Message label.

  3. Select the message target. The dialog displays options to refine the target based on whether you choose User Segment, or Topic.

    Selecting Topic displays a list of all topics with active subscriptions in this Firebase project (note that there may be a delay before a new topic is available in the console).  For more information, see the Firebase Developer documentation.
  4. Select the Scheduling options for your message. The default is "Now." Click inside the text box to display options to specify the future delivery time, including recurring notification options for ongoing campaigns.

  5. Optionally, select a Conversion event.

  6. Optionally, select Additional options. These include Custom data, Priority, and enabling Sound and iOS badge count for a notification alert.

    Custom data and some other options work only if the messaging logic included in your app is designed to receive them. Make sure to coordinate with the developers in your organization to use these fields to best effect.
  7. Select Save as a draft, or select Publish (depending on your selected Delivery date).

When the message is delivered, targeted client devices that have the app in the background receive the notification in the system notifications tray. When a user taps the notification, the app launcher opens your app.

If you’d like to re-send the same or a similar message, find the message in the list view, and select Duplicate from the action menu. You’ll be able to modify any of the message fields and schedule a new message delivery.

User segments

Selecting User Segments allows you to combine different options when sending notifications, letting you send a more tailored notifications to the appropriate group of users.

For each app in your project, you can combine the following options by selecting the "AND" operator:

Audience: An Audience from Analytics.

Version: A specific app version or versions with FCM SDK integrated that match a specified pattern. Note: there may be a delay before a new device app version shows up on the console.

Language: A device language. The language list is based on languages supported in your users’ devices. Note: there may be a delay before a new device language shows up on the console.

User Properties: User Properties from Analytics.

There can be only one language per message. When there are multiple apps selected for the target, the same language is applied to all apps.
You can select multiple user properties with the "AND" operator to further filter the users that receive the notification.

Conversion events

When composing a notification, it is important to think ahead and define which metric to use to assess its effectiveness. A Conversion event is an event or user action that you want to track to further measure and evaluate.

A built-in Notifications funnel analysis automatically reports Notification sent and Notification opened events. You can provide an optional conversion event that you want to analyze with the Notifications funnel analysis.

An Analytics User Property firebase_last_notification is automatically created when you send a notification from the Notifications console the first time. This identifies the most recent notification opened by the user, allowing proper notification attribution of the conversion events.

See Conversion Events to learn more conversion events and steps to take to enable conversion.

Prerequisite: Make sure your app has integrated the Firebase Cloud Messaging SDK, which enables automatic reporting of these notification-related events for the funnel analysis.

Notifications funnel analysis

You can evaluate how effective a notification is in re-engaging your users. A built-in Notifications funnel analysis shows you how your users respond to a particular message, with data for:

  • Notifications sent — The message has been enqueued for delivery or has been successfully passed to a third-party service like APNs for delivery
  • Notifications opened — The user selected or tapped on the notification
  • An optional Conversion event.

Message delivery events (available only on Android devices) are recorded when a message has been received and acknowledged by your user's device. "Notifications sent" statistics may be higher than delivery events due to inactive devices.

To see the Notifications funnel analysis:

  1. In the Notifications composer, select the Messages tab.

  2. Click on a completed or in progress message in the message list. An expanded view including a Funnel analysis is displayed.

Analytics reports update periodically, but there can be some delay between when a user opens the notification and when the event data is available in the console.

In addition to this built-in Funnel for Notifications under the Messages tab, you can also build custom Funnels in Analytics to visualize the completion rate of a sequence of steps in your app.

Was this article helpful?
How can we improve it?