Click the Notifications tab to compose notifications.

With the Notifications composer, you can send targeted notifications 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 notification

The Notifications tab lists your completed and scheduled notifications, and lets you compose a new notification.

To compose a notification:

  1. In the Notifications tab, select New notification.

  2. Enter the Notification text, and optionally enter a Notification titleNotification label, or Notification image.

  3. Select the notification target. The dialog displays options to refine the target based on whether you choose User Segment, or Topic. If you are targeting a web app, options for browser and OS are available. 

    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 notification. Depending on the Notification type you select, you'll have different options to specify immediate or future delivery time, including machine-predicted optimal times and recurring time options for ongoing campaigns.

    Recurring campaigns are notification campaigns that run automatically, whenever a user meets the targeting conditions. For instance, the scheduling options let you set up a weekly reminder to encourage new users to complete onboarding. In another example, you might want to offer bi-weekly discounts on in-app purchases to spenders to nudge them towards a purchase. Note that these are limited to 10 notifications per campaign
  5. Optionally, select a Conversion event.

  6. Optionally, select Additional options. These include Custom data, 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 notification 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 notification, find the notification in the list view, and select Duplicate from the action menu. You’ll be able to modify any of the notification fields and schedule a new notification 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 notification. 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 notification, with data for:

  • Notifications sent — The notification 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.

Notification delivery events (available only on Android devices) are recorded when a notification 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 Notifications tab.

  2. Click on a completed or in progress notification in the notification 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.
Was this helpful?
How can we improve it?
Clear search
Close search
Google apps
Main menu
Search Help Center